对云点播中的视频发起的上传、删除、视频处理等操作,都可以被称为一个事件。事件的执行需要一段时间才能完成,云点播在事件结束时,会立即通知 App 服务操作的执行结果,即事件通知。
云点播支持以下几种事件通知:
普通回调:在控制台上配置一个回调 URL,系统在事件完成后向该 URL 发送 HTTP 请求,请求体中包含通知内容。
可靠回调:在事件完成后,云点播系统将通知内容放入内置的队列,App 服务通过服务端 API 消费队列中的通知。
普通回调
普通回调是 App 服务被动接收事件通知的模式。配置回调 URL 并选择普通回调模式后,云点播会在事件完成后,向回调 URL 发起回调。
云点播发起的普通回调的形式是 HTTP 请求,请求体为 JSON 格式,内容为不含 EventHandle 参数的 EventContent 结构。
以 任务状态变更通知 为例,回调中的
EventType
参数为 ProcedureStateChanged
,信息由 ProcedureStateChangeEvent
参数表示(ProcedureTask 结构)。如果因为网络等原因,App 服务没有收到回调,腾讯云将连续重发回调。因为存在重发后 App 服务依然没有收到回调的可能,推荐使用可靠性更高的“可靠回调”模式。