tencent cloud

文档媒体直播功能实践推断流回调事件

推断流回调事件

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
}


帮助和支持

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

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

文档反馈