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

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

注意事项

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

事件类型

ExecutionComplete

事件说明

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

事件内容

参数

类型

示例值

说明

RequestId

String

202405060***0CF1866

请求的唯一 ID

Version

String

1.0

回调版本

EventType

String

FileUploadComplete

事件名称

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

Input

-

媒体处理任务输入文件。

Meta

ExecutionMeta

-

媒资信息。

Control

RuntimeControl

-

任务控制信息。

Operation

Operation

-

媒体处理任务操作。

Output

Output

-

媒体处理任务输出文件。

Input

媒体处理任务输入文件

参数

类型

示例

描述

Type

Sting

DirectUrl

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

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

Vid

String

v0dc24***mu6g

视频 ID。

说明

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

DirectUrl

DirectUrl

-

DirectUrl 模式下的文件信息。

说明

仅当 Type 取值为 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：转码策略触发

RuntimeControl

任务控制

参数

类型

示例

描述

CallbackArgs

String

回调参数。

Priority

int32

1

媒体处理优先级，取值范围为 [-5,5]。

EnableLowPriority

Boolean

false

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

  • true：开启
  • false：关闭

Operation

处理类型

参数

类型

示例

描述

Type

String

Template

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

Template

OperationTemplate

-

媒体处理单模板类型。

OperationTemplate

媒体处理单模板类型

参数

类型

示例

描述

Type

String

TranscodeVideo

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

  • TranscodeVideo
  • ByteHD
  • TranscodeAudio
  • Enhance

TranscodeVideo

OperationTemplateTranscodeVideo

-

视频转码单模板任务。

说明

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

ByteHD

OperationTemplateByteHD

-

极智超清模板单模板任务。

说明

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

TranscodeAudio

OperationTemplateTranscodeAudio

-

音频转码单模板任务。

说明

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

Enhance

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

OutputTemplate

-

单模板任务输出。

OutputTemplate

单模板任务输出

参数

类型

示例

描述

Type

String

TranscodeVideo

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

  • TranscodeVideo
  • ByteHD
  • TranscodeAudio
  • Enhance

TranscodeVideo

VodTranscodeInfo

-

视频转码单模板任务输出。

说明

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

ByteHD

VodTranscodeInfo

-

极智超清模板单模板任务输出。

说明

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

TranscodeAudio

VodTranscodeInfo

-

音频转码单模板任务输出。

说明

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

Enhance

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

VideoStreamMeta

-

视频流信息。

AudioStreamMeta

AudioStreamMeta

-

音频流信息。

VideoStreamMeta

视频流元信息

参数

类型

示例值

描述

Codec

String

h265

视频编码格式。

Height

Integer

1080

视频高度，单位为 px。

Width

Integer

1920

视频宽度，单位为 px。

Duration

Float

10.04

视频时长，单位为 s。

Definition

String

2k

视频清晰度。

Bitrate

Integer

967525

视频码率，单位为 bps。

Fps

Float

25

帧率，单位为 fps。

AudioStreamMeta

音频流元信息

参数

类型

示例值

描述

Codec

String

aac

音频编码格式。

Duration

Float

10.027

音频时长，单位为 s。

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