You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/开发指南/事件通知/事件列表/媒体处理任务执行完成事件
媒体处理任务执行完成事件
最近更新时间：2025.02.08 11:45:59首次发布时间：2024.06.28 19:34:16
我的收藏

本文为您介绍媒体处理任务执行完成事件。

注意事项

若处理的视频文件没有部分格式，那么您接收到的媒体处理任务回调就不会返回相应的参数。

事件类型

ExecutionComplete

事件说明

配置了媒体处理任务执行完成事件通知后，媒体处理任务执行完成时您将收到通知。配置方法详见事件通知概览。

事件内容

参数

类型

示例值

是否必传

说明

RequestId

String

202405060***0CF1866

是

请求的唯一 ID

Version

String

1.0

是

回调版本

EventType

String

ExecutionComplete

是

事件名称

EventTime

String

2024-05-06T09:49:33Z

是

事件产生时间，UTC 时间，精度为秒

Data

Data

-

是

回调内容，JSON 格式

Execution

参数

类型

示例

描述

RunId

String

lb:75d9a9d137***1f3262fd

媒体处理任务执行 ID。

Status

String

Success

任务状态。取值如下：

  • Success：任务成功
  • Failed：任务失败
  • PendingStart：任务排队中
  • Running：任务执行中
  • Terminated：任务被终止

Code

String

InvalidParameter.InvalidMediaStream

任务错误码。具体取值如下：

  • InvalidParameter.InvalidMediaStream：解析音视频流失败
  • InvalidParameter.MissingMediaStream：缺少音视频流
  • InvalidParameter.InvalidUriError：用户地址非法
  • InvalidParameter.MissingSubtitleStream：缺少字幕流
  • InvalidParameter.InvalidParam：参数错误
  • InvalidParameter.InvalidVidOrUri：输入源不存在
  • InternalError：内部错误
  • InternalError.DownloadError：系统下载错误
  • InternalError.UploadError：系统上传错误
  • InternalError.ExecutionTimeout：执行超时

说明

当 Status 参数取值为 Failed 时，该 Code 参数返回具体任务错误码。

Input

Object of Input

-

任务输入文件信息。

Meta

Object of ExecutionMeta

-

任务元信息。

Control

Object of RuntimeControl

-

任务控制配置。

Operation

Object of Operation

-

媒体处理操作。

Output

Object of Output

-

任务输出文件信息。

Input

任务输入文件信息

参数

类型

示例

描述

Type

Sting

DirectUrl

输入文件类型。取值如下：

  • Vid：Vid 模式。
  • DirectUrl：DirectUrl 模式。

Vid

String

v0dc24***mu6g

视频 ID。

说明

仅当 Type 取值为 Vid 时，返回该参数。

DirectUrl

Object of DirectUrl

-

DirectUrl 模式下的文件信息。

说明

仅当 Type 取值为 DirectUrl 时，返回该参数。

DirectUrl

DirectUrl 模式下的文件信息

参数

类型

示例

描述

BucketName

String

tos-vod--v-36***41

空间所绑定的存储桶名称。

FileName

String

94d97***165a4ff

文件路径。

SpaceName

String

test

点播空间名称。

ExecutionMeta

任务元信息

参数

类型

示例

描述

SpaceName

String

test

点播空间名称。

Trigger

String

API

任务来源。取值如下：

  • API：调用接口触发
  • AutoTrigger：上传自动触发
  • TranscodeStrategy：转码策略触发

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）时间，精度为秒。

RuntimeControl

任务控制配置

参数

类型

示例

描述

CallbackArgs

String

Example

您在提交媒体处理任务时设置的自定义信息。仅当您在提交媒体处理任务时设置了 CallbackArgs 参数时返回。

Priority

Int32

1

任务优先级。默认值为 0。取值范围为 [-5,5]。数字越小，优先级越高。

EnableLowPriority

Boolean

false

是否开启闲时任务。取值如下：

  • true：开启
  • false：关闭

Operation

媒体处理操作。

参数

类型

示例

描述

Type

String

Template

处理类型。目前仅支持 Template（单模板任务）。

Template

Object of OperationTemplate

-

模板任务配置。当 Type 为 Template 时返回该参数。

OperationTemplate

媒体处理单模板类型

参数

类型

示例

描述

Type

String

TranscodeVideo

单模板任务类型。取值如下：

  • TranscodeVideo：视频转码模板任务。
  • ByteHD：极智超清模板任务。
  • TranscodeAudio：音频转码模板任务。
  • Enhance：画质增强模板任务。

TranscodeVideo

Object of OperationTemplateTranscodeVideo

-

视频转码模板任务配置。仅当 Type 取值为 TranscodeVideo 时，返回该参数。

ByteHD

Object of OperationTemplateByteHD

-

极智超清模板任务配置。仅当 Type 取值为 ByteHD 时，返回该参数。

TranscodeAudio

Object of OperationTemplateTranscodeAudio

-

音频转码模板任务配置。仅当 Type 取值为 TranscodeAudio 时，返回该参数。

Enhance

Object of OperationTemplateEnhance

-

画质增强模板任务配置。仅当 Type 取值为 Enhance 时，返回该参数。

OperationTemplateTranscodeVideo

视频转码模板任务配置

参数

类型

示例

描述

TemplateId

String

ddc7d66386***6056a

视频转码模板 ID。

WatermarkTemplateId

String

v0dc24g10***c1cepmu6g

水印模板 ID。

OperationTemplateByteHD

极智超清模板任务配置

参数

类型

示例

描述

TemplateId

String

ddc66386***6056a

极智超清模板 ID。

WatermarkTemplateId

String

v0dc24g10***c1cepmu6g

水印模板 ID。

OperationTemplateTranscodeAudio

音频转码模板任务配置

参数

类型

示例

描述

TemplateId

String

ddc76386***6056a

音频转码模板 ID。

OperationTemplateEnhance

画质增强模板任务配置

参数

类型

示例

描述

TemplateId

String

ddc7d66386***56a

画质增强模板 ID。

Output

任务输出文件信息

参数

类型

示例

描述

Type

String

Template

输出类型。目前仅支持 Template，表示单模板任务输出。

Template

Object of OutputTemplate

-

单模板任务输出结果。

OutputTemplate

单模板任务输出结果

参数

类型

示例

描述

Type

String

TranscodeVideo

单模板任务类型。取值如下：

  • TranscodeVideo：视频转码模板任务。
  • ByteHD：极智超清模板任务。
  • TranscodeAudio：音频转码模板任务。
  • Enhance：画质增强模板任务。

TranscodeVideo

Object of VodTranscodeInfo

-

视频转码模板任务输出。仅当 Type 取值为 TranscodeVideo 时，返回该参数。

ByteHD

Object of VodTranscodeInfo

-

极智超清模板任务输出。仅当 Type 取值为 ByteHD 时，返回该参数。

TranscodeAudio

Object of VodTranscodeInfo

-

音频转码模板任务输出。仅当 Type 取值为 TranscodeAudio 时，返回该参数。

Enhance

Object of VodTranscodeInfo

-

画质增强模板任务输出。仅当 Type 取值为 Enhance 时，返回该参数。

VodTranscodeInfo

媒体处理产物信息

参数

类型

示例

描述

FileId

String

67410***500548c

文件 ID。

Md5

String

4d4a***803b23e

文件哈希。

FileType

String

video

文件类型。取值如下：

  • video：视频。
  • audio：音频。

LogoType

String

aa

水印贴片标签。即您在视频点播控制台创建水印贴片模板时配置的自定义水印贴片标签，详见水印贴片模板。

Encrypt

Boolean

true

是否加密。取值如下：

  • true：加密。
  • false：不加密。

Format

String

HLS

编码格式。取值如下：

  • 视频转码：MP4、Dash、HLS、FLV、TS
  • 音频转码：MP3、M4A、MP4、Dash、HLS、OGG

Size

Integer

1449027

文件大小，单位为字节。

Duration

Float

10.04

转码流时长，单位为秒。

StoreUri

String

tos-vod--v-3***b28/main.m3u8

文件存储地址。

DynamicRange

String

SDR

动态范围。取值如下：

  • HDR：高动态范围
  • SDR：标准动态范围

TosStorageClass

String

STANDARD

媒资存储类型。取值如下：

  • STANDARD：标准存储
  • ARCHIVE：归档存储
  • IA：低频存储

CreateTime

String

2024-06-04 17:17:55

文件创建时间。

VideoStreamMeta

Object of VideoStreamMeta

-

视频流信息。

AudioStreamMeta

Object of AudioStreamMeta

-

音频流信息。

VideoStreamMeta

视频流元信息

参数

类型

示例值

描述

Codec

String

h265

视频编码格式。

Height

Integer

1080

视频高度，单位为 px。

Width

Integer

1920

视频宽度，单位为 px。

Duration

Float

10.04

视频时长，单位为秒。

Definition

String

2k

视频清晰度。

Bitrate

Integer

967525

视频码率，单位为 bps。

Fps

Float

25

帧率，单位为 fps。

AudioStreamMeta

音频流元信息

参数

类型

示例值

描述

Codec

String

aac

音频编码格式。

Duration

Float

10.027

音频时长，单位为秒。

SampleRate

Integer

44100

音频采样率。

Bitrate

Integer

128989

音频码率，单位为 bps。

Quality

String

higher

音频质量。取值如下：

  • higher：高音质。
  • highest：音乐音质。
  • medium：普通音质。

回调示例

{
   "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"
}