视频剪辑完成事件--视频点播-火山引擎

文档中心

立即注册

导航

视频剪辑完成事件

最近更新时间：2024.09.24 15:22:01首次发布时间：2022.10.26 16:14:26

本文为您介绍视频剪辑完成事件。

事件类型

VideoTrackComplete

事件说明

配置了视频剪辑完成事件通知后，剪辑完成时您将收到通知。配置方法详见事件通知概览。

事件内容

参数	类型	示例值	说明
RequestId	String	`202405060***0CF1866`	请求的唯一 ID
Version	String	`1.0`	回调版本
EventType	String	`FileUploadComplete`	事件名称
EventTime	String	`2024-05-06T09:49:33Z`	事件产生时间，UTC 时间，精度为秒。
Data	Data	`-`	回调内容，JSON 格式。

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	视频时长，单位为秒
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	视频时长，单位为秒
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	文件 MD5 值

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

您可以通过调用 SubmitDirectEditTaskAsync 接口完成视频剪辑完成事件的回调设置。如下为回调完成的代码示例。

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