11 March 2021
about 3 years ago by Encoding.com Product Team #2
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 |