Roku Developer Program

Join our online forum to talk to Roku developers and fellow channel creators. Ask questions, share tips with the community, and find helpful resources.
cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
EnTerr
Roku Guru

Docs on roInput / roInputEvents ?

Apparently roInput / roInputEvents (officially) exist - but i can't find them in http://sdkdocs.roku.com

Where them docs at?
0 Kudos
7 REPLIES 7
TheEndless
Channel Surfer

Re: Docs on roInput / roInputEvents ?

What, this isn't good enough for you? 😛
input enables a developer to send custom events to their Brightscript application. It takes a user defined list of name-value pairs sent as query string uri parameters. The external control server places these name-value pairs into a BrightScript associative array and passes them directly through to the currently executing channel script via a Message Port attached to a created roInput object. Please refer to Section 3.1 below for more detailed recommendations on how to pass your data. Messages of type roInputEvent have a GetInfo() method that will obtain the associative array. The arguments must be URL-encoded. This command is sent via a POST with no body.
My Channels: http://roku.permanence.com - Twitter: @TheEndlessDev
Instant Watch Browser (NetflixIWB), Aquarium Screensaver (AQUARIUM), Clever Clocks Screensaver (CLEVERCLOCKS), iTunes Podcasts (ITPC), My Channels (MYCHANNELS)
0 Kudos
EnTerr
Roku Guru

Re: Docs on roInput / roInputEvents ?

"TheEndless" wrote:
What, this isn't good enough for you? 😛

Of course not :roll:
Surprised i have to explain what documentation looks like but they should have own entries and be listed under http://sdkdocs.roku.com/display/sdkdoc/Components and http://sdkdocs.roku.com/display/sdkdoc/Events accordingly. And no matter how i meditate over the paragraph above, i still cannot divine what happens if there are >1 roInputs
0 Kudos
TheEndless
Channel Surfer

Re: Docs on roInput / roInputEvents ?

"EnTerr" wrote:
"TheEndless" wrote:
What, this isn't good enough for you? 😛

Of course not :roll:
Surprised i have to explain what documentation looks like but they should have own entries and be listed under http://sdkdocs.roku.com/display/sdkdoc/Components and http://sdkdocs.roku.com/display/sdkdoc/Events accordingly. And no matter how i meditate over the paragraph above, i still cannot divine what happens if there are >1 roInputs

See the tongue sticking out smiley after that question? Yeah, that was to denote sarcasm... :roll:
I'm pleased to inform you that you do not, in fact, need to explain what documentation looks like to me...
My Channels: http://roku.permanence.com - Twitter: @TheEndlessDev
Instant Watch Browser (NetflixIWB), Aquarium Screensaver (AQUARIUM), Clever Clocks Screensaver (CLEVERCLOCKS), iTunes Podcasts (ITPC), My Channels (MYCHANNELS)
0 Kudos
EnTerr
Roku Guru

Re: Docs on roInput / roInputEvents ?

"TheEndless" wrote:
See the tongue sticking out smiley after that question? Yeah, that was to denote sarcasm... :roll:
I'm pleased to inform you that you do not, in fact, need to explain what documentation looks like to me...

That got "lost in translation", i am afraid.

I saw sarcasm, yes - "the use of words that mean the opposite of what you really want to say especially in order to insult someone, to show irritation, or to be funny" - but not in the way you explained. The use of bold+red to highlight roInput/roInputEvent/GetInfo() in the quote seemed like shoving my face into the words and meant to say "see dummy, there is your explanation - did you bother to do a text search first?". I wondered - why would you be showing me that, knowing that i must have seen it on search?! Since you must have used roInput already but did not complain about lack of info - i reasoned - you must be happy with that as sole explanation and "this isn't good enough for you? :P" felt like mocking my inability to read between the lines and guess the behavior.

Communication is harder online: no visual/audio cues (we cannot see each other's facial expression nor intonation), convo is not "duplex" (there is no instant feedback loop) and is easy to misunderstand/be misunderstood. Irony and word play are particularly prone, especially if you don't know your reader personally. If to avoid ambiguity, one over-explains/over-express a joke though, it is not as funny. And so I had to cut on elaborate jokes online to avoid confusion. Not all is lost though - if you keep trying, i am sure i will eventually calibrate my ability to understand your jokes the way they were meant (i.e. i would know you better).
0 Kudos
TheEndless
Channel Surfer

Re: Docs on roInput / roInputEvents ?

"EnTerr" wrote:
"TheEndless" wrote:
See the tongue sticking out smiley after that question? Yeah, that was to denote sarcasm... :roll:
I'm pleased to inform you that you do not, in fact, need to explain what documentation looks like to me...

That got "lost in translation", i am afraid.

I saw sarcasm, yes - "the use of words that mean the opposite of what you really want to say especially in order to insult someone, to show irritation, or to be funny" - but not in the way you explained. The use of bold+red to highlight roInput/roInputEvent/GetInfo() in the quote seemed like shoving my face into the words and meant to say "see dummy, there is your explanation - did you bother to do a text search first?". I wondered - why would you be showing me that, knowing that i must have seen it on search?! Since you must have used roInput already but did not complain about lack of info - i reasoned - you must be happy with that as sole explanation and "this isn't good enough for you? :P" felt like mocking my inability to read between the lines and guess the behavior.

Communication is harder online: no visual/audio cues (we cannot see each other's facial expression nor intonation), convo is not "duplex" (there is no instant feedback loop) and is easy to misunderstand/be misunderstood. Irony and word play are particularly prone, especially if you don't know your reader personally. If to avoid ambiguity, one over-explains/over-express a joke though, it is not as funny. And so I had to cut on elaborate jokes online to avoid confusion. Not all is lost though - if you keep trying, i am sure i will eventually calibrate my ability to understand your jokes the way they were meant (i.e. i would know you better).

Wheeee!
No, I've never used roInput.. but my original post did take a stab at documenting it based on my deciphering of the paragraph I quoted, complementing the bolding, but I got lazy and gave up on that about half way through and just left the bolding.
I'd have sworn it was documented before, but scouring the old PDF docs didn't turn up anything...
My Channels: http://roku.permanence.com - Twitter: @TheEndlessDev
Instant Watch Browser (NetflixIWB), Aquarium Screensaver (AQUARIUM), Clever Clocks Screensaver (CLEVERCLOCKS), iTunes Podcasts (ITPC), My Channels (MYCHANNELS)
0 Kudos
RokuJoel
Binge Watcher

Re: Docs on roInput / roInputEvents ?

http://sdkdocs.roku.com/display/sdkdoc/External+Control+Guide#ExternalControlGuide-30ExternalControl...

- for passing data into a running app, similar to Launch commands but without relaunching.
0 Kudos
EnTerr
Roku Guru

Re: Docs on roInput / roInputEvents ?

"RokuJoel" wrote:
http://sdkdocs.roku.com/display/sdkdoc/External+Control+Guide#ExternalControlGuide-30ExternalControl...
- for passing data into a running app, similar to Launch commands but without relaunching.

That's where TheEndless quoted from, Joel - yes.
There are traces in the forum that you have used it in 2011, so i have no doubt it works.
But roInput / roInputEvents remained undocumented ever since.

PS. @TheEndless - yes, deduction alone leading to the right conclusion is rarer in real world than say in "Death Note". Also, i probably should not admit watching an adolescents' anime.
0 Kudos