Skip to content
QiTASC.com /
General Phone Settings Steps
/
General Phone Settings Steps





General Phone Setting Steps

These Steps execute actions performed on the phone itself as opposed to Steps that involve call flows (such as dialing, sending an SMS or downloading data).

Switching the Loudspeaker On/Off

The loudspeaker must be switched on before beginning a recording in test cases that capture audio recordings. Loudspeakers can only be activated while a call is connected, connecting or ringing.

Switching the Loudspeaker On

Syntax

1
<name Identifier> switches loudspeaker on

Parameter

  • name - The name assigned to the phone switching the loudspeaker on

Example

1
And A switches loudspeaker on

Switching the Loudspeaker Off

Syntax

1
<name Identifier> switches loudspeaker off

Parameter

  • name - The name assigned to the phone switching the loudspeaker off

Example

1
And A switches loudspeaker off

These Steps are eligible for:

  • Timed

Setting the Preferred Network Type

There are a few options concerning the network type:

Syntax

1
<name Identifier> sets its preferred network type to <networkType String>

Parameters

  • name - The name assigned to the phone setting the preferred network type

  • networkType - May be one of "2G", "2G ONLY", "3G", "3G ONLY", "4G" or "4G ONLY"

    • When a network type declaration includes ONLY, the Step will fail if the phone is unsuccessful at registering with the specified network type

Example

1
And B sets its preferred network type to "4G"

This Step is eligible for:

  • Timed

  • Deferred

Enabling/Disabling Airplane Mode

Enabling Airplane Mode

Syntax

1
<name Identifier> enables airplane mode

Parameter

  • name - The name assigned to the phone enabling airplane mode

Example

1
And A enables airplane mode

Disabling Airplane Mode

Syntax

1
<name Identifier> disables airplane mode

Parameter

  • name - The name assigned to the phone disabling airplane mode

Example

1
And A disables airplane mode

These Steps are eligible for:

  • Timed

  • Deferred

Muting and Unmuting the Microphone

This Step mutes and unmutes the microphone. It can only be executed if the phone is connected in a call, but not in advance of a phone call. If the mutes Step is executed in a call, the microphone will automatically be unmuted for the next call.

Note: The muting/unmuting Steps only work with Android phones.

Syntax

1
<name Identifier> mutes its microphone
Parameter

  • name - The name assigned to the phone muting its microphone

Example

1
And A mutes its microphone

This Step is eligible for:

  • Timed

The microphone can be unmuted with the following Step:

Syntax

1
<name Identifier> unmutes its microphone

Parameter

  • name - The name assigned to the phone unmuting its microphone

Example

1
And A unmutes its microphone

This Step is eligible for:

  • Timed

Rebooting Phone and Waiting for it to Become Available

Two reboot Steps are available for locally connected phones: The first reboots the phone and the second waits for the reboot to the complete.

While the reboot is in process, Steps involving other devices can still be executed. However, accessing phone properties or calling any Steps that require interaction with the rebooting phone will not work between the two reboot Steps: They will only work after the reboot completes Step successfully finishes.

Syntax

1
2
3
Then <phone Name> reboots
...
Then within <timeout Number> seconds, <phone Name>'s reboot completes

Parameters

  • name - The name assigned to the phone being rebooted

  • timeout - The number of seconds the phone waits for

Example

1
2
3
4
Given an Android phone as A
Then A reboots
...
Then within 60 seconds, A's reboot completes

This Step is eligible for:

  • Timed