录制异常事件回调主要用于回调录制过程中异常情况的具体信息,您需要在录制异常事件回调中配置回调地址,腾讯云直播后台会将类型结果回调到您设置的接收服务器中。
本文主要讲解触发录制异常事件回调后,腾讯云直播发送给用户的回调消息通知字段。
注意事项
录制异常事件参数说明
事件类型参数
事件类型 | 字段取值说明 |
录制异常事件 | event_type = 341 |
回调公共参数
字段名称 | 类型 | 说明 |
t | int64 | 过期时间,事件通知签名过期 UNIX 时间戳。 来自腾讯云的消息通知默认过期时间是10分钟,如果一条消息通知中的 t 值所指定的时间已经过期,则可以判定这条通知无效,进而可以防止网络重放攻击。 t 的格式为十进制 UNIX 时间戳,即从1970年01月01日(UTC/GMT 的午夜)开始所经过的秒数。 |
sign | string | 事件通知安全签名 sign = MD5(key + t)。 说明:腾讯云把加密 key 和 t 进行字符串拼接后通过 MD5 计算得出 sign 值,并将其放在通知消息里,您的后台服务器在收到通知消息后可以根据同样的算法确认 sign 是否正确,进而确认消息是否确实来自腾讯云后台。 |
录制异常回调消息参数
参数 | 类型 | 含义 |
appid | int | 用户 APPID。 |
stream_id | string | 直播流名称。 |
session_id | string | 直播录制会话 ID,用于区分不同的录制任务。 |
file_format | string | 录制文件格式包括:FLV、TS、MP4、AAC 等。 |
timestamp | int | 录制异常事件回调时间(单位:秒)。 |
exception_level | string | 异常等级包括:info、warning、error等。 |
exception | json | 详细异常事件描述。 |
exception 内参数说明
参数 | 类型 | 含义 |
type | int | 异常事件类型。 |
occurs | int | 对应异常事件统计周期内发生次数。 |
desc | string | 异常事件描述。 |
异常事件类型
类型 | 含义 |
-8 | 音频时戳跳变。 |
-9 | 视频时戳跳变。 |
-10 | 音视频时戳不同步。 |
-11 | 视频时戳非法。 |
-16 | 拉流失败。 |
-17 | 音频录制推流无音频。 |
-18 | 视频录制推流无视频。 |
-22 | 音频时戳无变动。 |
-23 | 视频时戳无变动。 |
-24 | 音频时戳非法。 |
-100 | 推流分辨率变化。 |
-104 | 音视频帧写容器(文件)异常。 |
-120 | 视频编码变化强制切录制文件。 |
-130 | 丢弃异常视频帧。 |
-131 | 丢弃异常音频帧。 |
-132 | GOP 长度异常。 |
-200 | 音频时戳不均匀递增。 |
-201 | 视频时戳不均匀递增。 |
注意:
当前录制异常事件回调不支持对单独事件进行配置,且只对当前发生的异常事件进行回调;如果没有异常事件,则不进行回调。
录制异常事件回调仅对当前的录制异常进行统计,为避免频繁回调,对短时间内出现的相同异常事件将进行合并处理,因此异常事件回调可能存在延迟(不超过2分钟)。除了异常事件检测和异常事件回调外,录制后台不会进行其他处理。
回调消息示例
{"interface":"general_callback","event_type":341,"appid":1234567,"domain":"1234567.livepush.myqcloud.com","path":"live","stream_id":"test_stream_35b4a6e6d4261","session_id":"1855245773800540059","file_format":"ts","timestamp":1739934527,"exception_level":"info","exception":{"type":-201,"desc":"video ts deviation: 100.000000","occurs":4},"sign": "ca3e25e5dc17a6f9909a9ae7281e300d","t": 1754623810}