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