keyboard

The keyboard object allows you to configure the input for a USB keyboard connected to the player.

keyboard IDL

interface keypress {
    attribute String type;
    attribute Number keyCode;
    attribute String key;
};

callback KeyboardEventCallback = void (keypress event);

interface Keyboard {
    Promise<bool> isAttached();
    Promise<void> setLayout(String layoutName);
    Promise<void> setNumLock(bool on_off);
    
    void addEventListener(String type, KeyboardEventCallback callback);
    void removeEventListener(String type, KeyboardEventCallback callback);
};

Object Creation

To create a keyboard object, first load the brightsign/keyboard module using the require() method. Then create an instance of the keyboard class.

var keyboardClass = require("@brightsign/keyboard");
var keyboard = new keyboardClass();

Keypress

This interface contains the following parameters:

type String: Type is always “keypress”
keyCode Number: The ASCII keycode as number
key String: The ASCII character for the keyboard event

Keyboard

This interface allows for detection and configuration of a USB keyboard.

isAttached()

Promise<bool> isAttached()

Returns true if a USB keyboard is connected to the player. This method counts a connected device as a keyboard if it reports having the following keys: "A", "Z", "0", "9", ".", and Enter.

setLayout()

Specifies the localized layout for the attached USB keyboard. This setting takes effect immediately and persists in the registry after a reboot. See this table for valid keymap parameters (players are set to "us" by default).

setNumLock()

Sets the numlock state for the attached USB keyboard if passed true. Reset the state if passed false.

Documentation