21 September 2023

DolbyE Program ID for alternate sources

Added option to specify DolbyE Program ID for alternate sources of Advanced Multi-bitrate 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>[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]</output> <!-- required-->
        <destination>[DestFile]</destination> <!-- required-->
        <alternate_source>
            <program_id>[ProgramID]</program_id>
            <!-- alternate_source params -->
        </alternate_source>
        <alternate_source>
            <!-- alternate_source params -->
        </alternate_source>
        <!-- multiple alternate_sources 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
            "alternate_source": [
                {
                    "program_id": "[ProgramID]"
                    // alternate_source params
                },
                {
                    // alternate_source params
                }
                // multiple alternate_sources may be included
            ]
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
program_id	DolbyE program ID starting from 0	Non-negative integer number	none

Alternate source names without index

Added option to disable adding of index to the alternate sources segments of Advanced Multi-bitrate 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>[advanced_hls|advanced_dash|advanced_mss|fmp4_hls|advanced_fmp4]</output> <!-- required-->
        <destination>[DestFile]</destination> <!-- required-->
        <disable_alternate_source_index>[yes|no]</disable_alternate_source_index>
        <!-- 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
            "disable_alternate_source_index": "[yes|no]"
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
disable_alternate_source_index	Disable adding an alternate source index to the segment name	yes, no	no

Qualify progress in GetStatus response

Added new parameter to the GetStatus request for QC Qualify media

Request

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>GetStatus</action>
    <mediaid>[MediaID]</mediaid> <!-- required -->
    <add_qualify_progress>[yes|no]</add_qualify_progress>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "GetQCStatus",
        "mediaid": "[MediaID]", // required
        "add_qualify_progress": "[yes|no]"
    }
}

Parameter	Description	Allowed Values	Default Value
add_qualify_progress	Add Qualify Engine progress into response	yes, no	no

Response

<?xml version="1.0"?>
<response>
    <id>[MediaID]</id> <!-- Equals to qc_child_media_id in parent media GetStatus response -->
    <userid><<id>></userid>
    <!-- media status -->
    <status>[MediaStatus]</status>
    <progress_qualify>[QualifyEngineProgress]</progress_qualify>
    <!-- status fields -->
</response>

{
    "response": {
        "id": "[MediaID]", // Equals to qc_child_media_id in parent media GetStatus response
        "userid": "<<id>>",
        // media status
        "status": "[MediaStatus]",
        "progress_qualify": "[QualifyEngineProgress]"
        // status fields
    }
}