10 December 2020

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]"
                    }
                }
            }]
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
min_durationSpecify the shortest black frame duration in seconds.Positive float number5
pixel_blackThreshold 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_ratioThreshold 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
severitySpecify the QC severitywarning, fatalnone

QC Auto Tests List

Test NameFormats Available
Blank Frame Detectionadvanced_hls, advanced_dash, advanced_fmp4, fmp4_hls, mp4

QC Auto Conditions

Test NameConditionsValueDeviation
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
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
dmix_preferenceDMG audio-dmix-preference optionloro, ltrt, pl2, unknownnone

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
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
timescaleSet timescale for DASH VTT thumbnails.Positive integer, usually 1000none

🚧

For timescale

<timescale /> parameter only available for advanced_dash and DASH manifests of advanced_fmp4 output formats.