Blank Frames Detection

❗️

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

warning