tencent cloud

云直播提供直播回调功能，支持通过控制台配置回调模板，针对各触发事件设置接收相关回调信息的路径。并在推流域名下进行模板关联。关联成功后，当直播过程中根据所配置模板事件触发回调功能，腾讯云主动发送请求到客户服务器，客户服务器负责应答请求。验证通过后事件对应路径即可获取回调信息的 JSON 数据包。
本文将向您介绍如何通过控制台创建、修改及删除回调配置模板。

其中，创建回调配置模板有以下两种方式：

• 通过云直播控制台创建模板，具体操作步骤请参见 创建回调模板。
• 通过 API 创建模板，具体参数及示例说明请参见 创建回调模板。

注意事项

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

创建回调模板

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

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

修改模板

1. 进入事件中心 > 直播回调。
2. 选择您已创建成功的回调配置模板，并单击右侧的编辑，即可进入修改模板信息。
3. 单击保存即可。

删除模板

若模板已被关联，需要先解绑模板，才可以进行删除操作，具体解绑操作请参见 解绑回调配置。

1. 进入事件中心 > 直播回调。
2. 选择您已创建成功的回调配置模板，单击右侧的删除。
3. 确认是否删除当前截图鉴黄配置模板，单击确定即可成功删除。