11 March 2021

GetMediaList Media Closed Date

Added a new parameter to the GetMediaList response that represents the last media task close date and time.

Request

<?xml version="1.0"?>
<query>
    <userid><<id>></userid>
    <userkey><<key>></userkey>
    <action>GetMediaList</action>
    <version>2</version>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "GetMediaList",
        "version": "2"
    }
}

Parameter	Description	Allowed Values
version	Version	1* – default version 2* – include media closing date and time

Response

<?xml version="1.0"?>
<response>
    <media>
        <mediafile>[SourceFile]</mediafile>
        <mediaid>[MediaID]</mediaid>
        <mediastatus>Closed</mediastatus>
        <createdate>[Date]</createdate>
        <startdate>[Date]</startdate>
        <finishdate>[Date]</finishdate>
        <closeddate>[Date]</closeddate>
    </media>
    <media>
    <!-- ... -->
    </media>
</response>

{
    "response": {
        "media": [
            {
                "mediafile": "[SourceFile]",
                "mediaid": "[MediaID]",
                "mediastatus": "Closed",
                "createdate": "[Date]",
                "startdate": "[Date]",
                "finishdate": "[Date]",
                "closeddate": "[Date]"
            },
            {
                // media params
            }
        ]
    }
}

Parameter	Description
mediafile	Source file location
mediaid	Media ID
mediastatus	Media Status
createdate	Media creation date and time
startdate	Media start date and time
finishdate	Media encoding finish date and time
closeddate	Last media task close date and time

🚧
For closeddate parameter
Often <closeddate /> parameter represents the last upload file modified time. It may differ with the actual value of about 1 second.

[HLG High Dynamic Range Standard

Added support of HLG High Dynamic Range standard.

🚧
Note
HLG available only for hevc <video_codec />.

🚧
Note
HLG available only for mp4, mpegts, fmp4_hls, advanced_dash, and advanced_fmp4 output formats.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[mp4|mpegts]</output> <!-- required-->
        <hdr>[hlg|hlg-sdr-compat|hlg-non-sdr-compat]</hdr>
        <video_codec_parameters>
            <level>[Level]</level>
        </video_codec_parameters>
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[mp4|mpegts]", // required
            "hdr": "[hlg|hlg-sdr-compat|hlg-non-sdr-compat]",
            "video_codec_parameters": {
                "level": "[Level]"
            }
            // Format params
        }
    }
}

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[fmp4_hls|advanced_dash|advanced_fmp4]</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <stream>
            <hdr>[hlg|hlg-sdr-compat|hlg-non-sdr-compat]</hdr>
            <video_codec_parameters>
                <level>[Level]</level>
            </video_codec_parameters>
        </stream>
        <stream>
            <!-- stream params -->
        </stream>
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[fmp4_hls|advanced_dash|advanced_fmp4]", // required
            "destination": "[DestinationURL]", // required
            "stream": [
                {
                    "hdr": "[hlg|hlg-sdr-compat|hlg-non-sdr-compat]",
                    "video_codec_parameters": {
                        "level": "[Level]"
                    }
                },
                {
                    // stream params
                }
            ],
            "segment_template": "[number|time]"
            // Format params
        }
    }
}

Parameter	Description	Available Values	Default Value
Format Parameters
hdr	HDR mode	hlg* – default HLG mode. Transfer characteristics - 14 (BT.2020); alternative transfer characteristics - 18 (HLG). hlg-sdr-compat* – SDR compatible mode. Transfer characteristics - 1 (BT.709); alternative transfer characteristics - 18 (HLG). hlg-non-sdr-compat* – Non-SDR compatible mode. Transfer characteristics - 18 (HLG); alternative transfer characteristics - 18 (HLG).	none
VIdeo Codec Parameters
level	Video Level	Valid video level string	5.0

PCM Split Channels

Added option that allows to mux PCM audio channels into output as individual tracks

<?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>
            <split_channels>[yes|no]</split_channels>
            <!-- 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": [
                {
                    "split_channels": "[yes|no]"
                    // audio_stream params
                },
                {
                    // audio_stream params
                }
            ]
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Values
split_channels	Mux PCM audio stream channels into output as individual tracks.	yes, no	no