云直播提供直播回调功能,支持通过控制台配置回调模板,针对各触发事件设置接收相关回调信息的路径。并在推流域名下进行模板关联。关联成功后,当直播过程中根据所配置模板事件触发回调功能,腾讯云主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后事件对应路径即可获取回调信息的 JSON 数据包。
本文将向您介绍如何通过控制台创建、修改及删除回调配置模板。
其中,创建回调配置模板有以下两种方式:
通过云直播控制台创建模板,具体操作步骤请参见 创建回调模板。 通过 API 创建模板,具体参数及示例说明请参见 创建回调模板。 注意事项
创建成功后,还需到对应的推流域名下关联回调配置,关联成功后约5分钟 - 10分钟生效。 回调配置中,用于接收回调事件的回调地址 http
或 https
服务器必须能正常收到响应。
控制台的回调模板管理为域名维度,暂时无法取消关联接口创建的规则,如果是通过直播回调相关接口关联指定流的,则需要通过调用 删除回调规则 解除关联。 直播回调消息通知参数说明,具体请参见:
创建回调模板
3. 单击创建模板,在直播回调新建模板中填写回调信息,选择回调类型并填写回调地址,可多选。单击保存即可。
|
模板名称 | 回调模板名称,仅支持填写中文、英文、数字、_、-,不超过30个字符。 |
模板描述 | 回调模板描述信息,仅支持中文、英文、数字、空格、_、-,不超过100个字符。 |
回调密钥 | |
推流回调 | 填写用来接收推流回调事件的路径,可支持协议头: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. 确认是否删除当前回调配置模板,单击确定即可成功删除。
相关操作
域名维度绑定和解绑回调模板的具体操作及相关说明,请参见 回调配置。
本页内容是否解决了您的问题?