Playback URLs for HDS

Configure your encoder to generate playback URLs for HDS.

Encoders should allow primary and backup paths to be entered as follows:

  • Primary Playback path: hds/live/{streamID}/{eventname}/{object}

    Examples:

    • https://testconfig-i.akamaihd.net/hds/live/50002/test79/test79.f4m
    • https://testconfig-i.akamaihd.net/hds/live/50002/test79/5000kbpsSeg100Frag10
  • Backup Playback Path: hds/live/{streamID}-b/{eventname}/{object}

    Examples:

    • https://testconfig-i.akamaihd.net/hds/live/50002-b/test79/test79.f4m
    • https://testconfig-i.akamaihd.net/hds/live/50002-b/test79/5000kbpsSeg100Frag10
  • Base Playback URL: {customerhostname}.-i.akamaihd.net

The above playback information input from a user will be taken and embedded in the set-level manifest as two separate adaptiveSet sets. For example:


<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns="https://ns.adobe.com/f4m/1.0" version="3.0">
<id>myVideo</id>
<streamType>live</streamType>
<baseURL>https://testconfig-i.akamaihd.net/hds/live/</baseURL>
<adaptiveSet>
<media href="50002/test79/5000kbps.f4m" bitrate="5000"/>
</adaptiveSet>
<adaptiveSet>
<media href="50002-b/test79/5000kbps.f4m" bitrate="5000"/>
</adaptiveSet>
</manifest>

The HDS player requests the stream-level manifest using above URLs. It then parses information in the stream-level manifest and requests object names by appending to the base URLs in stream-level manifests. The player uses one of the following HTTP error responses from the server to use the backup stream content:

  • https://testconfig-i.akamaihd.net/hds/live/50002-b/test79/5000kbpsSeg24Frag41
  • https://testconfig-i.akamaihd.net/hds/live/50002-b/test79/5000kbps.drmmeta