Publishing & Players
From ThirdPresence Wiki
Contents |
Publishing your video content on mobile web sites is a straightforward process. If you don't have a mobile web site yet and want to use the white-label hosted site provided by ThirdPresence, read the instructions here.
If you already have a mobile web site and want to integrate the videos to it, see the chapter here.
Publishing video on your own mobile site
After uploading a video file to ThirdPresence, the platform creates a unique URL for that file. See Uploading Content section for information on how to make video files available to ThirdPresence.
Retrieving URLs to mobile video files
To retrieve all the URLs created by ThirdPresence for the video files that you have uploaded, there are two feeds:
Media RSS feed is a richer format in sense of the flexibility and we recommend that you will use that.
Media RSS
You can access the Media RSS feed at
http://[yoursite].thirdpresence.com/dls/t/mrss.jsp?cat=-1
As an example, here is a partial output from the HTTP request:
<item>
<title>Big Buck Bunny</title>
<link>http://show.thirdpresence.com/dls/t/item.jsp?iid=19069</link>
<pubDate>10.08.2009 07:49</pubDate>
<category></category>
<thirdpresence:expiredate>10.08.2010 07:49</thirdpresence:expiredate>
<thirdpresence:releasedate>10.08.2009 07:49</thirdpresence:releasedate>
<thirdpresence:duration>9:56</thirdpresence:duration>
<media:group>
<media:thumbnail url="http://vod.cloud.thirdpresence.com/http/Show_BigBuckBunny_640x360.avi.jpg" width="240" height="135" />
<media:description type="plain">Big Buck Bunny | (c) copyright Blender Foundation | www.bigbuckbunny.org</media:description>
<media:content url="http://show.thirdpresence.com/dls/t/watch.jsp?iid=19069" expression="full" duration="596" isDefault="true"/>
<media:content url="http://show.thirdpresence.com/dls/t/watch.jsp?nid=Big Buck Bunny" expression="full" duration="596"/>
<media:content url="http://show.thirdpresence.com/dls/t/watch.jsp?rid=xxj220j33" expression="full" duration="596"/>
<media:content url="http://show.thirdpresence.com/dls/t/xsmall.jsp?iid=19069" duration="596" expression="full"/>
<media:content url="http://show.thirdpresence.com/dls/t/download.jsp?iid=19069" duration="596" expression="full"/>
</media:group>
<media:embed url="http://dir.thirdpresence.com/player.swf" width="230" height="195" >
<media:param name="type">application/x-shockwave-flash</media:param>
<media:param name="width">230</media:param>
<media:param name="height">195</media:param>
<media:param name="allowFullScreen">true</media:param>
<media:param name="quality">high</media:param>
<media:param name="flashVars">file=http://show.thirdpresence.com/dls/t/watch.jsp?iid=19069&f=fl&image=http://vod.cloud.thirdpresence.com/http/Show_BigBuckBunny_640x360.avi.jpg&autoplay=false</media:param>
</media:embed>
<media:status state="ACTIVE"/>
</item>
You can find the description of the feed elements here.
The complete Media RSS specification is available on Yahoo's web site [1].
Atom feed
http://[yoursite].thirdpresence.com/dls/t/directatom.jsp?cat=-1
For example, the show.thirdpresence.com is published on address
http://show.thirdpresence.com/dls/t/directatom.jsp?cat=-1
Here is a partial output from the HTTP request:
<feed>
<entry>
<link rel="alternate" href="http://show.thirdpresence.com/dls/t/watch.jsp?iid=7116"/>
<title>Big Buck Bunny</title>
<description>Big Buck Bunny</description>
<pubDate>10.08 07:49</pubDate>
<date>10.08 07:49</date>
</entry>
</feed>
Publishing mobile video files on your site
To publish the video file on your mobile web site, you just embed the URL in <link> tag to your mobile site's HTML code (in this case the link to video is http://show.thirdpresence.com/dls/t/watch.jsp?iid=7116). The title of the video file is "Big Buck Bunny", and the description is also "Big Buck Bunny". The pubDate is the date when the video was published on the white-label mobile site.
Note that you only need to provide the link. When user clicks the link, ThirdPresence automatically recognizes the device and provides optimized video (e.g. MP4 or 3GP) using the best available transport protocol (e.g. RTSP or progressive HTML) to deliver it. You don't have to worry of any details regarding the video delivery as ThirdPresence takes care of it.
On the show.thirdpresence.com mobile web site, the HTML document containing the video feed information is following:
<div id="videos">
<table>
<tr>
<td class="videothumbnail">
<img class="videothumbnailimage" width="89" height="50" src="http://dl1.streamzilla.jet-stream.nl/ubipart/BigBuckBunny_640x360.avi.jpg">
</td>
<td class="video">
10.08 07:49<br>
<a class="vidTitle" href="/dls/t/watch.jsp?cid=show&iid=7116">Big Buck Bunny</a>
<br>9:56
</td>
</tr>
</table>
</div>
Using ThirdPresence's white-label mobile site
As part of your mobile video service, ThirdPresence automatically creates and hosts a white-label mobile web site for your content.
The URL of your white-label mobile site is [yoursite].thirdpresence.com and the email you received containing the sign-up details includes the information about the destination URL.
When you upload new content to ThirdPresence, the content is automatically added to the white-label mobile site.
Using the white-label site as your destination site
If you wish to use the white-label mobile site as your mobile destination site, it should be customized to meet your needs.
Customizing the look & feel
The look & feel can be customized using pre-defined graphics templates. The templates can be edited using standard graphics software, such as Photoshop.
You can download the graphics templates from http://ads.thirdpresence.com/pilotpackage/PilotPackage.zip
Once you have finished the designs, please send them to support@thirdpresence.com.
Customizing the site structure
The site is organized into categories. There can be up to six different categories, each containing up to ten content items.
As an example, here is a screenshot of the ThirdPresence demo mobile web site.
The title of the page is "Show".
There are four different categories of content. The active (visible) category is highlighted with red.
The first content item in the active category is a video file called "Big Buck Bunny".
Directing traffic to the site
The most effective way to direct traffic to your mobile site is to detect when mobile phone browsers visit your desktop site and redirect them to the mobile site. This can be done very easily using e.g. simple javascript or php code.
DNS Masking
If you want to hide the content serving location ([yoursite].thirdpresence.com) and instead use your own URL (say, m.[yoursite].com), you can use DNS masking. Check this for more information about how to take DNS Masking into use.
This page was last modified on 2 March 2010, at 08:40.