推断流事件通知

Recent Pages

推断流事件通知

最后更新时间：2024-09-25 16:56:08

推断流回调用于推送直播流状态信息，包括直播推流成功和直播推流中断。您需在回调模板中配置推流回调和断流回调消息接收服务器地址，并将该模板与推流域名进行关联。在生成对应的推流地址并开始推送直播流后，腾讯云直播后台会将推流结果回调到您设置的接收服务器中。
本文主要讲解触发推断流回调事件后，腾讯云直播发送给用户的回调消息通知字段。
注意事项
阅读本文之前，希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的，具体请参见 如何接收事件通知。 
推断流事件参数说明
事件类型参数
事件类型
字段取值说明
直播推流
event_type = 1
直播断流
event_type = 0
回调公共参数
字段名称
类型
说明
t
int64
过期时间，事件通知签名过期 UNIX 时间戳。
来自腾讯云的消息通知默认过期时间是10分钟，如果一条消息通知中的 t 值所指定的时间已经过期，则可以判定这条通知无效，进而可以防止网络重放攻击。
t 的格式为十进制 UNIX 时间戳，即从1970年01月01日（UTC/GMT 的午夜）开始所经过的秒数。
sign
string
事件通知安全签名 sign = MD5（key + t）。说明：腾讯云把加密 key 和 t 进行字符串拼接后通过 MD5 计算得出 sign 值，并将其放在通知消息里，您的后台服务器在收到通知消息后可以根据同样的算法确认 sign 是否正确，进而确认消息是否确实来自腾讯云后台。
说明：
key 为功能配置 > 直播回调 中的回调密钥，主要用于鉴权。为了保护您的数据信息安全，建议您填写。
﻿
﻿
﻿
回调消息参数
字段名称
类型
说明
appid
int
用户 APPID﻿
app
string
推流域名
appname
string
推流路径
stream_id
string
直播流名称
channel_id
string
同直播流名称
event_time
int64
事件消息产生的 UNIX 时间戳
sequence
string
消息序列号，标识一次推流活动，一次推流活动会产生相同序列号的推流和断流消息
node
string
直播接入点的 IP
user_ip
string
用户推流 IP
stream_param
string
用户推流 URL 所带参数
push_duration
string
断流事件通知推流时长，单位毫秒
errcode
int
推断流错误码
errmsg
string
推断流错误描述
set_id
int
判断是否为国内外推流。1-6为国内，7-200为国外
width
int
视频宽度，最开始推流回调的时候若视频头部信息缺失，可能为0
height
int
视频高度，最开始推流回调的时候若视频头部信息缺失，可能为0
断流原因
断流原因详情请参见 断流记录。
回调消息示例
直播推流回调消息示例
{
    "app":"test.domain.com",
    "appid":12345678,
    "appname":"live",
    "channel_id":"test_stream",
    "errcode":0,
    "errmsg":"ok",
    "event_time":1703731478,
    "event_type":1,
    "height":0,
    "idc_id":34,
    "node":"42.81.194.37",
    "sequence":"2210464508206756938",
    "set_id":2,
    "sign":"df49************************f5d4",
    "stream_id":"test_stream",
    "stream_param":"stream_param=test",
    "t":1703732078,
    "user_ip":"1.1.1.1",
    "width":0
}
直播断流回调消息示例
{
    "app":"test.domain.com",
    "appid":12345678,
    "appname":"live",
    "channel_id":"test_stream",
    "errcode":1,
    "errmsg":"The push client actively stopped the push",
    "event_time":1703731606,
    "event_type":0,
    "height":0,
    "idc_id":34,
    "node":"42.81.194.37",
    "push_duration":"128581",
    "sequence":"2210464508206756938",
    "set_id":2,
    "sign":"3485************************56ae",
    "stream_id":"test_stream",
    "stream_param":"stream_param=test",
    "t":1703732206,
    "user_ip":"1.1.1.1",
    "width":0
}
推断流错误码
错误码
﻿
描述
1
﻿
推流客户端主动断流
2
﻿
﻿
3
﻿
﻿
4
﻿
﻿
35
﻿
﻿
5
﻿
直播系统内部错误
9
﻿
﻿
11
﻿
﻿
24
﻿
﻿
6
﻿
RTMP 协议内容异常
7
﻿
RTMP 单个帧大小超过配置允许的最大值
8
﻿
系统主动断开长时间无数据的推流
20
﻿
﻿
10
﻿
直播系统内部错误
12
﻿
推流链路网络异常
13
﻿
﻿
14
﻿
﻿
15
﻿
﻿
16
﻿
﻿
17
﻿
﻿
19
﻿
第三方鉴权失败
20
﻿
统主动断开长时间无数据的推流
23
﻿
RTMP 协议内容异常
24
﻿
直播系统内部错误
33
﻿
RTMP AMF 数据异常
0
﻿
未知原因，请 提交工单 联系我们
22
﻿
﻿
25
﻿
﻿
26
﻿
﻿
27
﻿
﻿
28
﻿
﻿
29
﻿
﻿
30
﻿
﻿
31
﻿
﻿
32
﻿
﻿
34
﻿
﻿
其它未知值
﻿
﻿

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

Recent Pages

推断流事件通知

注意事项

推断流事件参数说明

事件类型参数

回调公共参数

回调消息参数

断流原因

回调消息示例

直播推流回调消息示例

直播断流回调消息示例

推断流错误码

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

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

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

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

错误码			描述
1			推流客户端主动断流
2
3
4
35
5			直播系统内部错误
9
11
24
6			RTMP 协议内容异常
7			RTMP 单个帧大小超过配置允许的最大值
8			系统主动断开长时间无数据的推流
20
10			直播系统内部错误
12			推流链路网络异常
13
14
15
16
17
19			第三方鉴权失败
20			统主动断开长时间无数据的推流
23			RTMP 协议内容异常
24			直播系统内部错误
33			RTMP AMF 数据异常
0			未知原因，请提交工单联系我们
22
25
26
27
28
29
30
31
32
34
其它未知值

tencent cloud

注册

登录

Recent Pages

推断流事件通知

注意事项

推断流事件参数说明

事件类型参数

回调公共参数

回调消息参数

断流原因

回调消息示例

直播推流回调消息示例

直播断流回调消息示例

推断流错误码

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

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