Touch Screen on StanbyME

For the StanbyME model, we provide the touch screen interface to control the device. Depending on how you want your app to handle touch screen inputs and touch events, you can specify the supportTouchMode property in the appinfo.json file as in the following:

Fully supporting touch screen inputs and touch events

If you want your app to support touch screen inputs and handle them as touch events, set the supportTouchMode property to full. Touch events are delivered to your app when the user touches the screen. You can implement various touch event handlers using the standard web API. For more information about touch events, refer to MDN Touch events.

Note that one of the following two touch events will trigger the Touch Remote interface, and which one to use is set by the user. Therefore, you do not handle these two events in your app.

  • Multi-touch: Touch 3 or more fingers anywhere
  • Edge Gesture: Drag from the right edge of the screen to the left

Handling touch screen inputs as key events

If you want your app to support the touch screen input but handle them as keyboard and mouse events, instead of touch events, set the supportTouchMode property to virtual. We call this setting the virtual touch mode.  When the user touches the screen, keyboard and mouse events are delivered to your app.

If you have already published your app on the content store, you can use this virtual touch mode to control the touch screen in the StanbyME model while maintaining the existing keyboard and mouse event handlers. Let's look at the detailed operation.

  • When the user touches the button shortly on the screen, a mouse click event occurs. For more information about the mouse click event, see MDN Click event.
  • A left keyboard event occurs when the user swipes the screen from left to right, and the screen is scrolled to the left. For more information about the keyboard event, see MDN KeyboardEvent.
  • The timeout of the long press is 0.2 seconds.

You can also set the threshold and event settings in detail for the virtual touch mode. For more information, see the virtualTouch property of the appinfo.json file.

Not allowing touch screen inputs

If you do not want your app to support touch screen inputs, set the supportTouchMode property to none which is the default value. No event will be delivered to your app if the user touches the screen. In this case, the user can control the app only with the 4-way arrow keys on the remote controller or Touch Remote.

Note

If the supportTouchMode property is set to none, a user touch on the screen will trigger the Touch Remote interface.

No Headings