有奖捉虫:云通信与企业服务文档专题,速来> HOT
云直播提供直播回调功能,支持通过控制台配置回调模板,针对各触发事件设置接收相关回调信息的路径。并在推流域名下进行模板关联。关联成功后,当直播过程中根据所配置模板事件触发回调功能,腾讯云主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后事件对应路径即可获取回调信息的 JSON 数据包。 本文将向您介绍如何通过控制台创建、修改及删除回调配置模板。
其中,创建回调配置模板有以下两种方式:
通过云直播控制台创建模板,具体操作步骤请参见 创建回调模板
通过 API 创建模板,具体参数及示例说明请参见 创建回调模板

注意事项

创建成功后,还需到对应的推流域名下关联 回调配置,关联成功后约5分钟 - 10分钟生效。
回调配置中,用于接收回调事件的回调地址 httphttps 服务器必须能正常收到响应。
控制台的回调模板管理为域名维度,暂时无法取消关联接口创建的规则,如果是通过直播回调相关接口关联指定流的,则需要通过调用 删除回调规则 解除关联。
直播回调相关协议,请参见 事件消息通知协议
直播回调消息通知参数说明,具体请参见:

创建回调模板

1. 登录 云直播控制台
2. 在左侧菜单栏选择功能配置 > 直播回调
3. 单击创建模板,在直播回调新建模板中填写回调信息,选择回调类型并填写回调地址,可多选。单击保存即可。


配置项
说明
模板名称
回调模板名称,仅支持填写中文、英文、数字、_、-,不超过30个字符。
模板描述
回调模板描述信息,仅支持中文、英文、数字、空格、_、-,不超过100个字符。
回调密钥
自定义回调密钥。字符由大小写字母及数字组成的,最多32个字符。相关使用请参见 事件消息通知公共参数
推流回调
填写用来接收推流回调事件的路径,可支持协议头:HTTP、HTTPS 等。
断流回调
填写用来接收断流回调事件的路径,可支持协议头:HTTP、HTTPS 等。
录制文件回调
填写用来接收录制文件回调事件的路径,可支持协议头:HTTP、HTTPS 等。
录制状态回调
填写用来接收录制状态回调事件的路径,可支持协议头:HTTP、HTTPS 等。
截图回调
填写用来接收截图回调事件的路径,可支持协议头:HTTP、HTTPS 等。
图片审核回调
填写用来接收图片审核回调事件的路径,可支持协议头:HTTP、HTTPS 等。
音频审核回调
填写用来接收音频审核回调事件的路径,可支持协议头:HTTP、HTTPS 等。
推流异常事件回调
填写用来接收推流异常事件回调的路径,可支持协议头:HTTP、HTTPS 等。

关联域名

1. 登录云直播控制台,进入功能配置 > 直播回调
2. 通过以下方式进入域名绑定窗口:
直接关联域名:单击左上方的绑定域名



新回调模板创建成功后关联域名回调模板创建 成功后,单击提醒框中的去绑定域名


3. 在域名绑定窗口中,选择您需绑定的回调模板推流域名,单击确定即可绑定成功。



说明
支持通过单击添加为当前模板绑定多个播放域名。

解除绑定

1. 登录云直播控制台,进入功能配置 > 直播回调
2. 选择已关联域名的回调模板,单击解绑



3. 确认是否解绑当前关联域名,单击确定即可解绑。




修改模板

1. 登录云直播控制台,进入功能配置 > 直播回调
2. 选择您已创建成功的回调模板,并单击右侧的编辑,即可进入修改模板信息。



3. 单击保存即可。

删除模板

注意:
若模板已被关联,需要先解除绑定,才可以进行删除操作。
删除模板后将无法恢复,请谨慎操作。
1. 登录云直播控制台,进入功能配置 > 直播回调
2. 选择您已创建成功的回调模板,单击右侧的删除



3. 确认是否删除当前回调配置模板,单击确定即可成功删除。




相关操作

域名维度绑定和解绑回调模板的具体操作及相关说明,请参见 回调配置