roUniversalControlEvent

The roScreen object sends the roUniversalControlEvent with the following related methods. If an app constrains the events processed to just the roUniversalControlEvent, the app will work with any controller. The GetID(), GetChar(), GetKey(), and IsPress() methods can be used instead of parsing the GetInt() return value to more effectively distinguish between remote control and keyboard key presses, and the key press and release events.

Supported methods

GetInt() as Integer

Returns an integer representing pressed or released keys on the remote. This table can be accessed at runtime by calling bslCore.brs: bslUniversalControlEventCodes():

Button	When Pressed	When Released
Back	0	100
Up	2	102
Down	3	103
Left	4	104
Right	5	105
Select	6	106
Instant Replay	7	107
Rewind	8	108
Fast Forward	9	109
Info	10	110
Play	13	113

GetKey() as Integer

Returns the ID of the remote button that generated an event.

GetRemoteID() as String

Returns an identifier associated with the type and ID of the remote control that generated the event. For example, if multiple wireless remotes are paired, this may be used to distinguish the event sources. Some remote controls, such as IR remotes, can not be distinguished using this API.

GetID() as Integer

Returns the ID of the remote button or character value represented by the event. Values 0x20..0x10FFFF represent a Unicode character value. Other values represent a remote button ID. GetID() returns the same value for a release event as for the press event.

IsPress() as Boolean

Checks whether a press event has occurred. This method returns true if a press event has occurred; otherwise, it returns false.

GetChar() as Integer

Returns the Unicode character value generated by a keyboard key press event.