10 December 2020
about 4 years ago by Encoding.com Product Team #2
Disabled YouTube output destination
Note
Now we don't support YouTube as an output destination
New QC Check: Detect Blank Frames
Added new QC test that detects blank frames in video output streams.
Note
This test is ignored for audio-only streams in multi-bitrate formats.
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>AddMedia</action>
<source>[SourceFile|SourcePlaylist]</source><!-- required -->
<format>
<output>[qc_check|advanced_hls|advanced_dash|advanced_fmp4|fmp4_hls|mp4]</output><!-- required -->
<!-- Format params -->
<qc>
<qc_detect_black>
<min_duration>[Duration]</min_duration>
<pixel_black>[PixelThreshold]</pixel_black>
<picture_black_ratio>[PictureThreshold]</picture_black_ratio>
<severity>[fatal|warning]</severity>
</qc_detect_black>
</qc>
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "AddMedia", //required
"source": "[SourceFile|SourcePlaylist]", // required
"format": {
"output": "[qc_check|advanced_hls|advanced_dash|advanced_fmp4|fmp4_hlsh|mp4]", // required
"qc": {
"qc_detect_black": {
"min_duration": "[Duration]",
"pixel_black": "[PixelThreshold]",
"picture_black_ratio": "[PictureThreshold]",
"severity": "[fatal|warning]"
}
}
}
}
}
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>AddMedia</action>
<format>
<output>[qc_check|advanced_hls|advanced_dash|advanced_fmp4|fmp4_hls]</output><!-- required -->
<!-- Format params -->
<stream>
<qc>
<qc_detect_black>
<min_duration>[Duration]</min_duration>
<pixel_black>[PixelThreshold]</pixel_black>
<picture_black_ratio>[PictureThreshold]</picture_black_ratio>
<severity>[fatal|warning]</severity>
</qc_detect_black>
</qc>
</stream>
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "AddMedia", //required
"source": "[SourceFile|SourcePlaylist]", // required
"format": {
"output": "[qc_check|advanced_hls|advanced_dash|advanced_fmp4|fmp4_hls]", // required
"stream": [{
"qc": {
"qc_detect_black": {
"min_duration": "[Duration]",
"pixel_black": "[PixelThreshold]",
"picture_black_ratio": "[PictureThreshold]",
"severity": "[fatal|warning]"
}
}
}]
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| min_duration | Specify the shortest black frame duration in seconds. | Positive float number | 5 |
| pixel_black | Threshold for classification pixels as black. | Positive float number less than 1. 0 – Pixel must be absolutely black to be classified as black. 0.99 – The lightest pixels would be classified as black. | 0 |
| picture_black_ratio | Threshold for classification frame as black. | Positive float number less or equals to 1. 1 – Frame must have only “black” pixels to be classified as “black” frame. 0 – Frame can have no black pixels to be classified as “black” frame. | 1 |
| severity | Specify the QC severity | warning, fatal | none |
QC Auto Tests List
| Test Name | Formats Available |
|---|---|
| Blank Frame Detection | advanced_hls, advanced_dash, advanced_fmp4, fmp4_hls, mp4 |
QC Auto Conditions
| Test Name | Conditions | Value | Deviation |
|---|---|---|---|
| Blank Frame Detection | Contact us to include this test to QC Auto Excluded from audio-only streams. | min_duration: 5 pixel_black: 0 picture_black_ratio: 1 | none |
Dolby Audio Downmix Preferences: dmix-preference
Added option to set Dolby audio-dmix-preference.
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>AddMedia</action>
<source>[SourceFile]</source> <!-- required-->
<format> <!-- required -->
<output>[OutputFormat]</output> <!-- required -->
<audio_stream>
<dmix_preference>[loro|ltrt|pl2|unknown]</dmix_preference>
<!-- audio_stream params -->
</audio_stream>
<dmix_preference>[loro|ltrt|pl2|unknown]</dmix_preference>
<!-- format params -->
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "addMedia", // required
"source": "[JOCSourceFile]", // required
"format": { // required
"output": "[advanced_dash|fmp4_hls|advanced_fmp4]", // required
"audio_stream": [
{
"dmix_preference": "[loro|ltrt|pl2|unknown]"
// audio_stream params
},
{
// audio_stream params
}
],
"dmix_preference": "[loro|ltrt|pl2|unknown]"
// format params
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| dmix_preference | DMG audio-dmix-preference option | loro, ltrt, pl2, unknown | none |
Image Media Playlist Timescale Parameter
Added the timescale parameter for image_media_playlist settings.
<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required-->
<format>
<output>[advanced_dash|advanced_fmp4]</output> <!-- required-->
<destination>[DestFile]</destination> <!-- required-->
<image_media_playlist>
<timescale>[Timescale]</timescale>
<!-- image_media_playlist params -->
</image_media_playlist>
<image_media_playlist>
<!-- image_media_playlist params -->
</image_media_playlist>
<!-- Format params -->
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "[Action]", // required
"source": "[SourceFile]", // required
"format": {
"output": "[advanced_dash|advanced_fmp4]", // required
"destination": "[DestFile]", // required
"image_media_playlist": [
{
"timescale": "[Timescale]"
// image_media_playlist params
},
{
// image_media_playlist params
}
// multiple image_media_playlist may be included
]
// Format Params
}
}
}
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| timescale | Set timescale for DASH VTT thumbnails. | Positive integer, usually 1000 | none |
For timescale
<timescale /> parameter only available for advanced_dash and DASH manifests of advanced_fmp4 output formats.