Page Comparison

The usbhidemulator allows you to emulate USB HID devices. USB keyboards are currently the only supported device type.

BrightSign players with USB-C (except for LS3 and LS4) can use this object.

Code Block

language	js
title	usbhidemulator IDL

[                                                                                                                                                                                                                                
    constructor(String path, String type)                                                                            
] interface UsbHidEmulator {                                                                                               
    Promise<void> enable();                                                                                                
    Promise<void> disable();                                                                                               
    Promise<void> clear();                                                                                                 
    Promise<void> keyDown(int keycode);  
	Promise<void> keyPress(int keycode);                                                                                  
    Promise<void> keyUp(int keycode);                                                                                      
    Promise<LedState> getLedState();                                                                                       
    Promise<ModifierState> getModifierState();                                                                             
    Promise<void> setModifierState(ModifierState)                                                                          
};

interface LedState {
    [optional] attribute bool numLock;
    [optional] attribute bool capsLock;
    [optional] attribute bool scrollLock;
};

interface ModifierState {
    [optional] attribute bool leftCtrl;
    [optional] attribute bool leftShift;
    [optional] attribute bool leftAlt;
    [optional] attribute bool leftGui;
    [optional] attribute bool rightCtrl;
    [optional] attribute bool rightShift;
    [optional] attribute bool rightAlt;
    [optional] attribute bool rightGui;
};

Panel

borderColor	#3D3D3D
bgColor	#F4F4F4
titleColor	#3D3D3D
borderWidth	0
titleBGColor	#3D3D3D
borderStyle	solid

ON THIS PAGE

Table of Contents

indent	20px

Object Creation

To create a usbhidemulator object, first load the @brightsign/usbhidemulator module using the require() method.

Code Block

language	js

keyem = require('@brightsign/usbhidemulator')
kbd = new keyem()

UsbHideEmulator

Use this interface to configure a usbhidemulator interface. The usbhidemulator class also generates "ledupdate" events which can be listened for with AddEventListener().

enable()

To enable

Code Block

language	js

Promise<void> enable()

Enables the HID device:.

disable()

Code Block

language	js

Promise<void> enable()disable()

To disable Disables the HID device. This method is not currently supported:.

clear()

Code Block

language	js

Promise<void> disable()clear()

To clear Clears all active keystrokes and modifiers:.

keyDown()

Code Block

language	js

Promise<void> clear()keyDown(int keycode)

To send Sends a keydown event for the specified USB key code:.

keyPress()

Code Block

language	js

Promise<void> keyDownkeyPress(int keycode)

keyPress()

This is the same as keyDown() followed by keyUp():.

keyUp()

Code Block

language	js

Promise<void> keyPresskeyUp(int keycode)

keyUp()

To send Sends a keyup event for the specified USB key code:.

getLedState()

Code Block

language	js

Promise<void> keyUp(int keycode)

Promise<LedState> getLedState()

To return Returns an associative array with the current state of all LED states on the keyboard:.

getModifierState()

Code Block

language	js

Promise<LedState>Promise<ModifierState> getLedState()getModifierState()

To return Returns an associative array with the current state of all modifiers (such as, shift, alt, ctrl):.

setModifierState()

Code Block

language	js

Promise<ModifierState> getModifierState()setModifierState(ModifierState)

To set

Sets the current modifier state as specified by an associative array. Only modifiers that are listed will cause the state to change

: Code Block

language	js

Promise<ModifierState> setModifierState(ModifierState)

.

Keycode

This interface contains the USB key code.

[int] keycode

Note
USB HID keyboard codes are in section 10 of www.usb.org/sites/default/files/documents/hut1_12v2.pdf.

LedState

This interface sends an LED state change if number lock, capital lock, or scroll lock is pressed.

[bool] optional numLock
[bool] optional capsLock
[bool] optional scrollLock

ModifierState

Listed modifiers will cause the state to change.

[bool] optional leftCtrl
[bool] optional leftShift
[bool] optional leftAlt
[bool] optional leftGui
[bool] optional rightCtrl
[bool] optional rightShift
[bool] optional rightAlt
[bool] optional rightGui

Example

Code Block

language	js

keyem = require('@brightsign/usbhidemulator')
kbd = new keyem()
kbd.addEventListener("ledupdate", function f(e) { console.log(e);})
kbd.enable()

kbd.keyPress(4)

Versions Compared

Old Version 26

New Version 27

Key

Object Creation

UsbHideEmulator

enable()

Code Block
language js
Promise<void> enable()
Enables the HID device:.

disable()

clear()

keyDown()

keyPress()

keyPress()

keyUp()

keyUp()

getLedState()

getModifierState()

setModifierState()

Keycode

LedState

ModifierState

Example

Page Comparison

Versions Compared

Old Version 26

New Version 27

Key

Object Creation

UsbHideEmulator

enable()

Code BlocklanguagejsPromise<void> enable()Enables the HID device:.

disable()

clear()

keyDown()

keyPress()

keyPress()

keyUp()

keyUp()

getLedState()

getModifierState()

setModifierState()

Keycode

LedState

ModifierState

Example

Code Block
language js
Promise<void> enable()
Enables the HID device:.