30 April 2015 - Dolby Digital Plus and playlist

Dolby Digital Plus

Audio settings

'eac3' codec support:

Field Name	Description	Allowed Values	Default Values
audio_codec	Audio codec	smooth_streaming: libfaac, dolby_aac, dolby_heaac, dolby_heaacv2, eac3 advanced hls stream: libfaac, dolby_aac, dolby_heaac, dolby_heaacv2, ac3, eac3, libmp3lame(only for 'v3' segmenter) mpegts: ac3, eac3 mpegdash: libfaac, eac3	smooth_streaming: libfaac advanced hls stream: libfaac mpegdash: libfaac mpegdash: libfaac mpegts: ac3

New 'downmix_mode' option:

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <downmix_mode>[pl2|loro]</downmix_mode>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "downmix_mode": "[pl2|loro]"
        }
    }
}

Field Name	Description	Allowed Values	Default Values
downmix_mode	Downmix mode for Dolby Media Generator	pl2 - Downmixing from 5.1 (6 channel) or 7.1 (8 channel) using Dolby Pro Logic II encoding (2 channel) loro - Convert Dolby 5.1 (6 channel) or 7.1 (8 channel) to stereo (2 channel)	pl2

Advanced HLS

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>advanced_hls</output>
        <segmenter>[v1|v2|v3|dolby_segmenter]</segmenter>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "advanced_hls",
            "segmenter": "[v1|v2|v3|dolby_segmenter]"
        }
    }
}

Field Name	Description	Allowed Values	Default Values
segmenter	Type of segmenter.	v1 – This is the segmenter bundled with FFMPEG and carries significant overhead (as much as 27% with a 364kbps file or 17.3% with a 864kbps file!), and generated several warnings. v2 - This is based on HTTP Live Segmenter tool. It carries with it the same overhead, but generates far fewer warnings. v3 - This version, called tsparser, was built in-house from the ground up to be optimized for our cloud infrastructure. This has significantly less overhead (5.8% with a 364kbps file or 3.8% with a 864kbps file), and does not generate any warnings. dolby_segmenter - Dolby Media Generator segmenter(dolby_segmenter) will update libfaac audio codec to dolby_aac, when the libfaac codec is specified. When 'copy' is specified as the audio_codec then the source audio codec will be used. In case iframe stream requested then v3 segmenter wil be used.	v3

MPEG-DASH

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>mpeg_dash</output>
        <dash_profile>[full|ondemand|live|hbbtv]</dash_profile>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "mpeg_dash",
            "dash_profile": "[full|ondemand|live|hbbtv]"
        }
    }
}

Field Name	Description	Allowed Values	Default Values
dash_profile	Dolby Segmenter profile	full — old mpeg dash output ondemand — onDemand profile live — Live profile hbbtv — HbbTV profile	full

Microsoft Smooth Streaming

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>smooth_streaming</output>
        <segmenter>[v1|dolby_segmenter]</segmenter>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "smooth_streaming",
            "segmenter": "[v1|dolby_segmenter]"
        }
    }
}

Field Name	Description	Allowed Values	Default Values
segmenter	Type of segmenter.	v1 – old segmenter. dolby_segmenter - Dolby Media Generator segmenter	v1

playlist_version param

Apple's HTTP Live Streaming

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>[iphone_stream|ipad_stream]</output>
        <playlist_version>[Valid EXT-X-VERSION]</playlist_version>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "[iphone_stream|ipad_stream]",
            "playlist_version": "[Valid EXT-X-VERSION]"
        }
    }
}

Field Name	Description	Allowed Values	Default Values
playlist_version	Version of m3u8 playlist file	Integer(EXT-X-VERSION)	None

Advanced HLS and Apple TV

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>[advanced_hls|appletv|appletv_43]</output>
        <playlist_version>[Valid EXT-X-VERSION]</playlist_version>
        <stream>
            <!-- Stream fields -->
            <playlist_version>[Valid EXT-X-VERSION]</playlist_version>
        </stream>
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "[advanced_hls|appletv|appletv_43]",
            "playlist_version": "[Valid EXT-X-VERSION]",
            "stream": {
                "playlist_version": "[Valid EXT-X-VERSION]"
            }
        }
    }
}

Field Name	Description	Allowed Values	Default Values
playlist_version	Version of m3u8 playlist file	Integer(EXT-X-VERSION)	None