tencent cloud

云直播

动态与公告
公告
新手指南
产品简介
产品概述
子产品简介
基本概念
产品功能
应用场景
产品优势
使用限制
购买指南
计费概述
基础服务费
增值服务费
预付费资源包
购买流程
计费变更
退款说明
账单查询
续费说明
欠费停服说明
计费常见问题
标准直播
概述
应用场景
快速入门
SDK 接入说明
快直播(超低延时直播)
概述
快直播和标准直播区别
应用场景
快速入门
SDK 接入说明
云导播台
概述
应用场景
功能区介绍
云导播台管理
通用云导播
配置节目单和自动导播
控制台指南
控制台介绍
概览
域名管理
流管理
资源包管理
AI 智能
功能配置
拉流转推
计费用量
业务监控
常用工具
无忧直播
CAM 访问控制
功能实践
直播推流与播放
直播增值功能
典型场景实践
云端原生录制
直播安全
海外直播
回调事件消息通知
常见第三方工具指南
SDK 实践
0. SDK 接入引导
1. 推流
2. 播放
3. 高级功能
API 文档
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
运维指南
优化视频卡顿
推流失败问题排查
播放失败问题排查
CLS 协助直播问题排查
直播延迟问题排查
拉流视频质量不清晰问题排查
COS bucket 授权给直播实现截图存储
故障处理
直播混流报错:InvalidParameter.OtherError
常见问题
服务地区相关
直播基础相关
推流播放相关
直播计费相关
直播海外相关
直播录制相关
云端混流相关
域名配置相关
云导播台相关
适配苹果 ATS 相关
服务等级协议
云直播服务等级协议
CSS 政策
隐私协议
数据处理和安全协议
词汇表

如何接收事件通知

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 17:56:27
当直播过程中域名关联模板事件被触发时,腾讯云将主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后,您可被动获取到含直播事件回调信息的 JSON 数据包。
目前直播事件触发消息通知支持事件包括:直播推流、直播断流、直播录制、直播截图、直播画面审核事件通知、直播音频审核事件通知、推流异常事件通知、拉流转推事件通知。

整体流程




流程说明:
1. 主播在控制台或直接调用云 API 配置事件消息通知 URL 以及录制、截图等相关功能。
2. 主播进行直播推断流。
3. 当直播服务内部有事件发生时,消息将会经由事件消息通知服务统一回调给客户后台。

事件消息通知协议

网络协议

请求:HTTP POST 请求,包体内容为 JSON,每一种消息的具体包体内容参见后文。
应答:HTTP STATUS CODE = 200,服务端忽略应答包具体内容,为了协议友好,建议客户应答内容携带 JSON: {"code":0}

通知可靠性

事件通知服务具备重试能力,截图事件通知重试间隔为2分钟,总计重试5次,除此之外直播推流、直播断流、直播录制、直播鉴黄事件通知重试间隔为1分钟,总计重试12次。 为了避免重试对您的服务器以及网络带宽造成冲击,请保持正常回包。触发重试条件如下:
长时间(20 秒)未回包应答。
应答 HTTP STATUS 不为200。

回调事件配置方式

回调配置主要通过两种方式实现,一种是通过 云直播控制台,另一种是通过调用 服务端 API
说明:
直播回调事件消息通知 URL 支持对推流事件、断流事件、录制事件、截图事件、鉴黄事件配置独立回调 URL。

云直播控制台

1. 进入云直播控制台的 功能配置 >直播回调,创建回调模板,具体操作可参见 创建回调模板
2. 域名管理 找到您需操作的推流域名,单击管理 > 模板配置,将此域名与回调模板进行关联。具体操作请参见 回调配置

服务端 API

1. 调用 CreateLiveCallbackTemplate 创建回调模板接口,设置您需要的回调参数信息。
2. 调用 CreateLiveCallbackRule 创建回调规则,设置参数推流域名 DomainName 和 TemplateId(第1步返回),填写与推流和播放地址中一致的 AppName,实现部分直播流开启回调的效果。

回调信息参数说明

回调模板关联域名成功后,当直播过程中触发模板事件,腾讯云将主动发送含回调信息的 JSON 包到客户服务器。回调信息具体参数说明如下:


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈