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