Publishing URL format

Encoders should be capable of using a POST URL in the described format.

This is the syntax for the entrypoint hostnames and URL paths for Media Services Live 4.0 and above.
  • Hostname: p-ep{stream_id}.i.akamaientrypoint.net
  • URL Path: https://p-ep{stream_id}.i.akamaientrypoint.net/<stream_id>/<uniquesourcename>/<sessionID>/<bitrateID>/<OPTIONAL_PATH>/<somename>_<sequence#>.ts

This table describes the publishing parameters.

Publishing Parameter Description
URL Path Element Description
stream_id Unique identifier for the stream provided by Akamai.
uniquesourcename This is a nomenclature change of the current event name. This is the first URL path component following the stream_id. Use this name to identify the current media source from a set of sources ingesting into Akamai.
Unique sessionID This is needed to distinguish different encoder restart points and make sure that path duplications do not overwrite the media objects across the restart points.

For example: for a 24x7 source, a good recommendation is to have a string with the date time string at the time of connection. <stream_id>/<uniquesourcename>/20160628T18h22m10s/* or <stream_id>/<uniquesourcename>/T1467082295/*

bitrateID A unique path element to distinguish media segments specific to a bitrate. It is mandatory to have this path element. Bitrate in kilo bits of the corresponding media object should be extractable using a regular expression such as: */rend4000K/*, */master_3000K/*, */bitrate3000K/*.
OPTIONAL_PATH Other fixed pathnames for specific work flows that are not mandatory. For software releases prior to Media Services Live 4.0, this is the directory rollover pathname.

Media Services Live 4.0 and above does not require directory rollover. You can upload all of the segment objects for a specific bitrate into the same URL path.

However, to ensure compatibility the encoder should continue to support both directory rollover as well as non-rollover options in the short term.

The playback URL format remains the same as previous MSL versions, which is: https://example-i.akamaized.net/cmaf/live/[stream_id]/[event_name]/[filename_.m3u8_or_.mpd]