提交工单
咨询集成、功能及报价等问题
在推流/拉流成功后,SDK 默认每 3 秒触发一次推流/拉流的质量回调,以供用户监测此次通话/直播的音视频质量。
推流质量包含了采集、编码阶段音视频流的帧率、分辨率,传输(发送)的音视频流的帧率、码率、延时及丢包率。
返回推流质量的回调: ZegoLivePublisherDelegate onPublishQualityUpdate:quality:,默认每 3 秒触发一次。
推流采集质量贴近用户预览时的主观感受。
推流时 SDK 在采集阶段的音视频质量的相关参数如下:
acapFps
:音频采集帧率(fps)cfps
:推流前设置的视频采集帧率(fps)推流时 SDK 在编码阶段的音视频质量的相关参数如下:
vencFps
:当前编码器的目标视频编码帧率(fps)width
:推流前设置的视频编码分辨率宽height
:推流前设置的视频编码分辨率高推流发送质量是实际推流的质量,与设置的编码分辨率和实际的网络质量相关。
推流传输的音视频质量的相关参数如下:
afps
:实际的音频发送帧率(fps)akbps
:实际的音频发送码率(Kbps)fps
:实际的视频发送帧率(fps)kbps
:实际的视频发送码率(Kbps)quality
:当前的网络质量,0-优,1-良,2-中,3-差rtt
:设备到 ZEGO Server 的往返延时(ms)pktLostRate
:设备上行丢包数([0,255]),丢包率 = 丢包数 / 255拉流质量包含了传输(接收)的音视频流的帧率、码率、延时和丢包率,解码阶段音视频流的帧率和分辨率,以及渲染阶段的帧率、分辨率、卡顿率、卡顿时长、音视频整体质量及首帧耗时。
返回拉流质量的回调: ZegoLivePlayerDelegate onPlayQualityUpate:quality:,默认每 3 秒触发一次。
拉流接收质量是实际的拉流质量,与实际的推流质量和当前的网络质量相关。
拉流时接收的音视频质量的相关参数如下:
afps
:实际接收的音频帧率(fps) akbps
:实际接收的音频码率(Kbps)audioBreakRate
:实际接收的音频卡顿次数fps
:实际接收的视频帧率(fps) kbps
:实际接收的视频码率(Kbps)videoBreakRate
:实际接收的视频卡顿次数width
:实际接收的视频分辨率宽height
:实际接收的视频分辨率高rtt
:设备到 ZEGO Server 的往返延时(ms)peerToPeerDelay
:从推流端推出音视频帧到拉流端拉取到此音视频帧的时间(ms)pktLostRate
:设备下行丢包数([0,255]),丢包率 = 丢包数 / 255 peerToPeerPktLostRate
:从推流端推出音视频帧到拉流端拉取到此音视频帧这段时间的丢包数([0,255]),丢包率 = 丢包数 / 255audioCumulativeBreakCount
:音频卡顿累计次数audioCumulativeBreakTime
:音频卡顿累计时长(ms)audioCumulativeDecodeTime
:音频解码累计时长(ms)videoCumulativeBreakCount
:视频卡顿累计次数videoCumulativeBreakTime
:视频卡顿累计时长(ms)videoCumulativeDecodeTime
:视频解码累计时长(ms)拉流渲染质量贴近用户观看音视频的主观感受,该质量受解码器影响可能低于实际接收的拉流质量值。
拉流渲染阶段的音视频质量的相关参数如下:
arndFps
:实际的音频渲染帧率 vrndFps
:实际的视频渲染帧率quality
:当前的网络质量,0-优,1-良,2-中,3-差音频卡顿时长
:可使用 ZegoLiveEventDelegate zego_onLiveEvent:info: 直播事件回调中的音频卡顿开始 Play_AudioBreak
和音频卡顿结束事件 Play_AudioBreakEnd
的差值获取。视频卡顿时长
:可根据 ZegoLiveEventDelegate zego_onLiveEvent:info: 直播事件回调中的视频卡顿开始 Play_VideoBreak
和视频卡顿结束事件 Play_VideoBreakEnd
的差值获取。首帧耗时
:视频首帧耗时可根据 ZegoLivePlayerDelegate onRecvRemoteVideoFirstFrame: 接收到推流端首帧视频通知的时间与拉流启动时间的差值获取,音频首帧耗时可根据 ZegoLivePlayerDelegate onRecvRemoteAudioFirstFrame: 接收到推流端首帧视频通知的时间与拉流启动时间的差值获取。avTimestampDiff
:表示视频时间戳相对于音频时间戳的差值,单位为毫秒。avTimestampDiff < 0 表示视频比音频慢的毫秒数,avTimestampDiff > 0 表示视频比音频快的毫秒数,avTimestampDiff = 0 表示无差别。当 avTimestampDiff <= 200,可基本认为音画同步。当 avTimestampDiff 连续 10s 大于 200 可以认为异常。使用该字段时拉流质量回调周期设置不要超过 3s,回调周期建议保持 SDK 默认值 3s。联系我们
文档反馈