GUID-mapping Access Proxy

The standard Access URL syntax provides a method of building a URL that will allow any mobile device to access a video title. The GUID-mapping Access Proxy provides a convenient way of accessing videos within yospaceCDS referencing them using the original GUID supplied in their original RSS or FTP feeds, rather than the yospaceCDS ID.

Before reading this document it is important you are familiar with the Access URL Syntax.

Important: your account must be enabled to use this facility. Please contact support to enable your account.

Referrer Checking

The GUID-mapping Access Proxy must be provided the HTTP header "referer" in order for it to function. This header will be provided automatically by browsers executing a link embedded on to a page, but will not be present if you simply type a URL directly into its location bar.

Referrer checking makes it difficult for other sites to embed your video into their own pages without your permission. By default, your account will be enabled to allow all referrers (but the HTTP header must be present). You can request from support that this be tightened.

Direct Access Syntax

The GUID-mapping Access Proxy uses the following syntax which permits you to select the access method and quality (NB. for Apple devices, the quality and delivery mechanism is chosen automatically):

http://cds1.yospace.com/rss/access/[{i}/]{g}/{e|r}/{c}/{d|s|a}/{q}/u/{0|1}/1[?f={fi}]

Where:

  • {i} (optional) allows you to limit the scope of the GUID search to a specific input feed ID. This parameter is optional. If you do not specify it, the GUID search will be scoped to all feeds within the account. Use this parameter if you are ingested multiple feeds that may have overlapping GUID name spaces.
  • {g} is the GUID you wish to search on.
  • {e|r} is one of e or r. This defines how the GUID-mapping Access Proxy shall respond with the result.
    • Selecting mode e (embedded mode) returns a single line response which is the correct Access URL. This is designed for use in applications that want to interpret the result before acting on it, for example, a JavaScript function that calls the GUID-mapping proxy and embeds the link within an HTML5 video tag for iPad, for example.
    • Selecting mode r (redirect mode) will generate a redirect to the correct URL. This is the equivalent of issuing a standard Access URL.
  • {c} is your account's numeric ID, ask support for this if you do not have it
  • {d|s|a} is one of d, s or a 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 (see note below on Streaming URLs). a is for audio only. This mode will strip out the video track and provide the audio track as an MP3 download (this style of URL is embedded in Audio Podcast feeds, for example).  For iPhone and iPad devices, the delivery style is selected automatically (unless you specify the audio-only mode).
  • {q} 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).
  • {0|1} selects the DRM mode.  Use 0 for non-DRM protected, and 1 for DRM protected.
  • {fi} is the ID of the Output Feed to which the access should be attributed and from which it will get its delivery configuration from.  It is optional, but is helpful for reporting. 

Examples:

http://cds1.yospace.com/rss/access/482018/myvideo192/r/petshow01/d/100/u/0/1?f=2827192

Access the video "myvideo192" in the account petshow01 ingested via input feed ID 482018 via download at 100kbps. Please note, iPhone delivery (eg. quality and mechanism) will be subject to the iPhone delivery preferences associated with feed 2827192.

http://cds1.yospace.com/rss/access/myvideo192/e/petshow01/d/100/u/0/1

Return the access URL of the video "myvideo192" for customer "petshow01", download at 100kbps. Because feed ID is not specified, the default iPhone delivery behaviour will be used which is to be pursuant to Apple's current media delivery guidelines.

 

Choice Mode Syntax

The GUID-mapping Access Proxy uses the following syntax to allow the user choose the delivery mechanism and quality. (NB. for Apple devices, the quality and delivery mechanism is chosen automatically, and therefore the Choice page is skipped):

http://cds1.yospace.com/rss/access/[{i}/]{g}/{e|r}/{c}/choice/u/{0|1}/1[?f={fi}]

Where:

  • {i} (optional) allows you to limit the scope of the GUID search to a specific input feed ID. This parameter is optional. If you do not specify it, the GUID search will be scoped to all feeds within the account. Use this parameter if you are ingested multiple feeds that may have overlapping GUID name spaces.
  • {g} is the GUID you wish to search on.
  • {e|r} is one of e or r. This defines how the GUID-mapping Access Proxy shall respond with the result.
    • Selecting mode e (embedded mode) returns a single line response which is the correct Access URL. This is designed for use in applications that want to interpret the result before acting on it, for example, a JavaScript function that calls the GUID-mapping proxy and embeds the link within an HTML5 video tag for iPad, for example.
    • Selecting mode r (redirect mode) will generate a redirect to the correct URL. This is the equivalent of issuing a standard Access URL.
  • {c} is your account or customer ID, for example, petshow01
  • {0|1} selects the DRM mode.  Use 0 for non-DRM protected, and 1 for DRM protected.
  • {fi} is the ID of the Output Feed to which the access should be attributed and from which it will get its delivery configuration from.  It is optional, but is helpful for reporting. 

Examples:

http://cds1.yospace.com/rss/access/482018/myvideo192/r/petshow01/choice/u/0/1?f=2827192

Access the video "myvideo192" in the account petshow01 ingested via input feed ID 482018. Please note, iPhone delivery (eg. quality and mechanism) will be subject to the iPhone delivery preferences associated with feed 2827192 and therefore the Choice page will not be shown.