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