一、综述
云点播支持以下几种事件通知:
| 归类 | 事件通知 |
| 上传删除类 | 视频上传完成 |
| | URL 拉取视频上传完成 |
| | 视频删除完成 |
| | 视频取回完成 |
| 视频处理类 | 任务流状态变更 |
| | 视频编辑完成 |
| | 视频合成完成 |
| | 视频拆分完成 |
| | 微信小程序发布完成 |
| | 画质重生完成 |
| | 音视频审核完成 |
| | 智能去除水印完成 |
| | 提取溯源水印完成 |
| | 获取文件属性完成 |
事件通知方式分为“普通回调”和“可靠回调”,你可以登录 云点播控制台 设置回调模式,选择你需要接收回调的事件,具体操作请参见 回调设置。
·普通回调:在控制台上配置一个回调 URL,系统在事件完成后向该 URL 发送 HTTP 请求,请求体中包含通知内容。
·可靠回调:在事件完成后,云点播系统将通知内容放入内置的队列,App 服务通过服务端 API 消费队列中的通知。
二、普通回调
普通回调是 App 服务被动接收事件通知的模式。配置回调 URL 并选择普通回调模式后,云点播会在事件完成后,向回调 URL 发起回调。
云点播发起的普通回调的形式是 HTTP 请求,请求体为 JSON 格式,内容为不含 EventHandle 参数的 EventContent 结构。
以 任务状态变更通知 为例,回调中的 EventType 参数为 ProcedureStateChanged,信息由 ProcedureStateChangeEvent 参数表示(ProcedureTask 结构)。
如果因为网络等原因,App 服务没有收到回调,腾讯云将连续重发回调。因为存在重发后 App 服务依然没有收到回调的可能,推荐使用可靠性更高的“可靠回调”模式。
三、可靠回调
可靠回调是 App 服务主动向云点播拉取事件通知的模式。选择可靠回调模式后,云点播系统将把事件通知放入队列中,App 服务通过服务端 API 从队列中依次消费事件通知。
App 服务通过 拉取事件通知 API 获取消息后,需要调用 确认事件通知 API 进行确认。消息必须被确认之后,才会从云点播中的队列中删除,所以“可靠回调”的可靠性高于“普通回调”。如果对事件通知的可靠性要求高,建议使用“可靠回调”模式。