28 July 2022

HEVC Level

Added support of level customizing for HEVC video codec.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[mpeg_dash|mp4]</output> <!-- required-->
        <video_codec>hevc</video_codec>
        <video_codec_parameters>
            <level>[Level]</level>
            <!-- video_codec_parameters -->
        </video_codec_parameters>
        <!-- format params -->
    </format>
</query>
<?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|fmp4_hls]</output> <!-- required-->
        <stream>
            <video_codec>hevc</video_codec>
            <video_codec_parameters>
                <level>[Level]</level>
                <!-- video_codec_parameters -->
            </video_codec_parameters>
            <!-- stream params -->
        </stream>
        <stream>
            <!-- stream params -->
        </stream>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[mpeg_dash|mp4]", // required
            "video_codec": "hevc",
            "video_codec_parameters": {
                "level": "[Level]"
                // video_codec_parameters
            }
            // format params
        }
    }
}
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[advanced_dash|fmp4_hls]", // required
            "stream": [
                {
                    "video_codec": "hevc",
                    "video_codec_parameters": {
                        "level": "[Level]"
                        // video_codec_parameters
                    }
                },
                {
                    // stream params
                }
            ]
            // format params
        }
    }
}

Parameter

Decription

Allowed Values

Default Value

level

Video Level

Positive integer number

  • *10** – 1.0,
  • *20** – 2.0,
  • *21** – 2.1,
  • *22** – 2.2,
  • *30** – 3.0,
  • *31** – 3.1,
  • *32** – 3.2,
  • *40** – 4.0,
  • *41** – 4.1,
  • *50** – 5.0,
  • *51** – 5.1,
  • *52** – 5.2,
  • *60** – 6.0,
  • *61** – 6.1,
  • *62** – 6.2

none

More filtered special characters from sub path parameter

Special characters will be filtered out from value of <sub_path /> parameter in <stream />, <main_manifest />, <alternate_source />, and <image_media_playlist /> parameters block.

<?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>
            <sub_path>[Playlist sub path]</sub_path>
            <!-- stream params -->
        </stream>
        <!-- Multiple stream params may be included in output format -->
        <!-- Maximum number of available streams is 15 -->
        <stream>
            <!-- stream params -->
        </stream>
        <manifest>
            <sub_path>[SubPath]</sub_path>
            <!-- manifest params -->
        </manifest>
        <manifest>
            <!-- manifest params -->
        </manifest>
        <!-- Multiple manifests may be included -->
        <alternate_source>
            <sub_path>[SubPath]</sub_path>
            <!-- alternate_source params -->
        </alternate_source>
        <alternate_source>
            <!-- alternate_source params -->
        </alternate_source>
        <!-- multiple alternate_sources may be included -->
        <image_media_playlist>
            <sub_path>[SubPath]</sub_path>
            <!-- image_media_playlist params -->
        </image_media_playlist>
        <image_media_playlist>
            <!-- image_media_playlist params -->
        </image_media_playlist>
        <!-- multiple image_media_playlist may be included -->
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]", // required
            "destination": "[DestFile]", // required
            "stream": [
                {
                    "sub_path": "[Playlist sub path]"
                    // stream params
                },
                {
                    // stream params
                }
                // Multiple stream params may be included in output format
                // Maximum number of available streams is 15
            ],
            "manifest": [
                {
                    "sub_path": "[SubPath]"
                    // manifest params
                },
                {
                    // manifest params
                }
                // Multiple manifests may be included
            ],
            "alternate_source": [
                {
                    "sub_path": "[SubPath]"
                    // alternate_source params
                },
                {
                    // alternate_source params
                }
                // multiple alternate_sources may be included
            ],
            "image_media_playlist": [
                // image_media_playlist doesn't work with advanced_mss
                {
                    "sub_path": "[SubPath]"
                    // image_media_playlist params
                },
                {
                    // image_media_playlist params
                }
                // multiple image_media_playlist may be included
            ],
            // format Params
        }
    }
}

Parameter

Description

Allowed Values

Default Value

sub_path

Asset sub directory relative to the output destination

String

none

🚧

For sub_path parameter

These characters will be filtered out: "\", "`", "№", "$", "#", "?"