Roku Developer Program

[dcrandall]

I notice in the documentation:

http://sdkdocs.roku.com/display/sdkdoc/ ... inaChannel

The standard for deep linking parameters enforced by Roku to support ads or universal search is that channels use the following parameters:

...and then it mentions 'contentID' and 'mediaType'.

My question: must this be 'contentID' and 'mediaType', explicitly? For my purposes, this can work...there's plenty of room in those two things to squeeze what I need to in deep linking.

HOWEVER... say we wanted to use two other parameters, or we went with two other parameters thinking that it was ok to use whatever we want... will it work?

Also, is 'contentID' always a numeric? Can mediaType be any string?

[TheEndless]

You can use any parameters you want for your own channel. You only need to adhere to the "contentID" and "mediaType" recommendation if your channel content is going to be listed in the universal search, or if you're going to have ad banners on the Roku home screen. In the case of the home screen ads, you only need "contentID" and "mediaType" support there, if those ads are going to link directly to specific content in your channel.

[dcrandall]

Next question:

mediaType Optional parameter to give context to the type of contentID passed.
For example, these are sometimes used by Roku search to differentiate
between searches for single titles, series, actors, etc.

clip

event

channel

sport

league

movie

special

series

person

episode

game

channel

personseries

personmovie

personepisode

appScreen (application specific parameter indicating a specific screen to navigate to)

Say I want to use 'appScreen' because it's incredibly appropriate. Do I just do 'mediaType=myScreenToUse' or do I use 'appScreen=myScreenToUse' and relay another parameter?

[TheEndless]

You'd use mediaType=appScreen and contentID=myScreenToUse.

mediaType describes the type of media that contentID points to.

[sonnykr]

"TheEndless" wrote:
You'd use mediaType=appScreen and contentID=myScreenToUse.

mediaType describes the type of media that contentID points to.

What if I need to specify the contentID as well? contentId=myUniqueId&mediaType=appScreen and I want to deep link to say 'MyBestScreen'. Where do I specify that (MyBestScreen)?

[dcrandall]

"sonnykr" wrote:

"TheEndless" wrote:
You'd use mediaType=appScreen and contentID=myScreenToUse.

mediaType describes the type of media that contentID points to.

What if I need to specify the contentID as well? contentId=myUniqueId&mediaType=appScreen and I want to deep link to say 'MyBestScreen'. Where do I specify that (MyBestScreen)?

What I had to do was sort of augment it for my purposes. I have to assume roku couldn't care less about what your contentId actually is, as long as you read 'contentId' as something.

So in your case here, if I had to do it, I would go...

contentId=myUniqueId_MyBestScreen&mediaType=appScreen

Basically using a delimiter that my app, itself, would have to sort-out.

[sonnykr]

hmm, I was also thinking to do the same. Thank you, dcrandall!