20 May 2021
almost 3 years ago by Encoding.com Product Team #2
Dolby Atmos® Master Files DAMF and ADM BWF
Added support of eac3joc audio codec and Dolby Atmos DAMF or ADM BWF alternate sources for advanced_dash, advanced_fmp4, and fmp4_hls output formats.
<?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-->
<stream>
<audio_only>yes</audio_only>
<audio_codec>eac3joc</audio_codec>
<!-- stream params -->
</stream>
<!-- Multiple stream params may be included in output format -->
<!-- Maximum number of available streams is 15 -->
<stream>
<!-- stream params -->
</stream>
<alternate_source>
<source>[FileURL]</source> <!-- ADM BWF File -->
<type>audio</type>
<audio_name>[Name]</audio_name>
<!-- alternate_source params -->
</alternate_source>
<alternate_source>
<source>[FileURL]</source> <!-- DAMF Atmos File -->
<damf_audio>[DAMFAudioURL]</damf_audio>
<damf_metadata>[DAMFMetadataURL]</damf_metadata>
<type>audio</type>
<audio_name>[Name]</audio_name>
<!-- 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_dash|fmp4_hls|advanced_fmp4]", // required
"destination": "[DestFile]", // required
"stream": [
{
"audio_only": "yes",
"audio_codec": "eac3joc"
// stream params
},
{
// stream params
}
// Multiple stream params may be included in output format
// Maximum number of available streams is 15
],
"alternate_source": [
{
"source": "[FileURL]", // ADM BWF File
"type": "audio",
"audio_name": "[Name]",
"damf_audio": "[DAMFAudioURL]",
"damf_metadata": "[DAMFMetadataURL]"
// alternate_source params
},
{
"source": "[FileURL]", // DAMF Atmos File
"damf_audio": "[DAMFAudioURL]",
"damf_metadata": "[DAMFMetadataURL]",
"type": "audio",
"audio_name": "[Name]"
// alternate_source params
},
{
// alternate_source params
}
// multiple alternate_sources may be included
],
// Format Params
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| Format Parameters | |||
| audio_codec | Specify the audio codec | fmp4_hls, advanced_dash, advanced_fmp4: libfaac, dolby_aac, dolby_heaac, dolby_heaacv2, ac3, eac3, eac3joc | advanced_hls, fmp4_hls, advanced_dash, advanced_fmp4: libfaac |
| Alternate Source Parameters | |||
| damf_audio | DAMF Audio aux file | Valid URL | none |
| damf_metadata | DAMF Metadata aud file | Valid URL | none |
For damf_audio and damf_metadata
The damf_audio and damf_metadata parameters available only for advanced_dash, advanced_fmp4, and fmp4_hls output formats.
Dolby Atmos DAMF files
Dolby Atmos DAMF alternate source files are:
- <source /> – XML .atmos file with DAMF file description (framerate, beds and objects number, FFoA, start time offset etc)
- <damf_metadata /> – XML .atmos.metadata file with objects size and position (xyz) coordinates over time
- <damf_metadata /> – CAF (Core Audio FIle) file .atmos.audio It may contains up to 128 tracks.