事件通知综述

最近更新时间:2023-07-12 14:23:22

我的收藏
在智能创作用户端或者使用服务端 API 进行视频上传、媒体移动、媒体删除等操作,都被称为一个事件。事件执行完成后,会立即通知 App 服务操作的执行结果,即事件通知。

回调方式

目前智能创作只支持 App 服务被动接收事件通知的模式。配置回调 URL 及通知事件类型后,智能创作会在事件完成后,向回调 URL 发起回调。
智能创作发起的回调的形式是 HTTP 请求,请求体为 JSON 格式,请求方法为 POST,内容包含 EventContent 结构。 以 新文件产生事件通知 为例,回调中的 EventType 参数为 Storage.NewFileCreated,事件内容为 StorageNewFileCreatedEvent 。完整的事件回调请求示例如下:
POST /callback HTTP1.1
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh-CN,zh;q=0.9,en;q=0.8
Cache-Control: no-cache
Connection: close
Content-Length: 415
Content-Type: application/json
Host: api.example.com

{
"EventType":"Storage.NewFileCreated",
"Operator":"user_id_12988300030300329",
"StorageNewFileCreatedEvent":{
"FileId":"528589*****73533167",
"MaterialId":"5fdafac******0001c82b2e",
"OperationType":"Upload",
"Owner":{
"Id":"user_id_12988300030300329",
"Type":"PESRON"
},
"ClassPath":"/媒资",
"TaskId":"",
"SourceContext":""
}
}

事件类型

智能创作支持以下几种事件通知:
归类
事件通知
事件触发时机
媒体变更类
新文件产生事件,触发的场景包括:上传,在用户端主动上传媒体文件到媒资库拉取上传,用户在网盘使用媒体转拉功能上传媒体编辑合成直播流剪辑直播流录制
将媒体导入到个人、团队或者项目中
媒体添加事件,触发的场景有:将媒资库中已有的媒体文件添加到个人/团队媒资库,或者项目中,包括创建链接复制媒体(仅限复制媒体,复制目录导致的媒体增加不会产生该事件)
移动媒体(仅限媒体移动,移动目录导致的媒体移动不会产生该事件)
媒体修改,仅限修改媒体的名称,预置标签及自定义标签产生该事件
媒体删除事件,触发的场景包括:删除媒资库中已有的媒体文件删除项目等导致的媒体文件删除
分类变更类
新建分类
移动分类到另一个分类下
删除分类路径
项目状态变更类
云转推项目状态变更,目前仅支持转推开始及转推结束通知
导播台项目状态变更通知,触发的场景有:导播台启动导播台停止导播台 PVW 开启导播台 PGM 开启,输出推流开始导播台 PVW 停止导播台 PGM 停止,输出推流结束导播台被回收,需要恢复才能使用
视频导出类

开通事件回调

目前还无法自助开通事件回调。如需开通,请准备好事件通知地址 URL 及事件通知类型提 工单,由智能创作工作人员配置开通。