tencent cloud

媒体直播

产品简介
购买指南
计费说明
欠费停服说明
控制台指南
Input 管理
Channel 管理
Asset 管理
Plan 管理
功能实践
实现直播
流实时监控
数字版权保护（DRM）
溯源水印
容灾切换
多输入切换
推断流回调事件
轮播
定时录制
精彩集锦
时移
延播
多码率自适应
字幕
直播转推
直播截图
SCTE-35
PDT(HLS)
归档(录制)
杜比音频
输出至 YouTube
广告实践
资源标签
API 文档
History
Introduction
API Category
Making API Requests
Input Management APIs
Input Security Group Management APIs
Channel Management APIs
Plan APIs
Watermark Management APIs
Statistics APIs
Data Types
Error Codes
StreamLive 政策
数据处理和安全协议
隐私政策
相关协议
Service Level Agreement
文档媒体直播功能实践推断流回调事件

推断流回调事件

PDF
聚焦模式
字号
最后更新时间： 2025-09-08 17:23:23
推断流回调用于推送直播流状态信息，包括直播推流成功和直播推流中断。在 StreamLive 的输入配置中开启回调功能后，您需要填写回调消息接收服务器地址。在开始推送直播流到 StreamLive 后，StreamLive 后台会将推流结果回调到您设置的接收服务器中。
说明：
目前仅支持 RTMP 输入协议的推断流回调，其它协议暂未支持。

推断流事件参数说明

事件类型说明

事件类型
字段取值说明
直播推流
event_type = 329
直播断流
event_type = 330

回调公共参数

字段名称
类型
说明
t
int64
过期时间，事件通知签名过期 UNIX 时间戳。
来自腾讯云的消息通知默认过期时间是10分钟，如果一条消息通知中的 t 值所指定的时间已经过期，则可以判定这条通知无效，进而可以防止网络重放攻击。
t 的格式为十进制 UNIX 时间戳，即从1970年01月01日（UTC/GMT 的午夜）开始所经过的秒数。
sign
string
事件通知安全签名 sign = MD5（key + t）。
说明：腾讯云把回调加密 key 和 t 进行字符串拼接后通过 MD5 计算得出 sign 值，并将其放在通知消息里，您的后台服务器在收到通知消息后可以根据同样的算法确认 sign 是否正确，进而确认消息是否确实来自腾讯云后台。key 为回调密钥（Callback key），主要用于鉴权，为了保护您的数据信息安全，建议您填写。

回调消息参数

字段名称
类型
说明
appid
int
用户账号 APPID。
channel_id
string
StreamLive 频道 ID。
event_type
int
直播推流：event_type = 329
直播断流：event_type = 330
input_id
string
StreamLive 频道 Input ID。
pipeline
int
StreamLive 频道 Input Pipeline。

回调消息示例

直播推流回调消息示例

{
            "data": {
                "appid":*********,
                "channel_id": "63F5C728000061D706B6",
                "event_type": 329,
                "input_id": "6583B18B000017CCCBDA",
                "interface": "general_callback",
                "pipelie": 0,
                "sign": "fb94d1628c7ab6b3ba23fcd777ac5112",
                "stream_id": "",
                "t": 1757066192
            },
            "header": {
                "Connection": "keep-alive",
                "Content-Length": "222",
                "Content-Type": "application/json",
                "User-Agent": "*********"
            },
            "receive_time": 1757065592
        }

直播断流回调消息示例

{
            "data": {
                "appid": *********,
                "channel_id": "63F5C728000061D706B6",
                "event_type": 330,
                "input_id": "6583B18B000017CCCBDA",
                "interface": "general_callback",
                "pipelie": 1,
                "sign": "fb94d1628c7ab6b3ba23fcd777ac5112",
                "stream_id": "",
                "t": 1757066239
            },
            "header": {
                "Connection": "keep-alive",
                "Content-Length": "222",
                "Content-Type": "application/json",
                "User-Agent": "*********"
            },
            "receive_time": 1757065639
        }

上一篇: 多输入切换下一篇: 轮播

帮助和支持

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

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

文档反馈