本文提供事件通知的功能介绍、回调设置和机制以及对应的事件列表。
视频点播中的各种操作,例如视频上传完成、工作流执行完成等,都可以称为一个事件。由于这些任务都需要一定的时间来完成,为了确保在任务完成后能及时通知您,视频点播提供回调事件通知功能。当一个事件完成后,视频点播会向您发送一条回调消息,以便您能够及时进行下一步的业务处理。视频点播目前支持 HTTP 回调,是指您被动接收视频点播服务事件通知的模式。您可以以空间的粒度来配置回调事件通知功能。
您需要部署一个 HTTP/HTTPS 服务来接收回调消息,并在视频点播控制台中配置回调地址。视频点播的回调机制具体如下:
视频点播支持的事件类型如下表所示:
事件名称 | 事件类型 |
---|---|
媒资上传完成 | |
URL 批量拉取上传完成 | |
素材上传完成 | |
媒资上传提取元信息完成 | |
媒资删除完成 | |
素材文件删除完成 | |
媒体处理产物删除完成 | |
工作流执行完成 | |
媒体处理任务执行完成 | |
视频剪辑完成 | |
媒资存储类型修改完成 | |
文件同步完成 | |
DirectUrl 模式媒资上传完成 | |
AI 翻译任务执行完成事件 |
为确保事件通知能够持续演进并实现功能扩展,事件内容中的结构体在未来可能新增字段。为避免新增字段对您的系统造成影响,建议您在实现事件通知时遵循以下解析和编码规范。
Record<string, any>
"additionalProperties": false
,否则未来新增字段将导致验证失败。操作 | 可能造成的问题 |
---|---|
严格绑定字段到类/对象模型 | 未定义字段将引发解析错误 |
使用强类型校验库(如 zod)默认模式 | 默认拒绝多余字段 |
JSON Schema 设置 | 拒绝任何新增字段 |
推荐配置:
ObjectMapper mapper = new ObjectMapper(); // 忽略未知字段,避免接口变更引发错误 mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);