Skip to main content

Handling Remote Control

Hosanna normalizes platform input before it reaches a focused view:

Platform key, pointer, drag, and scroll events normalized into canonical Hosanna input before focus-first or geometry-first routingPlatform key, pointer, drag, and scroll events normalized into canonical Hosanna input before focus-first or geometry-first routing

TV remotes, browser keyboard input, pointer clicks, touch gestures, and debug input can therefore share the same focus and action paths.

Key input​

Common keys are represented by Key, including Up, Down, Left, Right, Ok, Back, Options, Play, FastForward, Rewind, and Replay.

Override or attach onInputEvent when a view needs behavior beyond its control's defaults:

import { Key } from '@hs-src/hosanna-bridge-core/api';
import {
  HsInputEvent,
  KeyState,
} from '@hs-src/hosanna-ui/lib/input/input-api';

Button({ text: 'Close' })
  .onInputEvent((event: HsInputEvent) => {
    if (event.key === Key.Back && event.keyState === KeyState.Press) {
      this.closePanel();
      event.preventDefault = true;
      event.consumed = true;
    }
  });

Set preventDefault when the normal control/focus handling should stop, and consumed when parent handlers should treat the event as handled.

Directional events can invoke findNextFocusable() and explicit nextFocusMap rules. Keep ordinary OK and directional behavior in built-in controls whenever possible so pointer and remote activation remain aligned.

Web adapter profiles​

Use ?adapters= to restrict which web adapters are registered:

?adapters=keyboard,mouse,touch
?adapters=roku,touch
?adapters=webkeyboard

Supported names are:

  • keyboard: browser keys mapped to Roku-style remote input;
  • webkeyboard: browser keyboard events for text-input paths;
  • debug: debugger hover/highlight input;
  • mouse: pointer hover, click, and wheel input;
  • touch: touch pointer input; and
  • roku: the web Roku-emulation profile.

With no explicit adapters filter, Roku emulation and its keyboard mapping are enabled by default. When touch is selected without mouse, touch handling also accepts mouse pointer events for local testing.

Web remote overlay​

The optional on-screen remote uses a separate launch flag:

?showRemoteOverlay=true
?showRemoteOverlay=1
?showRemoteOverlay=mini
?showRemoteOverlay=tiny

The removed ?touch=true alias does not enable the overlay. Select the touch input adapter separately when the application canvas should accept touch:

?expression=phone&adapters=touch,keyboard&showRemoteOverlay=mini

The overlay sends normalized d-pad, OK, and Back events. Its directional buttons also support held-key input.

Pointer coordinates​

Web mouse and touch adapters translate browser coordinates and wheel deltas into Hosanna design coordinates before hit testing. Do not apply browser DPI or CSS scale to sceneX, sceneY, or scroll deltas again.

Talk to us