Release NotesUser InterfaceSystem Status
GuidesAPI ReferenceRecent API Changes
Release NotesUser InterfaceSystem StatusLog In
Recent API Changes
Back to All

08 July 2021

about 5 years ago by Encoding.com Product Team #2

Auto Audio Trim

Added option to trim audio track if it's duration is longer than video duration.

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required-->
    <userkey>KEY</userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source>
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <auto_audio_trim>[yes|no]</auto_audio_trim>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "auto_audio_trim": "[yes|no]"
            // format params
        }
    }
}

Dolby AAC Encoding

Added support of AAC Encoding thru Dolby Encoder.

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required-->
    <userkey>KEY</userkey> <!-- required-->
    <action>addMedia</action>
    <source>[SourceFile]</source>
    <format> <!-- required -->
        <output>[output]</output> <!-- REQUIRED -->
        <audio_codec>aac</audio_codec>
        <audio_encoder>dee</audio_encoder>
        <audio_sample_rate>48000</audio_sample_rate>
        <aac_mode>[auto|aac|heaac|heaacv2]</aac_mode>
        <aac_speech_optimization>[yes|no]</aac_speech_optimization>
        <audio_stream>
            <audio_codec>aac</audio_codec>
            <audio_encoder>dee</audio_encoder>
            <layout>[stereo|mono]</layout>
            <audio_sample_rate>48000</audio_sample_rate>
            <aac_mode>[auto|aac|heaac|heaacv2]</aac_mode>
            <aac_speech_optimization>[yes|no]</aac_speech_optimization>
            <!-- audio stream params -->
        <audio_stream>
        <audio_stream>
            <!-- audio stream params -->
        <audio_stream>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "audio_codec": "aac",
            "audio_encoder": "dee",
            "audio_sample_rate": "48000",
            "aac_mode": "[auto|aac|heaac|heaacv2]",
            "aac_speech_optimization": "[yes|no]",
            "audio_stream": [
                {
                    "audio_codec": "aac",
                    "audio_encoder": "dee",
                    "layout": "[mono|stereo]",
                    "audio_sample_rate": "48000",
                    "aac_mode": "[auto|aac|heaac|heaacv2]",
                    "aac_speech_optimization": "[yes|no]"
                    // audio stream params
                },
                {
                    // audio stream params
                }
            ]
            // format params
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
aac_modeDEE AAC encoder modeauto, aac, heaac, heaacv2auto
aac_speech_optimizationDEE AAC speech optimizationyes, nono
🚧

Note

AAC Encoding thru Dolby Encoder available only if <audio_codec /> aac or libfaac <audio_encoder /> set to dee, <layout> set to stereo or mono, and <sample_rate /> set to 48000

Dolby Atmos® Support for Common Output Formats

Added ability to produce audio output with Joint Audio Coding for Dolby Atmos® source files.

DAMF Source File

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required-->
    <userkey>KEY</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>
        <url>[SourceFile]</url> <!-- main video source file -->
        <url> 
            <main_source>[DAMFSourceFile]</main_source>  <!-- DAMF Atmos file -->
            <sidecar>
                <url>[DAMFMetaFile]</url> <!-- DAMF metadata file -->
                <type>damf_meta</type>
            </sidecar>
            <sidecar>
                <url>[DAMFAudioFile]</url> <!-- DAMF audio file-->
                <type>damf_audio</type>
            </sidecar>
        </url> <!-- DAMF source files -->
        <audio_stream> <!-- map DAMF source file as audio stream -->
            <use_stream_id>1:0</use_stream_id>
            <natural_order>yes</natural_order>
        </audio_stream>
    </source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <audio_stream>
            <use_stream_id>0</use_stream_id>
            <audio_codec>eac3joc</audio_codec>
            <natural_order>yes</natural_order>
            <!-- audio_stream params -->
        </audio_stream>
        <!-- Multiple stream params may be included in output format -->
        <!-- Maximum number of available streams is 15 -->
        <audio_stream>
            <!-- audio_stream params -->
        </audio_stream>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "[Action]", // required
        "source": {
            "url": [
                "SourceFile", // main video source file
                {
                    "main_source": "[DAMFSourceFile]", // DAMF Atmos file
                    "sidecar": [
                        {
                            "url": "[DAMFMetaFile]",  // DAMF metadata file
                            "type": "damf_meta"
                        },
                        {
                            "url": "[DAMFAudioFile]",  // DAMF audio file
                            "type": "damf_audio"
                        }
                    ]
                } // DAMF source files
            ],
            "audio_stream": { // map ADM BWF source file as audio stream
                "use_stream_id": "1:0",
                "natural_order": "yes"
            }
        }, // required
        "format": {
            "output": "[OutputFormat]", // required
            "audio_stream": [
                {
                    "use_stream_id": "0",
                    "audio_codec": "eac3joc",
                    "natural_order": "yes"
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}
Parameter Description Allowed Values Default Value
***Media parameters***
 **source** Media Source description *none*
***Source parameters***
 **url** Media Source File description *none*
 **audio\_stream** Source audio streams description *none*
***URL parameters***
 **main\_source** DAMF Atmos source file Valid URL *none*
 **sidecar** DAMF Sidecars
***Sidecar parameters***
 **type** DAMF Sidecar type damf\_meta, damf\_audio *none*
 **url** DAMF Sidecar file Valid URL *none*
***Source audio stream parameters***
 **use\_stream\_id** Specify the media stream ID. Set of 2 non-negative integer numbers separated by colon sign\ e.g. **F**:**S**\ Where * **F** – File index (index of **\** param in **\** block) * **S** – Stream index in source file *none*
 **natural\_order** If set to *yes* then value of **\ yes, no It's hardly recommended to set it to *yes* no
***Format parameters***
 **output** Output format mp4, mpegts, apple\_prores, m4a, wowza, wowza\_multibitrate, wowza\_multibitrate\_mp4, roku\_\*, kindle\_fire, mov, smooth\_streaming, mpeg\_dash *none*
 **audio\_stream** Output audio streams mapping *none*
***Format audio stream parameters***
 **audio\_codec** Specify the audio codec * \*eac3joc\*\* for Dolby Atmos® audio * \*m4a\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*mp4\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, ac3, eac3, eac3joc * \*wowza**,**roku\_\***,**kindle\_fire\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*mov\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc, pcm\_f32be, pcm\_f32le * \*wowza\_multibitrate**,**wowza\_multibitrate\_mp4**,**roku\_hls**,**hds\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*smooth\_streaming\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*mpegts\*\*: ac3, eac3, eac3joc, libfaac, libmp3lame, mp2, dolby\_aac, dolby\_heaac, dolby\_heaacv2, copy * \*mpeg\_dash\*\*: libfaac, eac3, eac3joc * \*mp4\*\*: libfaac * \*mpegts\*\*: ac3 * \*m4a\*\*: libfaac * \*apple\_prores\*\*: libfaac * \*wowza\*\*: libfaac * \*wowza\_multibitrate\*\*: libfaac * \*wowza\_multibitrate\_mp4\*\*: libfaac * \*roku\_\*\*\*: libfaac * \*kindle\_fire\*\*: libfaac * \*mov\*\*: libfaac * \*smooth\_streaming\*\*: libfaac * \*mpeg\_dash\*\*: libfaac
 **use\_stream\_id** Specify the source media stream ID. Non negative integer number By default # of \*\*\
 **natural\_order** If set to *yes* then value of **\ yes, no It's hardly recommended to set it to *yes* no

ADM BWF Source FIle

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required-->
    <userkey>KEY</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>
        <url>[SourceFile]</url> <!-- main video source file -->
        <url>[ADMSourceFile]</url> <!-- ADM BWF source file -->
        <audio_stream> <!-- map ADM BWF source file as audio stream -->
            <use_stream_id>1:0</use_stream_id>
            <natural_order>yes</natural_order>
        </audio_stream>
    </source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <audio_stream>
            <use_stream_id>0</use_stream_id>
            <audio_codec>eac3joc</audio_codec>
            <natural_order>yes</natural_order>
            <!-- audio_stream params -->
        </audio_stream>
        <!-- Multiple stream params may be included in output format -->
        <!-- Maximum number of available streams is 15 -->
        <audio_stream>
            <!-- audio_stream params -->
        </audio_stream>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "[Action]", // required
        "source": {
            "url": [
                "[SourceFile]",   // main video source file
                "[ADMSourceFile]" // ADM BWF source file
            ],
            "audio_stream": { // map ADM BWF source file as audio stream
                "use_stream_id": "1:0",
                "natural_order": "yes"
            }
        }, // required
        "format": {
            "output": "[OutputFormat]", // required
            "audio_stream": [
                {
                    "use_stream_id": "0",
                    "audio_codec": "eac3joc",
                    "natural_order": "yes"
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}
Parameter Description Allowed Values Default Value
***Media parameters***
 **source** Media Source description *none*
***Source parameters***
 **url** Media Source Files: input video file and ADM BWF file Valid URL *none*
 **audio\_stream** Source audio streams description *none*
***Source audio stream parameters***
 **use\_stream\_id** Specify the media stream ID. Set of 2 non-negative integer numbers separated by colon sign\ e.g. **F**:**S**\ Where * **F** – File index (index of **\** param in **\** block) * **S** – Stream index in source file *none*
 **natural\_order** If set to *yes* then value of **\ yes, no It's hardly recommended to set it to *yes* no
***Format parameters***
 **output** Output format mp4, mpegts, apple\_prores, m4a, wowza, wowza\_multibitrate, wowza\_multibitrate\_mp4, roku\_\*, kindle\_fire, mov, smooth\_streaming, mpeg\_dash *none*
 **audio\_stream** Output audio streams mapping *none*
***Format audio stream parameters***
 **audio\_codec** Specify the audio codec * \*eac3joc\*\* for Dolby Atmos® audio * \*m4a\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*mp4\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, ac3, eac3, eac3joc * \*wowza**,**roku\_\***,**kindle\_fire\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*mov\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc, pcm\_f32be, pcm\_f32le * \*wowza\_multibitrate**,**wowza\_multibitrate\_mp4**,**roku\_hls**,**hds\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*smooth\_streaming\*\*: libfaac, dolby\_aac, dolby\_heaac, dolby\_heaacv2, eac3, eac3joc * \*mpegts\*\*: ac3, eac3, eac3joc, libfaac, libmp3lame, mp2, dolby\_aac, dolby\_heaac, dolby\_heaacv2, copy * \*mpeg\_dash\*\*: libfaac, eac3, eac3joc * \*mp4\*\*: libfaac * \*mpegts\*\*: ac3 * \*m4a\*\*: libfaac * \*apple\_prores\*\*: libfaac * \*wowza\*\*: libfaac * \*wowza\_multibitrate\*\*: libfaac * \*wowza\_multibitrate\_mp4\*\*: libfaac * \*roku\_\*\*\*: libfaac * \*kindle\_fire\*\*: libfaac * \*mov\*\*: libfaac * \*smooth\_streaming\*\*: libfaac * \*mpeg\_dash\*\*: libfaac
 **use\_stream\_id** Specify the source media stream ID. Non negative integer number By default # of \*\*\
 **natural\_order** If set to *yes* then value of **\ yes, no It's hardly recommended to set it to *yes* no