« Using Javascript with Joost Widgets | Main | Testing whether your user can view a video or channel »

Playing videos and opening links in Joost widgets

Links are important in Joost. Every video and channel in Joost has a "Joost Link" - a URL and associated web page. Joost Links allow people to link directly to Joost videos on the Web - and you can use Joost Links in widgets to play videos in Joost.

The general form of a Joost Link is:

http://joost.com/<publicID>#param1=value1,param2=value2

The publicID must contain exactly 7 characters, from the set a-z 0-9.

There is no way to distinguish Joost Links for channels and videos except by de-referencing them.

There are also some more complex Joost Links. For example:

http://joost.com/0440001#program=044000u

describes the channel Aardman Animations, starting with the video "Creature Comforts - The Sea";

http://joost.com/0440001#program=0440007,start=20000 

Describes the show "Town Called Panic: Cow Hulk" in channel "Aardman Animations", starting 20 seconds in.

Within a Joost Widget you can play one of these links like this:

<a onclick=\'navigate("http://joost.com/0440001#program=044000u")\'>Play video inside channel</a>

To open a web page that is not a Joost Link, just use navigate in the following way:

<a href='#' onclick='navigate(\"http://dev.joost.com\")'>Joost Developer Site</a>

You can see some example code here and the API definition is here.

Next time we'll see how to test these Joost Links to make sure they can be played by the viewer.

Posted by Libby Miller on Jan 12, 08 |