Mobile Access URLs

R2.0 Automatic Selector Syntax

What's New?

R2.0 of yospaceCDS introduced a new access URL syntax designed unify the Access and Choice (now deprecated) syntaxes. The consolidation of these two mechanisms has provided the opportunity to offer a syntax offering more versatility for a wider range of mobile access scenarios.

In summary, the Access Selector will either display a page to the user providing the available options to view their content (provided that sufficient options are available) or it will redirect to a Direct Access URL to playback the content. If you do not require such a versatile URL because you already know exact the delivery style that you need, you can use the Direct Access URL syntax and avoid an additional HTTP redirect.

Syntax

http://cds1.yospace.com/access/selector/u/0/1/{mid}?f={fid}[&options...]

Where:

• {mid} is the content ID of the video.
• {fid} is the ID of the Output Feed to which the access should be attributed. 

The additional following options can be specified as query string parameters:

Query Parameter	Short Description	Description	Default
s	Stylesheet	The stylesheet to use when presenting options to the user. Typically selector-mobile. Use nop for the raw XML.	selector-mobile
l	Language	The language to use for text localisation in the output. If the stylesheet has no localisation text for the given language the default is used	en-US
d	Delivery	so = stream only, do = download only, sd = stream and download options, fb = stream, fallback to download	sd
q	Quality Levels	Specify in a comma-separated list of values, the quality levels to offer to the user.  The full set of options are (as kbps) 50, 100, 200, 400, 600, and 800.	(not set)
a	Use Audio	Offers the content as audio only.	false
nr	Never Redirect	If true, the Selector Server never redirects the user to the content. Can be used e.g. when a selector page contains text that the user should always be presented with. This may result in a options list with only one item in it being presented (e.g. for iPhones)	false
mo	Show More Options	If set to true the user will be presented with a list as per the given quals parameter but, if there are actually more options that are valid for the client, a More Options... link will be generated. This link is actually a callback to the Selector Server which doesn't include any quals parameter	false
sth	Show Thumbnail	Whether or not to show a thumbnail image on the options page. This image will be part of a clickable video tag for iOS-based devices and a link to the first option in the subsequent options list for other devices	false
sti, sde, sdu, ses, sno, spo	Display Options	All specifiers for whether to display certain aspects of the selector page. These are Show Video Title (sti), Show RSS description field (sde), Show Video Duration (sdu), Show Download Size Estimates (ses), Show Operator Data Warning (sno), Show powered by (spo).	false
pa	preselect adverts	If using third-party Ad Server integration, this option allows you to preselect the advert before the stream is selected by the user.  This has the advantage that the selector page will have accurate duration and data usage estimates, but will have made a hit to the ad server regardless of whether the user plays the video.  The default setting, false, only hits the ad server once the user has asked for playback.	false

Example

http://cds1.yospace.com/access/selector/u/0/1/2650951?f=41084703011&
      d=sd&q=100,200&mo=true&nr=true&sth=true&sti=true&sde=true&
      sdu=true&ses=true&sno=true&spo=true

To view this link, you can click here.

Direct Access URL Syntax

Use this URL scheme to access videos using a specific method (download or stream) and quality.  Please note, that these preferences are ignored for iOS devices (iPhone, iPad, iPod Touch) as the "Apple Access Mode" settings defined in the feed override these.

Content ingested via an Input Feed set-up in the Content Management Console is given a unique identifier known as a Media Item ID. You must use this ID to reference the video in the Access URL.

There are two basic forms:

For HTTP downloads or streaming on iOS (Apple) compatible devices :

http://cds1.yospace.com/access/{d|a}/quality/u/0/1/{mid}[?f={fid}]

For RTSP streaming to non-iOS (Apple) devices such as Android:

rtsp://s.cds1.yospace.com/access/{s|r}/quality/u/0/1/{mid}[?f={fid}]

Where:

• {d|s|a|r} is one of d, s, a or r to determine the delivery style.
  • d is for HTTP download (which can include progressive download if the device supports it) 
  • s is for RTSP/RTP streaming of video
  • a is for HTTP download of audio only.
  • r is for RTSP/RTP streaming of audio only (radio).
  • Note that you must specify the protocol to be HTTP for modes d and a, and RTSP for modes s and r.
• {quality} should be replaced with the desired quality. yospaceCDS supports 50, 100, 200, 400, 600, and 800 quality thresholds (the numbers refer to the total bandwidth in kbps for the combined audio and video file). If you specify a quality not in this list, yospaceCDS will snap to the closest lower quality (for example, 350 will snap to 200, not 400).
• {mid} is the content ID of the video.
• {fid} is the ID of the Output Feed to which the access should be attributed.  

Examples

The following example will download a medium quality (200kbps) video without DRM.

http://cds1.yospace.com/access/d/200/u/0/1/17281236482?f=14244563

And now, the same example, but using RTSP streaming:

rtsp://s.cds1.yospace.com/access/s/200/u/0/1/17281236482?f=14244563