17 March 2022

AC3 and EAC3 audio descriptors for MPEG-TS container

Added ability to set AC3 or EAC3 audio descriptors for MPEG-TS container. Added ability to set audio track disposition.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>mpegts</output> <!-- required -->
        <atsc_ac3_descriptor>
            <full_svc>[0|1]</full_svc>
            <priority>[1|2|3]</priority>
            <mainid>[ServiceID]</mainid>
            <asvcflags>[BitFlag]</asvcflags>
            <language_code>[LanguageCode]</language_code>
        </atsc_ac3_descriptor>
        <atsc_eac3_descriptor>
            <audio_service_type>[ServiceType]</audio_service_type>
            <mainid>[ServiceID]</mainid>
            <language_code>[LanguageCode]</language_code>
        </atsc_eac3_descriptor>
        <audio_stream>
            <disposition>[visual_impaired|hearing_impaired]</disposition>
            <atsc_ac3_descriptor>
                <full_svc>[0|1]</full_svc>
                <priority>[1|2|3]</priority>
                <mainid>[ServiceID]</mainid>
                <asvcflags>[BitFlag]</asvcflags>
                <language_code>[LanguageCode]</language_code>
            </atsc_ac3_descriptor>
            <atsc_eac3_descriptor>
                <audio_service_type>[ServiceType]</audio_service_type>
                <mainid>[ServiceID]</mainid>
                <language_code>[LanguageCode]</language_code>
            </atsc_eac3_descriptor>
            <!-- audio_stream params -->
        </audio_stream>
        <audio_stream>
            <!-- audio_stream params -->
        </audio_stream>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "mpegts", // required
            "atsc_ac3_descriptor": {
                "full_svc": "[0|1]",
                "priority": "[1|2|3]",
                "mainid": "[ServiceID]",
                "asvcflags": "[BitFlag]",
                "language_code": "[LanguageCode]"
            },
            "atsc_eac3_descriptor": {
                "audio_service_type": "[ServiceType]",
                "mainid": "[ServiceID]",
                "language_code": "[LanguageCode]"
            },
            "audio_stream": [
                {
                    "disposition": "[visual_impaired|hearing_impaired]",
                    "atsc_ac3_descriptor": {
                        "full_svc": "[0|1]",
                        "priority": "[1|2|3]",
                        "mainid": "[ServiceID]",
                        "asvcflags": "[BitFlag]",
                        "language_code": "[LanguageCode]"
                    },
                    "atsc_eac3_descriptor": {
                        "audio_service_type": "[ServiceType]",
                        "mainid": "[ServiceID]",
                        "language_code": "[LanguageCode]"
                    }
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
        }
    }
}
<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>advanced_hls</output> <!-- required -->
        <destination>[DestFile]</destination> <!-- required -->
        <stream>
            <atsc_ac3_descriptor>
                <full_svc>[0|1]</full_svc>
                <priority>[1|2|3]</priority>
                <mainid>[ServiceID]</mainid>
                <asvcflags>[BitFlag]</asvcflags>
                <language_code>[LanguageCode]</language_code>
            </atsc_ac3_descriptor>
            <atsc_eac3_descriptor>
                <audio_service_type>[ServiceType]</audio_service_type>
                <mainid>[ServiceID]</mainid>
                <language_code>[LanguageCode]</language_code>
            </atsc_eac3_descriptor>
            <audio_stream>
                <disposition>[visual_impaired|hearing_impaired]</disposition>
                <atsc_ac3_descriptor>
                    <full_svc>[0|1]</full_svc>
                    <priority>[1|2|3]</priority>
                    <mainid>[ServiceID]</mainid>
                    <asvcflags>[BitFlag]</asvcflags>
                    <language_code>[LanguageCode]</language_code>
                </atsc_ac3_descriptor>
                <atsc_eac3_descriptor>
                    <audio_service_type>[ServiceType]</audio_service_type>
                    <mainid>[ServiceID]</mainid>
                    <language_code>[LanguageCode]</language_code>
                </atsc_eac3_descriptor>
                <!-- audio_stream params -->
            <audio_stream>
            <!-- stream params -->
        </stream>
        <stream>
            <!-- stream params -->
        </stream>
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "advanced_hls", // required
            "stream": [
                {
                    "atsc_ac3_descriptor": {
                        "full_svc": "[0|1]",
                        "priority": "[1|2|3]",
                        "mainid": "[ServiceID]",
                        "asvcflags": "[BitFlag]",
                        "language_code": "[LanguageCode]"
                    },
                    "atsc_eac3_descriptor": {
                        "audio_service_type": "[ServiceType]",
                        "mainid": "[ServiceID]",
                        "language_code": "[LanguageCode]"
                    },
                    "audio_stream": {
                        "disposition": "[visual_impaired|hearing_impaired]",
                        "atsc_ac3_descriptor": {
                            "full_svc": "[0|1]",
                            "priority": "[1|2|3]",
                            "mainid": "[ServiceID]",
                            "asvcflags": "[BitFlag]",
                            "language_code": "[LanguageCode]"
                        },
                        "atsc_eac3_descriptor": {
                            "audio_service_type": "[ServiceType]",
                            "mainid": "[ServiceID]",
                            "language_code": "[LanguageCode]"
                        }
                        // audio_stream params
                    }
                    // stream params
                },
                {
                    // stream params
                }
            ]
        }
    }
}

Parameter

Description

Allowed Values

Default Value

disposition

Audio stream disposition type

visual_impaired, hearing_impaired

none

atsc_ac3_descriptor

Add ATSC A/52 AC3 audio elementary stream descriptor in MPEG-TS container

full_svc

Indicates whether or not this audio service is a full service suitable for presentation, or whether this audio service is only a partial service which should be combined with another audio service before presentation

0 – partial service
1 – full service

1

priority

Audio service priority

1 – Primary audio
2 – Other audio
3 – Not specified

1

mainid

Main audio service identifier

Integer number between 0 and 7 inclusive

0

asvcflags

8-bit field. Each bit (0–7) indicates with which main service(s) this service is associated

Integer number between 0 and 255 inclusive

0

language_code

Audio stream language

Valid ISO 639-2 language code

none
Value of <language /> parameter will be used if specified.

atsc_eac3_descriptor

Add ATSC A/52 E-AC3 audio elementary stream descriptor in MPEG-TS container

audio_service_type

Audio service type

0 – Complete main
2 – Visually impaired
3 – Hearing impaired
5 – Commentary
6 – Emergency
7 – Karaoke

none
Value of <disposition /> parameter will be used if specified or disposition descriptor from source file.

asvcflags

8-bit field. Each bit (0–7) indicates with which main service(s) this service is associated

Integer number between 0 and 255 inclusive

0

language_code

Audio stream language

Valid ISO 639-2 language code

none
Value of <language /> parameter will be used if specified.