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.
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 |
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.
This function is available in firmware 7.2 or later.
GetChar() as Integer
Returns the Unicode character value, if this event is for a keyboard key.
This function is available in firmware 7.2 or later.
GetKey() as Integer
Returns the ID of the remote button, if this event is for a remote button.
This function is available in firmware 7.2 or later.
IsPress() as Boolean
Returns true if this is a press event, else false if it is a release event.
This function is available in firmware 7.2 or later.
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.
This function is available in firmware 7.5 or later.