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