06 July 2023
10 months ago by Encoding.com Product Team #2
Audio Stream Tune
Added audio tuning parameters for <audio_stream /> section
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required -->
<format>
<output>[OutputFormat]</output> <!-- required -->
<audio_stream>
<audio_tune>
<low_pass_filter>[FilterFrequency]</low_pass_filter>
<high_pass_filter>[FilterFrequency]</high_pass_filter>
<compand_points>[CompandFilter]</compand_points>
<channel>
<id>[ChannelID]</id>
<low_pass_filter>[FilterFrequency]</low_pass_filter>
<high_pass_filter>[FilterFrequency]</high_pass_filter>
<compand_points>[CompandFilter]</compand_points>
<gain>[ChannelGainLevel]</gain>
<max_peak>[MaxPeakLevel]</max_peak>
</channel>
<channel>
<!-- audio tune channel params -->
</channel>
</audio_tune>
<!-- audio_stream params -->
</audio_stream>
<!-- multiple audio_streams -->
<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": "[OutputFormat]", // required
"audio_stream": [
{
"audio_tune": {
"low_pass_filter": "[FilterFrequency]",
"high_pass_filter": "[FilterFrequency]",
"compand_points": "[CompandFilter]",
"channel": [
{
"id": "[ChannelID]",
"low_pass_filter": "[FilterFrequency]",
"high_pass_filter": "[FilterFrequency]",
"compand_points": "[CompandFilter]",
"gain": "[ChannelGainLevel]",
"max_peak": "[MaxPeakLevel]"
},
{
// audio tune channel params
}
]
}
// audio_stream params
},
{
// audio_stream params
}
]
// format params
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| Audio Tune Parameters | |||
| low_pass_filter | Low Pass filter frequency | Non-negative integer numberNon-negative integer number | none |
| high_pass_filter | High Pass filter frequency | Non-negative integer numberNon-negative integer number | none |
| compand_points | Compand filter points separated by pipe symbol | Valid compand filter string | none |
| Audio Tune Channel Parameters | |||
| id | Channel ID starting from 0 | Non-negative integer number | none |
| low_pass_filter | Low Pass filter frequency | Non-negative integer number | none |
| high_pass_filter | High Pass filter frequency | Non-negative integer number | none |
| compand_points | Compand filter points separated by pipe symbol | Valid compand filter string | none |
| gain | Channel gain level | Float number between -100 and 100 exclusive | none |
| max_peak | Maximum true peak level. Channel volume will be decreased to hit the specified value if the channel peak value overshoot the limit | Negative float number greater than -100 | none |
Large DEE Audio Stream Normalization
Added audio normalization parameters large (over 4GB) <audio_stream /> with DEE processing
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required -->
<format>
<output>[OutputFormat]</output> <!-- required -->
<adjust_lra>[LRALevel]</adjust_lra>
<accepted_loudness_interval>[LoudnessInterval]</accepted_loudness_interval>
<!-- audio_stream params -->
</audio_stream>
<!-- multiple audio_streams -->
<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": "[OutputFormat]", // required
"audio_stream": [
{
"adjust_lra": "[LRALevel]",
"accepted_loudness_interval": "[LoudnessInterval]"
// audio_stream params
},
{
// audio_stream params
}
]
// format params
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| adjust_lra | LRA value audio normalization that would be applied for large audio streams | Positive float number between 1 and 20 inclusive | none |
| accepted_loudness_interval | Loudness interval of iterative loudness normalization for large audio streams | Positive float number between 0.1 and 1 inclusive | 1 |
For adjust_lra and accepted_loudness_interval
The <adjust_lra /> and <accepted_loudness_interval /> parameters only applied for DEE processing for large audio streams with size over 4GB
For accepted_loudness_interval
We discovered, that sometimes loudness normalization performed by our default audio encoder doesn't work well, especially on complex audio with a high loudness range. Therefore an iterative loudness correction procedure may be applied. The accepted_loudness_interval parameter tunes the exit criteria for this procedure by setting an acceptable loudness interval. Corresponding to the EBU recommendation we use default value equals to 1.