文档中心

视频剪辑完成事件

最近更新时间：2024.01.18 14:42:58

首次发布时间：2022.10.26 16:14:26

本文为您介绍视频剪辑完成事件的类型、说明、内容和回调示例等。

事件类型

VideoTrackComplete

事件说明

如果您的空间配置了视频剪辑完成回调通知，剪辑完成后您将收到事件回调通知，配置方法详见事件通知概述。关联接口提交编辑任务。

事件内容

参数	类型	描述
RequestId	String	请求的唯一 ID
Version	String	回调版本
EventType	String	回调事件为VideoTrackComplete
EventTime	String	事件产生的时间
Data	Data	视频具体信息

Data

参数	类型	描述
CallbackArgs	String	自定义回调信息
PosterUri	String	输出视频封面图
ReqId	String	编辑任务的请求 ID
SpaceName	String	返回资源存储的空间名称
Status	String	编辑状态。取值如下： Success：任务成功。 Failed：任务失败。
StoreUri	String	没有 Vid 类返回结果存储地址
FileName	String	文件路径
TaskId	String	计算任务 ID。与 `ReqId` 有区别。
Vid	String	输出视频 ID
PlayInfo	GetPlayInfoData	编辑成功后生成视频的播放信息
Message	String	任务信息。例如：当 `Status` 取值为 `Failed` 时，代表任务错误信息。
SubVid	Array of SubVidDetail	当任务输出有多个 Vid 时，比如分割任务；其余 Vid 元素列表，包括 Vid、封面图。

GetPlayInfoData

参数	类型	描述
Status	int64	编辑状态。取值如下： Success：任务成功； Failed：任务失败。
Vid	String	输出视频 ID
PosterUrl	String	输出视频封面图
Duration	float64	视频时长，单位为 s
PlayInfoList	Array of PlayInfoList	剪辑成功后生成视频的播放信息

PlayInfoList

参数	类型	描述
Codec	String	编码类型，取值如下： H264：H.264 hevc(H265)：HEVC（H.265） VP9：VP9 Audio：音频
Quality	String	音频质量，取值如下： medium：普通音质。 higher：高音质。 highest：音乐音质
Definition	String	视频分辨率。取值如下： 240P 360P 480P 540P 720P 1080P 2K 4K 8K
Format	String	视频编码
Duration	float64	视频时长，单位为 s
Width	int64	视频宽度，单位为 px
Height	int64	视频高度，单位为 px
Size	int64	文件大小，单位为 byte
Bitrate	int64	码率，单位为 bps
Logo	String	水印贴片
FileHash	String	文件 ID
MainPlayUrl	String	主播放地址
BackupPlayUrl	String	备用播放地址
LogoType	String	水印贴片标签
Md5	String	hash 值

SubVidDetail

参数	类型	描述
Vid	String	视频 ID
PosterUri	String	封面图

回调示例

在视频点播控制台，手动设置视频剪辑完成事件的回调设置。如下为回调完成的代码示例。

{
  "Data": {
    "CallbackArgs": "",
    "GroupId": "g0c3c00c***eu2lhrg",   //与视频剪辑工程相关
    "GroupName": "bcd",   //与视频剪辑工程相关
    "PosterUri": "tos-vod******6e07d42e688a0cc8e48ac210d",
    "ProjectId": "p0c4800cd***lpmlcpf7g",  //与视频剪辑工程相关
    "ProjectName": "test",    //与视频剪辑工程相关
    "ReqId": "e070c9be02***503ff7d0b4",
    "SpaceName": "test",
    "Status": "Success",
    "TaskId": "e070c9be***43b3e503ff7d0b4",
    "Vid": "v0cb0cg700***07q6rb8bd1470",
    "VideoName": "test-1025-11:34"
  },
  "EventTime": "2022-10-25 11:34:59.984432205 +0800 CST m=+95.115162976",
  "EventType": "VideoTrackComplete",
  "RequestId": "0216666688901550****0000ffff0ae1858a5b2625",
  "Version": "1.0"
}

您可以通过调用 OpenAPI 提交编辑任务，完成视频剪辑完成事件的回调设置。如下为回调完成的代码示例。

{
  "Data": {
    "CallbackArgs": "abc",
    "PosterUri": "tos-vod-******d4e320a842d5ac76078c1fa48f51",
    "ReqId": "e070c521d782***c8ddea1876",
    "SpaceName": "test",
    "Status": "Success",
    "StoreUri": "",
    "FileName": "",
    "TaskId": "2049:UhA***",
    "Vid": "v0c7b4g7***q6rb8bd1460"
  },
  "EventTime": "2022-10-25 11:12:13.502796743 +0800 CST m=+50034.619039680",
  "EventType": "VideoTrackComplete",
  "RequestId": "0216666674315******000ffff0ae1858ae05e61",
  "Version": "1.0"
}