Release NotesUser InterfaceSystem Status
Recent API Changes
Back to All

10 September 2020

over 4 years ago by Encoding.com Product Team #2

Charachtersitics attribute for HLS manifests

Added CHARACTERISTICS attribute for the EXT-X-MEDIA tag in HLS manifest to closed captions and alternate source params.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]</output> <!-- required-->
        <destination>[DestFile]</destination> <!-- required-->
        <closed_captions>
            <characteristics>[Characteristics]</characteristics>
            <!-- closed_captions params -->
        </closed_captions>
        <closed_captions>
            <!-- closed_captions params -->
        </closed_captions>
        <alternate_source>
            <characteristics>[Characteristics]</characteristics>
            <!-- alternate_source params -->
        </alternate_source>
        <alternate_source>
            <!-- alternate_source params -->
        </alternate_source>
      	<!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]", // required
            "destination": "[DestFile]", // required
            "closed_captions": [
                {
                    "characteristics": "[Characteristics]"
                    // closed_captions params
                },
                {
                    // closed_captions params
                }
            ]
            "alternate_source": [
                {
                    "characteristics": "[Characteristics]"
                    // alternate_source params
                },
                {
                    // alternate_source params
                }
            ]
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
characteristicsCHARACTERISTICS attribute value for the EXT-X-MEDIA tag in HLS manifest according to RFC 8216Valid CHARACTERISTICS value
For example for closed captions:
public.accessibility.transcribes-spoken-dialog
public.accessibility.describes-music-and-sound
For alternate source:
public.accessibility.describes-video		none

🚧

For characteristics parameter

<characteristics /> parameter available only for advanced_hls, fmp4_hls, and HLS manifests of advanced_fmp4 output formats.

Accessibility attributes for HLS manifests

Added accessibility attributes for the DASH manifests to alternate source params.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]</output> <!-- required-->
        <destination>[DestFile]</destination> <!-- required-->
        <alternate_source>
            <accessibility_scheme>[Scheme]</accessibility_scheme>
            <accessibility_value>[Value]</accessibility_value>
            <!-- alternate_source params -->
        </alternate_source>
        <alternate_source>
            <!-- alternate_source params -->
        </alternate_source>
      	<!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]", // required
            "destination": "[DestFile]", // required
            "alternate_source": [
                {
                    "accessibility_scheme": "[Scheme]",
                    "accessibility_value": "[Value]"
                    // alternate_source params
                },
                {
                    // alternate_source params
                }
            ]
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
accessibility_scheme"schemeIdUri" attribute value for the Accessibility tag in DASH manifestValid SCHEME value
For example:
urn:tva:metadata:cs:AudioPurposeCS:2007		none
accessibility_value"value" attribute value for the Accessibility tag in DASH manifestValid stringnone

🚧

For accessibility_scheme and accessibility_value parameters

<accessibility_scheme /> and <accessibility_value /> parameters available only for advanced_dash and DASH manifests of advanced_fmp4 output formats.

Dolby CBR

Added Dolby CBR option for the MP4 container.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>addMedia</action>
    <format> <!-- REQUIRED -->
        <output>[output]</output> <!-- REQUIRED -->
        <dolby_cbr>[yes|no]</dolby_cbr>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "dolby_cbr": "[yes|no]"
            // format params
        }
    }
}
ParameterDescriptionAllowed ValueDefault Value
dolby_cbrTurn dolby aac/heaac/heaacv2 encode to mp4 container instead of raw audio stream to make an audio CBR output.yes, nono