Touch input

This dialog is displayed when you add a touch input test step within the media access tab (via the context menu on an image or a mask) to your test case.

../../../_images/Toucheingabe_Dialog_Choice.png

This dialog is divided into two sections:

References

Here you can change the mapping item or create a new one.

Actions

In this section, a concrete touch input action can be selected from the drop-down menu. This action can be specified with several parameters by value and unit. If the coordinates of the action should be determined automatically by ecu.test agent, the “Prompt” option can be selected in the second drop-down menu and a corresponding instruction, e.g. “Click the Home button”, can be entered in the text field below. In this case, the agent will determine the coordinates of the action at runtime.

A preview image for the current action and its chosen parameters is displayed on the right hand side of the dialog. Parameters can be set as an expression in the respective text field directly. Alternatively, they can be changed interactively with drag-and-drop on the bullets in the preview image. The parameters in the text field are then updated to match the preview image. For the “Prompt” option, no interaction with the preview image is possible, since the coordinates are determined at runtime.

For direct gesture capture on a live preview, see Interactive Input Recorder.

For all actions it is possible to parameterize the positions of one or more fingers on the screen. Additionally, it is necessary to define further, more specific parameters. The following table briefly summarizes all available actions including the action-specific parameters.

Action type

Description

action specific parameters

Tap

Short tapping on a position on a screen position

(none, position only)

Hold

Tapping on and successive holding of a screen position

  • Duration Duration of finger holding the position

Multi-Tap

Multiple taps on a screen position

  • Number Number of successive taps

  • Intervall Time interval between successive taps

Swipe

Dragging of a finger from some start to some target position

  • Duration Duration of the finger movement

Hold and Swipe

Same as swipe action with previous holding at start position

  • Duration Hold Hold duration before swipe

  • Duration Swipe Duration of finger movement

Multi-Swipe

Dragging of multiple fingers in a parallel movement

  • Duration Duration of the finger movement

  • Number Number of fingers involved

  • Distance Distance between fingers

Pinch

Simultaneous pinch or spread movement by two fingers on the screen

  • Duration Duration of pinching finger movement

  • Scaling factor Relative change in finger distance, magnification >1, demagnification <1

Rotate

Two finger rotation with constant distance and center

  • Duration Duration of rotating finger movement

  • Angle Rotation angle in math. positiv orientation

Supported tools

If a tool connection supports touch input, possible touch input actions are listed in the respective help section for the tool connection.

The touch input test step is supported by the following tools:

Moreover, unsupported touch input actions are indicated as such in the dialog. A selection of one of these triggers a warning.