直播回调
最后更新时间：2025-12-03 18:07:10
云直播提供直播回调功能，支持通过控制台配置回调模板，针对各触发事件设置接收相关回调信息的路径。并在推流域名下进行模板关联。关联成功后，当直播过程中根据所配置模板事件触发回调功能，腾讯云主动发送请求到客户服务器，客户服务器负责应答请求。验证通过后事件对应路径即可获取回调信息的 JSON 数据包。
本文将向您介绍如何通过控制台创建、修改及删除回调配置模板。
其中，创建回调配置模板有以下两种方式：
通过云直播控制台创建模板，具体操作步骤请参见 创建回调模板。
通过 API 创建模板，具体参数及示例说明请参见 创建回调模板。
注意事项
创建成功后，还需到对应的推流域名下关联回调配置，关联成功后约5分钟 - 10分钟生效。
回调配置中，用于接收回调事件的回调地址
http 或 https 服务器必须能正常收到响应。控制台的回调模板管理为域名维度，暂时无法取消关联接口创建的规则，如果是通过直播回调相关接口关联指定流的，则需要通过调用 删除回调规则 解除关联。
直播回调相关协议，请参见 事件消息通知协议。
直播回调消息通知参数说明，具体请参见：
推流事件通知
断流事件通知
录制文件事件通知
录制状态事件通知
截图事件通知
拉流转推事件通知
推流异常事件通知
录制异常事件通知
智能擦除事件通知
直播字幕事件通知
质检事件通知
评测阈值事件通知
直播摘要事件通知
高光切片事件通知
创建回调模板
1. 登录 云直播控制台。
2. 在左侧菜单栏选择功能配置 > 直播回调。
3. 单击创建模板，在直播回调新建模板中填写回调信息，选择回调类型并填写回调地址，可多选。单击保存即可。
配置项 | | 说明 |
模板名称 | | 回调模板名称，仅支持填写中文、英文、数字、_、-，不超过30个字符。 |
模板描述 | | 回调模板描述信息，仅支持中文、英文、数字、空格、_、-，不超过100个字符。 |
回调密钥 | | |
回调类型 | 标准回调 | 推流回调：填写用来接收推流回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 断流回调：填写用来接收断流回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 录制文件回调：填写用来接收录制文件回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 录制状态回调：填写用来接收录制状态回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 截图回调：填写用来接收截图回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 图片审核回调：填写用来接收图片审核回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 音频审核回调：填写用来接收音频审核回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 质检回调：填写用来接收质检回调事件的路径，可支持协议头：HTTP、HTTPS 等。 |
| | 评测阈值回调：填写用来接收评测阈值回调事件的路径，可支持协议头：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. 确认是否删除当前回调配置模板，单击确定即可成功删除。
相关操作
文档反馈