本文为您介绍媒体处理任务执行完成事件。
若处理的视频文件没有部分格式,那么您接收到的媒体处理任务回调就不会返回相应的参数。
ExecutionComplete
配置了媒体处理任务执行完成事件通知后,媒体处理任务执行完成时您将收到通知。配置方法详见事件通知概览。
参数 | 类型 | 示例值 | 是否必传 | 说明 |
---|---|---|---|---|
RequestId | String |
| 是 | 请求的唯一 ID |
Version | String |
| 是 | 回调版本 |
EventType | String |
| 是 | 事件名称 |
EventTime | String |
| 是 | 事件产生时间,UTC 时间,精度为秒 |
Data | Data |
| 是 | 回调内容,JSON 格式 |
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
RunId | String |
| 媒体处理任务执行 ID。 |
Status | String |
| 任务状态。取值如下:
|
Code | String |
| 任务错误码。具体取值如下:
说明 当 |
Input | Object of Input |
| 任务输入文件信息。 |
Meta | Object of ExecutionMeta |
| 任务元信息。 |
Control | Object of RuntimeControl |
| 任务控制配置。 |
Operation | Object of Operation |
| 媒体处理操作。 |
Output | Object of Output |
| 任务输出文件信息。 |
任务输入文件信息
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
Type | Sting |
| 输入文件类型。取值如下:
|
Vid | String |
| 视频 ID。 说明 仅当 |
DirectUrl | Object of DirectUrl |
| DirectUrl 模式下的文件信息。 说明 仅当 |
DirectUrl 模式下的文件信息
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
BucketName | String |
| 空间所绑定的存储桶名称。 |
FileName | String |
| 文件路径。 |
SpaceName | String |
| 点播空间名称。 |
任务元信息
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
SpaceName | String |
| 点播空间名称。 |
Trigger | String |
| 任务来源。取值如下:
|
CreateTime | String | 2025-01-14T09:13:06Z | 任务创建时间。遵循 RFC3339 格式的东八区(UTC+8)时间,精度为秒。 |
StartTime | String | 2025-01-14T09:13:07Z | 任务开始时间。遵循 RFC3339 格式的东八区(UTC+8)时间,精度为秒。 |
EndTime | String | 2025-01-14T09:17:35Z | 任务结束时间。遵循 RFC3339 格式的东八区(UTC+8)时间,精度为秒。 |
任务控制配置
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
CallbackArgs | String |
| 您在提交媒体处理任务时设置的自定义信息。仅当您在提交媒体处理任务时设置了 |
Priority | Int32 |
| 任务优先级。默认值为 0。取值范围为 [-5,5]。数字越小,优先级越高。 |
EnableLowPriority | Boolean |
| 是否开启闲时任务。取值如下:
|
媒体处理操作。
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
Type | String |
| 处理类型。目前仅支持 |
Template | Object of OperationTemplate |
| 模板任务配置。当 |
媒体处理单模板类型
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
Type | String |
| 单模板任务类型。取值如下:
|
TranscodeVideo | Object of OperationTemplateTranscodeVideo |
| 视频转码模板任务配置。仅当 |
ByteHD | Object of OperationTemplateByteHD |
| 极智超清模板任务配置。仅当 |
TranscodeAudio | Object of OperationTemplateTranscodeAudio |
| 音频转码模板任务配置。仅当 |
Enhance | Object of OperationTemplateEnhance |
| 画质增强模板任务配置。仅当 |
视频转码模板任务配置
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
TemplateId | String |
| 视频转码模板 ID。 |
WatermarkTemplateId | String |
| 水印模板 ID。 |
极智超清模板任务配置
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
TemplateId | String |
| 极智超清模板 ID。 |
WatermarkTemplateId | String |
| 水印模板 ID。 |
音频转码模板任务配置
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
TemplateId | String |
| 音频转码模板 ID。 |
画质增强模板任务配置
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
TemplateId | String |
| 画质增强模板 ID。 |
任务输出文件信息
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
Type | String |
| 输出类型。目前仅支持 |
Template | Object of OutputTemplate |
| 单模板任务输出结果。 |
单模板任务输出结果
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
Type | String |
| 单模板任务类型。取值如下:
|
TranscodeVideo | Object of VodTranscodeInfo |
| 视频转码模板任务输出。仅当 |
ByteHD | Object of VodTranscodeInfo |
| 极智超清模板任务输出。仅当 |
TranscodeAudio | Object of VodTranscodeInfo |
| 音频转码模板任务输出。仅当 |
Enhance | Object of VodTranscodeInfo |
| 画质增强模板任务输出。仅当 |
媒体处理产物信息
参数 | 类型 | 示例 | 描述 |
---|---|---|---|
FileId | String |
| 文件 ID。 |
Md5 | String |
| 文件哈希。 |
FileType | String |
| 文件类型。取值如下:
|
LogoType | String |
| 水印贴片标签。即您在视频点播控制台创建水印贴片模板时配置的自定义水印贴片标签,详见水印贴片模板。 |
Encrypt | Boolean |
| 是否加密。取值如下:
|
Format | String |
| 编码格式。取值如下:
|
Size | Integer |
| 文件大小,单位为字节。 |
Duration | Float |
| 转码流时长,单位为秒。 |
StoreUri | String |
| 文件存储地址。 |
DynamicRange | String |
| 动态范围。取值如下:
|
TosStorageClass | String |
| 媒资存储类型。取值如下:
|
CreateTime | String |
| 文件创建时间。 |
VideoStreamMeta | Object of VideoStreamMeta |
| 视频流信息。 |
AudioStreamMeta | Object of AudioStreamMeta |
| 音频流信息。 |
视频流元信息
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Codec | String |
| 视频编码格式。 |
Height | Integer |
| 视频高度,单位为 px。 |
Width | Integer |
| 视频宽度,单位为 px。 |
Duration | Float |
| 视频时长,单位为秒。 |
Definition | String |
| 视频清晰度。 |
Bitrate | Integer |
| 视频码率,单位为 bps。 |
Fps | Float |
| 帧率,单位为 fps。 |
音频流元信息
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Codec | String |
| 音频编码格式。 |
Duration | Float |
| 音频时长,单位为秒。 |
SampleRate | Integer |
| 音频采样率。 |
Bitrate | Integer |
| 音频码率,单位为 bps。 |
Quality | String |
| 音频质量。取值如下:
|
{ "Data":{ "Input":{ "DirectUrl":{ "BucketName":"tos-vod--v-3640747e9e4afe41", "FileName":"94d97c9f03***f34a93165a4ff", "SpaceName":"test" }, "Type":"DirectUrl" }, "Meta":{ "SpaceName":"test", "Trigger":"API" }, "Operation":{ "Template":{ "TranscodeVideo":{ "TemplateId":"ddc7d66386b***e4fb2071bb6056a" }, "Type":"TranscodeVideo" }, "Type":"Template" }, "Output":{ "Template":{ "TranscodeVideo":{ "AudioStreamMeta":{ "Bitrate":128989, "Codec":"aac", "Duration":10.027, "Quality":"higher", "SampleRate":44100 }, "CreateTime":"2024-06-04 17:17:55", "Duration":10.04, "DynamicRange":"SDR", "Encrypt":true, "FileId":"674107521e***490069228d500548c", "FileType":"Video", "Format":"HLS", "Md5":"4d4ad573234e***bff46803b23e", "Size":1449027, "StoreUri":"tos-vod--v-3640747e9e4afe41/752ac7b3***049b25224eafcc76b28/main.m3u8", "TosStorageClass":"STANDARD", "VideoStreamMeta":{ "Bitrate":967525, "Codec":"h265", "Definition":"2k", "Duration":10.04, "Fps":25, "Height":1080, "Width":1920 } }, "Type":"TranscodeVideo" }, "Type":"Template" }, "RunId":"lb:75d9a9d137a***4301d7fd91f3262fd", "Status":"Success" }, "EventTime":"2024-06-04T09:17:55Z", "EventType":"ExecutionComplete", "RequestId":"2024060417***D2F812BACCB228AC3", "Version":"1.0" }