Forum Discussion

EnTerr's avatar
EnTerr
Roku Guru
10 years ago

What's a PlayOnly?

There is a "playonly_aware" attribute that can be manifested:
"http://sdkdocs.roku.com/display/sdkdoc/Manifest+File" wrote:
playonly_aware (Integer) = Set to 1 to specify the application responds to the Play Only remote control button event. If not set, the application will receive the Play event instead when the user selects the button

What is Play Only button and where can i encounter it?
Roku Developer Program

8 Replies

  • RokuMarkn's avatar
    RokuMarkn
    Visitor
    10 years ago
    PlayOnly refers to the Play button on a remote which has separate buttons for Play and Pause. I don't believe that any Roku products have such a remote, but the situation can arise when using a TV's native remote with the MHL stick.

    --Mark
  • EnTerr's avatar
    EnTerr
    Roku Guru
    10 years ago
    Aha!
    So if playonly_aware is manifested, then the app on use of standalone "Play" button via CEC will receive roUniversalControlEvent with code^ different than 13 (the usual Play/Pause) ? And maybe the same is for the standalone Stop button?

    (^) shot in the dark: maybe these codes are 11 and 12
  • RokuMarkn's avatar
    RokuMarkn
    Visitor
    10 years ago
    The PlayOnly code is 22. If playonly_aware is not set, this is remapped to 13.

    --Mark
  • EnTerr's avatar
    EnTerr
    Roku Guru
    10 years ago
    "Komag" wrote:
    11 is Backspace, dunno about 12

    What is "Backspace"?
    Remote's "Back" button is 0.
  • Komag's avatar
    Komag
    Roku Guru
    10 years ago
    used for virtual keyboard entry, like backspace key on keyboard (I assume). I can't remember where I found that out - I only ever used it as a meaningless entry to stave off the screensaver!
  • EnTerr's avatar
    EnTerr
    Roku Guru
    10 years ago
    "Komag" wrote:
    used for virtual keyboard entry, like backspace key on keyboard (I assume). I can't remember where I found that out - I only ever used it as a meaningless entry to stave off the screensaver!

    Oh, you meant ECP? Genius! Here, i collected some codes:
    /keypress/Backspace     = 11
    /keypress/Search        = 12
    /keypress/Play          = 13 'also PlayOnly by default
    /keypress/Enter         = 15
    /keypress/PlayOnly      = 22 'when `playonly_aware` manifested
    /keypress/Stop          = 23
    /keypress/VolumeUp      = 24
    /keypress/VolumeDown    = 25
    /keypress/VolumeMute    = 1114113   '0x110001
    /keypress/ChannelUp     = 1114134
    /keypress/ChannelDown   = 1114135
    /keypress/Sleep         = 1114138
    /keypress/Game          = 1114139


    Btw RokuMarkn - while exercising above, seems somehow i wedged the player into a bizarre state, in which the Home button won't work (by physical remote or ECP), while all the other remotes did work. Ultimately i had to power-cycle it.
  • RokuKC's avatar
    RokuKC
    Roku Employee
    10 years ago
    Just a note... PlayOnly is "documented" in bslCore.brs:

    BUTTON_PLAY_ONLY_PRESSED : 22

    Some of the other buttons are not intended for app use, and aren't documented there.