Touch command

Performs a touch operation on the specified coordinate location. A long press can be performed by using the durationparameter. A touchdown press is released with a touch- up release.

Important: As a best practice, this command should only be used in extreme circumstances because it is not accurate or adaptable to application modifications. Alternatively, screen analysis functions are recommended for robust automated testing.

Parameters

Name	Type	Possible values	Description
Device ID^*	Device		The device for this command. By default, this is the device under test (DUT).
Coordinates^*	String		The touch event coordinates. Format can be one of the following: "x1,y1,x2,y2" "x1%,y1%,x2%,y2%" Coordinate value can be in pixels or in percentage of screen size (0-100). For percentage use the % sign. Example: "20%, 25%" Consider using the percentage value because it translates to the screen resolution.
Operation mode	String	Single \| Double \| Up \| Down \| Force	The touch operation to perform on the found label location.
Duration	Number		The duration, in seconds, for performing the operation.
Repeat	Number		The number of times to repeat the operation.
Comment	String		Adds a comment to the script.
On-fail Result^*	Condition	Ignore \| Break \| Continue \| Abort \| Catch	The behavior when the command fails.

^* Mandatory parameter