云直播
有奖：语音产品征文挑战赛火热进行中> HOT
文档中心 > 云直播 > 功能实践 > 回调事件消息通知 > 监播事件通知

监播事件通知

最近更新时间：2024-04-18 18:14:01

我的收藏

本页目录：

在监播回调通知中填写监播回调 URL，当监播中的场次命中已配置异常监控和智能识别的相关数据，消息将会统一回调给客户后台，腾讯云直播后台会将监播结果回调到您设置的接收服务器中。
本文主要讲解触发监播回调事件后，腾讯云直播发送给用户的回调消息通知字段。

前提条件

已登录 云直播控制台。
打开实时监播配置监播回调通知，详情请参见 实时监播。

监播事件参数说明

事件类型参数

事件类型
字段取值说明
实时监播
event_type = 328

监播事件回调参数说明

字段名称
类型
说明
appid
int
用户的 APPID
bizid
int
用户的 BIZID
interface
string
接口名，固定为 "general_callback"
event_type
int
通用回调事件类型，固定为328
event_name
string
监播回调事件名称，目前支持断流、低帧率、格式异常检测、内容异常检测、智能语音识别、智能文字识别六种回调类型
event_time
int
回调 UTC 时间戳，单位ms
event_msg
string
监播回调事件详情
stream_id
string
监播流 ID
说明：
监播回调事件目前支持断流、低帧率、格式异常检测、智能语音识别、智能文字识别五种回调类型。其中格式异常检测事件内容详情请参考 格式异常检测事件类型说明，可根据回调信息中的 “event_name” 对照说明中的“类别”查找对应的异常说明及排查建议。

格式异常检测事件类型说明

类别
等级
数据异常信息
数据异常示意图
播放异常现象
可能原因及排查建议
VideoResolutionChanged
Warning
视频分辨率发生变化
?
?
?
视频播放异常
通常是由于横竖屏切换后重新推流导致的，建议排查视频输入设备（例如摄像头）。
AudioSampleRateChanged
Warning
音频采样率变化
?
?
?
音频播放异常
通常是推流侧重新设置了音频编码器参数，建议排查音频输入设备（例如麦克风）和推流软件设置。
AudioChannelsChanged
Warning
音频通道数变化
?
?
?
音频播放异常
通常是由于推流侧重新设置了音频编码器参数，建议排查音频输入设备（例如麦克风）和推流软件设置。
ParameterSetsChanged
Warning
流参数集信息发生变化（例如 H265/H264 的 VPS/SPS/PPS 变化、AAC 的解码器信息变化等）
?
?
?
视频播放异常
通常是由于推流侧重新设置了音视频编码器参数，建议使用腾讯云编码器。
DarOrSarInvalid
Warning
视频的宽高比异常
?
?
?
视频播放异常
通常是由于编码器内部错误导致的，建议使用腾讯云编码器。
TimestampFallback
Fatal
DTS 时间戳回退
?
?
?
视频播放卡顿或花屏
通常是由于编码器内部错误或容器封装导致的，建议使用腾讯云编码器。
DtsJitter
Warning
DTS 抖动过大
?
?
?
视频播放卡顿
通常是由于编码器内部错误或容器封装导致的，建议使用腾讯云编码器。
PtsJitter
Warning
PTS 抖动过大
?
?
?
视频播放卡顿
通常是由于编码器内部错误或容器封装导致的，建议使用腾讯云编码器。
AACDurationDeviation
Warning
AAC 帧的时间戳间隔不合理
AAC 帧时间戳间隔是1024/48KHz=21.3ms，
如果帧间隔远小于或大于该值，则AAC 的帧时间戳分布不均匀
?
?
?
音频播放卡顿
通常是由于编码器内部错误或容器封装导致的，建议使用腾讯云编码器。
AudioDroppingFrames
Warning
音频丢帧：
对于 AAC 流，同 AACDurationDeviation 类似，当相邻两帧时间戳差值大于2倍理论帧间隔（例如48KHz下的21.3ms），此时可判定中间可能丢了1帧；
对于其他流，超过1秒内没有收到音频帧则判定为丢帧，可能导致音频播放异常
?
?
?
音频播放卡顿
通常是由于网络不稳定导致的，建议检查网络稳定性。
VideoDroppingFrames
Warning
视频丢帧（超过1秒内没有收到视频帧）
?
?
?
视频播放卡顿
通常是由于网络不稳定导致的，建议检查网络稳定性。
AVTimestampInterleave
Warning
音视频交织不合理
?
?
?
播放音画不同步
通常是由于音视频交织时间戳不同步导致的，建议首先检查音视频源是否完整，然后检查容器封装是否异常。
FpsJitter
Warning
通过 PTS 计算得到的流帧率抖动过大
?
音视频播放卡顿
通常是由于编码器性能不足或者网络抖动导致的，建议首先检查编码机器负载，然后检查网络稳定性。
StreamOpenFailed
Fatal
流打开失败
?
?
?
视频无法播放
通常是由于推流网络异常、推流地址无效、推流鉴权失败等原因，建议排查推流软件设置。
StreamParseFailed
Fatal
流解析失败
?
?
?
视频无法播放
通常是由于流数据损坏导致的，建议排查推流软件状态，建议检查网络稳定性。
VideoFirstFrameNotIdr
Fatal
首帧不是 IDR 帧
?
?
?
视频无法播放
通常是由于编码异常或者数据传输异常导致的，建议首先排查编码后推流前的文件能否正常播放，然后排查推流传输的数据是否完整。

内容异常检测事件类型说明

类别
等级
数据异常信息
数据异常示意图
异常现象
异常原因及排查建议
Jitter
warning
可能会出现画面的持续性晃动
?
?
?
抖动重影
检查是否为正常效果，否则可能是由于摄像头或云台不稳定，也可能是拍摄手法导致。
Blur
warning
画面中物体不清楚。
?
?
?
模糊
检查是否为正常效果，否则可能是由于聚焦不准、镜头覆盖灰尘和水汽、被人为涂抹和遮挡等问题。
LowLighting
warning
画面昏暗，难以分辨细节
?
?
?
低光照
检查是否为正常效果，否则可能是摄像头故障，或拍摄环境昏暗。
HighLighting
warning
图像发白，难以分辨细节
?
?
?
过曝光
检查是否为正常效果，否则可能是摄像头故障，或拍摄环境光线过强。
CrashScreen
error
图像先出花屏，视频无法观看
?
?
?
花屏
检查视频源数据是否损坏。
BlackWhiteEdge
warning
画面没有充满整个屏幕
?
?
?
黑边，白边 黑屏、白屏
检查是否为正常效果，否则可能是编辑视频的分辨率和实际分辨率不一致导致的自动填充。
Noise
warning
画面种可能出现颗粒度噪声。
?
?
?
噪点
检查是否为正常效果，否则可能是因为摄像头故障。
Mosaic
warning
画面不清晰，有马赛克遮挡
?
?
?
马赛克
检查是否为正常效果，否则可能是编码器编码时出现问题，或者传输时数据丢失。
QRCode
warning
画面中存在二维码
?
?
?
二维码
检查是否为正常效果。

回调消息示例

断流事件
低帧率事件
格式异常检测
内容异常检测
智能文字识别事件
智能语音识别事件
{
    appid: 25100xxxx,
?
?
    bizid: 299xx,
?
?
    event_msg: "stream [ test1 ] is broken",
?
?
    event_name: "StreamBroken",
?
?
    event_time: 1678086930413,
?
?
    event_type: 328,
?
?
    interface: "general_callback",
?
?
    stream_id: "test1"
}
?
{
    appid: 25100xxxx,
?
?
    bizid: 299xx,
?
?
    event_msg: "stream [ test1 ] frame rate is less than 10 fps",
?
?
    event_name: "StreamLowFramerate",
?
?
    event_time: 1678089053008,
?
?
    event_type: 328,
?
?
    interface: "general_callback",
?
?
    stream_id: "test1"
}
?
{
    appid: 25100xxxx,
?
?
    bizid: 299xx,
?
?
    event_msg: "stream [ 11 ] format diagnose: Timestamp interleave is not rational. Video[min:57125ms max:58500ms] vs audio[min:57035ms max:57995ms]",
?
?
    event_name: "AVTimestampInterleave",
?
?
    event_time: 1678089018193,
?
?
    event_type: 328,
?
?
    interface: "general_callback",
?
?
    stream_id: "test1"
}
?
{
    "appid": 125844xxxx,
?
     
    "bizid": 498xx,
          
     
    "event_msg": "stream [11 ] content quality inspection: {StartTimeOffset: 103.56, EndTimeOffset: 103.56}",
          
          
    "event_name": "BlackWhiteEdge",
               
               
    "event_time": 1713426117124,
                    
                    
    "event_type": 328,
                         
                         
    "interface": "general_callback",
                              
                              
    "stream_id": "11"
}
{
    appid: 25100xxxx,
?
?
    bizid: 299xx,
?
?
    event_msg: "stream [ test1 ] callback message: {AreaCoordSet:[42,325,101,336], Text:测试测试}",
?
?
    event_name: "OcrFullText",
?
?
    event_time: 1678086955691,
?
?
    event_type: 328,
?
?
    interface: "general_callback",
?
?
    stream_id: "test1"
}
?
{
    appid: 25100xxxx,
?
?
    bizid: 299xx,
?
?
    event_msg: "stream [ test1 ] callback message: {StartPtsTime:4.783, EndPtsTime:24.063, Text:测试测试}",
?
?
    event_name: "AsrFullText",
?
?
    event_time: 1678089018193,
?
?
    event_type: 328,
?
?
    interface: "general_callback",
?
?
    stream_id: "test1"
}
?
中国站
http://www.vxiaotou.com