TouchTest Head's Up Display

Document created by DPM Admin Employee on Jul 18, 2017
Version 1Show Document
  • View in full screen mode

Heads Up Display (HUD) for iOS is a visual enhancement of TouchTest playback for iOS mobile and hybrid apps. HUD refers to mobile test playback and involves the display of semi-transparent dots and color-coded panels that display useful clip element detail about user actions on the device screen while playback occurs.

TIP: Because Android already has a built-in, HUD-like option, TouchTest HUD is implemented only for iOS.

Use the following steps to utilize Android's built-in, HUD-like display:

  1. Place the Android device or simulator into Developer mode using the "secret handshake." Refer to the TouchTest Android Tutorial, Prerequisites in the Configuring the Android Device section for secret handshake steps. For a general discussion of the secret handshake, see the blog article, How to Enable Developer Options on the Samsung Galaxy S4.
  2. On the mobile device or simulator, go to Settings, Developer options.
  3. Enable Show touches.
  4. Enable Pointer location.

Heads Up Display can be performed at either the target level to easily enable it for all clip elements, or, by using the new hudOn and hudOff actions, which now appear in the Clip Editor lower panel, Actions list, HUD can be inserted into the clip at any point to enable it in the display.

Setting Up Heads Up Display per Action in a Clip

Heads up display can be added to an existing test clip using the following steps.

  1. Open the test clip to use.
  2. Click the Messages/Actions tab in the Clip Editor lower panel.

  1. In the Actions list (far right), select the hudOn action

  1. Double click to insert it after the current selection in the workspace, or, drag and drop it into the desired location.

  1. Once the hudOn action has been added to the test clip, double click it to open it in the lower panel Action Editor. In the screenshot below, hudOn has been added as App Action9 in the test clip and the default color, Blue, is set.

The Inputs, Color drop-down also includes Blue, Red, Green, Orange, Purple, Magenta, Yellow, and Aqua.

Add additional hudOn app actions and select a new color in order to distinguish the display. You may do so using any logical grouping you desire, such as assigning a specific color for a given operation type such as pan, which in the case of Stockfish applies to chess moves.

Selecting green as the Input color results in the green display shown at the beginning of this topic.

To end heads up display at any point, use the hudOff action. Doing so will omit heads up display for all subsequent actions.

Setting Up Heads Up Display at the Target Level

Heads Up Display (HUD) can be easily enabled in a test by checking Enable HUD at the target level using the following steps.

Note: Target-level HUD uses only the color blue on playback.

  1. Open the test clip to use.
  2. Click the Messages/Actions tab in the Clip Editor lower panel.

  1. Click the target in the Included Targets list.
  2. In the target's Settings section, check Enable HUD.
  3. Click Save in the target after making this change.