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

<name Identifier> switches loudspeaker on

Parameter

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

Example

And A switches loudspeaker on

Switching the Loudspeaker Off

Syntax

<name Identifier> switches loudspeaker off

Parameter

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

Example

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

<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

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

This Step is eligible for:

• Timed

• Deferred

Enabling/Disabling Airplane Mode

Enabling Airplane Mode

Syntax

<name Identifier> enables airplane mode

Parameter

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

Example

And A enables airplane mode

Disabling Airplane Mode

Syntax

<name Identifier> disables airplane mode

Parameter

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

Example

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

<name Identifier> mutes its microphone

Parameter

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

Example

And A mutes its microphone

This Step is eligible for:

• Timed

The microphone can be unmuted with the following Step:

Syntax

<name Identifier> unmutes its microphone

Parameter

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

Example

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

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

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

This Step is eligible for:

• Timed