22 December 2022

Preserve dialnorm value from the source file

Added option to preserve dialnorm value from the media source file.

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required-->
    <userkey>KEY</userkey> <!-- required-->
    <action>[Action]</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <audio_codec>eac3</audio_codec>
        <input_dialnorm>[DialnormValue]</input_dialnorm>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[output]", // required
            "audio_codec": "eac3",
            "input_dialnorm": "[DialnormValue]"
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
input_dialnorm	Specify the dialnorm value for Dolby Media Generator. Set it to copy to preserve dialnorm value from source file. Should be used when the input dialnorm is already measured. Can’t be used with audio_normalization option.	• float number between -31 and -1 • copy	none

Support of dnxhd video codec for mxf_op1a

Added support of dnxhd video codec for mxf_op1a output format

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required-->
    <userkey>KEY</userkey> <!-- required-->
    <action>AddMedia</action>
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <video_codec>[VideoCodec]</video_codec>
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "AddMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "video_codec": "[VideoCodec]"
            // format params
        }
    }
}

Parameter	Description	Allowed Values	Default Value
video_codec	Defines the codec used for your output.	mxf_op1a*: mpeg2video, libx264, xdcamhd422, dvcpro, dvcpro50, dvcprohd, imx30, xdcam, dnxhd, copy	mxf_op1a*: mpeg2video

QC start notification

Added new media notification for QC processing start

<?xml version="1.0"?>
<query>
    <userid>ID</userid> <!-- required -->
    <userkey>KEY</userkey> <!-- required -->
    <action>[Action]</action> <!-- required -->
    <source>[SourceFile]</source> <!-- required -->
    <qc_start_notify>[QCStartNotifyURL]</qc_start_notify>
    <format> <!-- required -->
        <!-- format params -->
    </format> 
</query>

{
    "query": {
        "userid": "ID", // required
        "userkey": "KEY", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "qc_start_notify": "[QCStartNotifyURL]",
        "format": [ // required
             {
                 // format params
             }
        ]
    }
}

Parameter	Description	Allowed Values	Default Value
qc_start_notify	Notify when QC processing started for each output format.	• Valid URL • Email • SNS URI	none

Notify Response Format

<?xml version="1.0"?>
<response>
    <format>
        <mediaID>[MediaID]</mediaID>
        <status>[QCStatus]</status>
        <parentMediaID>[ParentMediaID]</parentMediaID> <!-- present for QC child  media -->
        <parentTaskID>[ParentTaskID]</parentTaskID> <!-- present for QC child  media -->
        <report>[ReportURL]</report>
    </format>
    <meta>[MediaMeta]</meta> <!-- Only present if media metadata was sent -->
</response>

{
    "response": {
        "format": {
            "mediaID": "[MediaID]",
            "status": "[QCStatus]",
            "parentMediaID": "[ParentMediaID]", // present for QC child  media
            "parentTaskID": "[ParentTaskID]", // present for QC child  media
            "report": "[ReportURL]"
        },
        "meta": "[MediaMeta]" // Only present if media metadata was sent
    }
}

Parameter	Description
mediaID	A unique identifier assigned to each new media.
status	The status of QC Processing Started* – QC is started. Transcoding* – QC not started since transcoding job is not finished. Validating* – QC is in progress. Passed* – QC sucessfully finished. All tests passed. Quarantined* – Some QC Tests failed and output was sent to quarantine destination. Failed* – Critical QC Tests failed. Stopped* – QC process was suddenly stopped due to error.
parentMediaID	A unique identifier of the parent media.
parentTaskID	A unique identifier of the parent media output format.
report	QC report URL