综述
云点播中对视频发起的上传、删除、视频处理等操作，都可以被称为一个事件。由于云点播的转码、截图等操作属于算力密集型服务，执行任务需要一定的时间。因此在发起一个事件后，用户无法在第一时间获得任务结果，需要在事件结束后，通过回调通知的方式告知执行结果，即为事件通知。
事件通知类型
在点播模式下，云点播支持以下几种事件通知：
| 通知类型 | 说明 | 适用模式 | 相关链接 |
|---|---|---|---|
| 音视频转码完成 | 视频转码任务完成时，触发该事件。 | 点播模式 | 音视频转码完成-点播模式 |
| 审核完成 | 视频审核任务完成时，触发该事件。 | 点播模式 | 审核完成-点播模式 |
| 视频截图完成 | 视频截图完成完成时，触发该事件。 | 点播模式 | 视频截图完成-点播模式 |
| 视频拼接完成 | 视频拼接完成完成时，触发该事件。 | 点播模式 | 视频拼接完成-点播模式 |
| 媒资信息变更（点播模式） | 当一个视频条目的媒资信息发生变更时，触发该事件。 | 点播模式 | 媒资信息变更-点播模式 |
| 视频上传完成（点播模式） | 当成功向【媒体库】上传一个媒体文件生成一个视频条目时，触发该事件。 | 点播模式 | 视频上传完成-点播模式 |
| 媒资删除完成 （点播模式） | 当从【媒体库】删除一个视频条目时，触发该事件。 | 点播模式 | 媒资删除完成-点播模式 |
事件通知配置方式
- 全局回调。当配置了全局回调后，云点播发生任意触发事件时，均会根据全局回调的配置发送回调信息。具体配置方式可参考下面章节【全局回调】。
- SDK/API回调。当用户在创建转码任务时，可通过SDK/API配置相应的回调入口，以便仅接收本次转码的回调信息。
当用户同时配置多种事件回调时，具体任务触发将依据SDK/API回调 > 全局回调的优先级选择合适的配置发送回调。
全局回调
前提条件
- 已开通云点播产品。
- 已开通至少一个点播区域。
操作步骤
进入云点播控制台，选择左侧导航栏的【开发配置】–【全局回调】可打开回调设置页面。点击【修改设置】按钮，可对回调方式进行设置。
列表中展示各字段说明
| 配置项 | 取值样例 | 说明 |
|---|---|---|
| 全局回调 | 全局回调配置的总开关。 | |
| 回调URL | http://callback.ctyun.cn/callback | 用于接收回调通知的服务地址。 |
| 鉴权校验 | 是否开启回调鉴权。 | |
| 回调事件 | 可以接收的回调事件类型。在【点播模式】下，适用的事件通知请参考上文【综述】部分。 |
注意回调鉴权需要的AK/SK请通过【开发配置】-【密钥管理】-【回调密钥】入口获得。该AK/SK仅用于回调事件的鉴权，且采用了V4签名方式。具体鉴权算法可参考云点播SDK API使用指南【托管模式】-【回调通知】。
SDK/API回调
具体配置方法可参考提交转码任务。
重新发起回调
前提条件
- 已开通云点播产品。
- 已开通至少一个点播区域。
- 已发起一个转码（拼接）任务，且该任务在发起前通过任意配置入口设置了合法的回调接收地址。
操作步骤
登录云点播控制台，点击左侧导航栏的【任务管理】-【转码任务】（或【拼接任务】），在【点播模式】的标签页找到需要重新发起回调的任务。在该任务的操作栏点击【回调重试】即可重新发起回调。
如本次重试回调失败，您可以在【回调状态】栏点击叹号图标，查看由回调接收服务返回的响应信息。请注意，本功能仅在当前页面发起重试时有效。如您在发起重试以后关闭当前页面，则无法再返回本次回调的调试信息。请在发起调测时保持该页面开启。
