08 July 2021

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
        }
    }
}

Parameter	Description	Allowed Values	Default Value
aac_mode	DEE AAC encoder mode	auto, aac, heaac, heaacv2	auto
aac_speech_optimization	DEE AAC speech optimization	yes, no	no

🚧
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 <url /> param in <source /> block) S – Stream index in source file	none
natural_order	If set to yes then value of <use_stream_id /> will mean number of source's audio stream, not number of stream in all type streams list.	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 **<audio_stream /> param will be used.
natural_order	If set to yes then value of <use_stream_id /> will mean number of source's audio stream, not number of stream in all type streams list.	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 <url /> param in <source /> block) S – Stream index in source file	none
natural_order	If set to yes then value of <use_stream_id /> will mean number of source's audio stream, not number of stream in all type streams list.	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 **<audio_stream /> param will be used.
natural_order	If set to yes then value of <use_stream_id /> will mean number of source's audio stream, not number of stream in all type streams list.	yes, no It's hardly recommended to set it to yes	no