Skip to main content
Version: 8.1.3

input

The sos.input API groups together all input-related functionality, such as remote control key events. With this API, you can listen to key events from the remote control and handle them in your application.

Methods

onKeyUp()

The onKeyUp method sets up a listeners, which is called on every keystroke of the remote controller. For the specific logic of an application (games for example), binding the remote control inputs can be helpful. Only a subset of all remote control keys is supported on the specific device. Only numerical digits are guaranteed to be supported.

note

This feature must be tested by users on real devices.

onKeyUp(listener: (event: IKeyUpEvent) => void): void;

Params

NameTypeDescription
listener(event: IKeyUpEvent) => voidThe listener function that will be called on every key up event.

Return value

Resolves when the listener is successfully set up.

Possible errors

  • If listener is not valid function.
  • If listener is unregistered.

removeEventListener()

The removeEventListener() method removes all event listeners for a specific event (only keyup is supported).

removeEventListener(event: 'keyup', listener: (...args: any[]) => void): void;

Params

NameTypeDescription
event"keyup"The name of the event to remove the listener for. Currently, only keyup is supported.
listener(...args: any[]) => voidThe listener function to remove.

Return value

Resolves when the listener is successfully removed.

removeEventListeners()

The removeEventListeners() method removes all event listeners bind on sos.input object.

removeEventListeners(): void;

API Example

import { sos } from '@signageos/front-applet';

void sos.onReady(async () => {
sos.input.onKeyUp((keyUpEvent) => {
console.log(`Pressed: ${keyUpEvent.keyCode} (${keyUpEvent.keyName})`);
});
});