通话中质量监听

最近更新时间:2022-09-20 05:17:40

功能描述

加入频道后,SDK 会每隔 2 秒自动触发通话质量相关的下述回调,你可以了解当前通话的网络质量、本地统计信息、音频质量和视频质量。

请确保已在你的项目中实现基本的实时音视频功能。详见

请确保已在你的项目中实现基本的实时音视频功能。

上下行网络质量报告

networkQuality 回调向你报告当前通话中每个用户/主播的上下行 last mile 网络质量,详见质量打分。其中,last mile 是指你的设备到 anyRTC 边缘服务器的网络。

  1. 上行 last mile 网络质量打分基于实际发送码率、上行网络丢包率、平均往返时延和上行网络抖动计算;

  2. 下行 last mile 网络质量打分基于下行网络丢包率、平均往返时延和下行网络抖动计算。

  • 在通信场景下,每隔 2 秒你会收到频道内所有用户(包括自己 uid 为 “0”)的网络质量报告。
  • 在直播场景下,如果你是主播,每隔 2 秒你会收到频道内所有主播(包括自己 uid 为 “0”)的网络质量报告;如果你是观众,每隔 2 秒你会收到所有主播和你自己的网络质量报告。
  • 实际发送码率与目标发送码率的比值越高,该网络下的通话质量越好,该网络质量打分越高。
  • 平均往返时延指的是多次往返时延的平均值。

统计信息报告

reportRtcStats 回调向你报告本地通话相关统计信息。通过此回调可了解到通话时长、当前通话频道中的人数、当前系统的 CPU 使用率、当前 App 的 CPU 使用率和以下参数。

参数描述备注
txBytes / rxBytes累计发送/接收字节数。自加入频道后累计的字节数。
txAudioBytes / rxAudioByte累计发送/接收音频字节数。自加入频道后累计的字节数。
txVideoBytes / rxVideoBytes累计发送/接收视频字节数。自加入频道后累计的字节数。
txKBitRate / rxKBitRate发送/接收码率。统计周期内实际发送/接收的码率。
txAudioKBitRate/ rxAudioKBitRate音频发送/接收码率。统计周期内实际发送/接收的码率。
txVideoKBitRate/ rxVideoKBitRate视频发送/接收码率。统计周期内实际发送/接收的码率。
lastmileDelay本地客户端到 anyRTC 边缘服务器的网络延迟。此处指的是平均往返时延的一半,不是客户端到 anyRTC 边缘服务器的单向时延。此处的网络延迟不区分音频和视频,是 UDP 包得到的数据。
txPacketLossRate本地客户端到 anyRTC 边缘服务器的丢包率。音频和视频上行丢包率中的较大值。使用抗丢包技术前的丢包率。
rxPacketLossRateanyRTC 边缘服务器到本地客户端的丢包率。音频和视频下行丢包率中的较大值。使用抗丢包技术前的丢包率。

音频质量报告

本地音频流统计信息报告

localAudioStats 回调向你报告本地设备发送音频流的统计信息。你可以了解到当前通话声道数(单声道或双声道)、发送音频的采样率和发送音频的码率。

SDK 会每隔 2 秒自动触发本回调,发送音频的采样率指统计周期内发送音频的实际采样率,发送音频的码率指统计周期内发送音频码率的平均值。

本地音频流状态监控

本地音频的状态发生改变时(包括本地麦克风录制状态和音频编码状态),SDK 会触发 localAudioStateChange 回调向你报告当前本地音频状态。当本地音频出现故障时,你可以通过错误码排查问题。

远端音频流统计信息报告

img

remoteAudioStats 回调向你报告当前通话中每个远端用户/主播音频流的统计信息。你可以了解到每个远端用户/主播发送的音频流质量、声道数(单声道或双声道)和以下重要参数信息。

参数描述备注
networkTransportDelay音频发送端到接收端的网络延迟。图中阶段 2 + 3 + 4
jitterBufferDelay接收端到网络抖动缓冲端的网络延迟。图中阶段 5
audioLossRate统计周期内,实际接收到的远端音频流丢帧率。图中阶段 2 + 3 + 4 + 5一个统计周期内,音频丢帧率达到 4% 计为一次音频卡顿
receivedSampleRate统计周期内,接收到的远端音频流的采样率。
receivedBitrate统计周期内,接收到的远端音频流的平均码率。
totalFrozenTime远端用户/主播在加入频道后发生音频卡顿的累计时长。anyRTC 定义 totalFrozenTime = 音频卡顿次数 × 2 × 1000 (毫秒)。累计时长是自加入频道后累计的时长。
frozenRate远端用户/主播音频卡顿累计时长占音频总有效时长的百分比。音频总有效时长指的是远端用户/主播加入频道后,既没有停止发送音频流,也没有禁用音频模块的通话时长。

remoteAudioStats 侧重报告远端音频流的全链路音频质量,更贴近你的主观感受。即使网络发生丢包,因为 FEC(Forward Error Correction)、重传恢复和带宽估计等抗丢包和拥塞控制技术,最终在接收端的音频丢帧率也可能不高,所以你感知到的音频质量也可能较好。

  • 在通信场景下,每隔 2 秒你会收到频道内所有远端用户(不包括你自己)的音频流统计信息。
  • 在直播场景下,如果你是主播,每隔 2 秒你会收到频道内所有远端主播(不包括你自己)的音频流统计信息;如果你是观众,每隔 2 秒你会收到频道内所有远端主播的音频流统计信息。
  • anyRTC 音频模块指音频处理过程,而不是 SDK 中的模块实物。发送音频流时,音频模块指音频采样、前处理、编码等处理过程;接收音频流时,音频模块指音频解码、后处理、播放等处理过程。
  • 用户只能开启/禁用自己的音频模块。
  • anyRTC 默认一个统计周期内的的音频卡顿不会多于 1 次。

远端音频流状态监控

远端用户/主播音频状态发生改变时,SDK 会触发 remoteAudioStateChangedOfUid 回调向你报告远端音频流当前状态和状态改变的原因。

  • 在通信场景下,本回调向你报告频道内所有远端用户(不包括你自己)的音频流状态信息。
  • 在直播场景下,如果你是主播,本回调向你报告频道内所有远端主播(不包括你自己)的音频流状态信息;如果你是观众,本回调向你报告频道内所有远端主播的音频流状态信息。

视频质量报告

本地视频流统计信息报告

localVideoStats 回调向你报告本地设备发送视频流的统计信息。你可以了解视频编码宽/高和以下重要参数信息。

如果你此前调用 enableDualStreamMode 方法开启双流模式,则本回调描述本地设备发送的视频大流的统计信息。

参数描述备注
rendererOutputFrameRate本地视频渲染器的输出帧率。
encoderOutputFrameRate本地视频编码器的输出帧率。
targetBitrate当前编码器的目标编码码率。该码率为 SDK 根据当前网络状况预估的一个值。
targetFrameRate当前编码器的目标编码帧率。
encodedBitrate视频编码码率。不包含丢包后重传视频等的视频码率。
sentBitrate统计周期内,实际发送视频码率。不包含丢包后重传视频等的视频码率。
sentFrameRate统计周期内,实际发送视频帧率。不包含丢包后重传视频等的视频帧率。
encodedFrameCount视频发送的累计帧数。自加入频道后的累计值。
codecType视频的编码类型。VIDEO_CODEC_VP8 = 1 : VP8 VIDEO_CODEC_H264 = 2: (默认值)H.264
qualityAdaptIndication本次统计的视频质量自适应情况。相比上次统计(2 秒前)视频质量(基于目标码率/targetBitrate 和目标帧率/ targetFrameRate),本次视频质量的情况:本地视频质量不变。本地视频质量改善。本地视频质量变差。

本地视频流状态监控

本地视频的状态发生改变时,SDK 会触发 localVideoStateChange 回调向你报告当前本地视频状态。当本地视频出现故障时,你可以通过错误码排查问题。

远端视频流统计信息报告

remoteVideoStats 回调向你报告当前通话中每个远端用户/主播的视频流的统计信息。你可以了解到每个远端用户/主播的视频宽/高和以下重要参数信息。

参数描述备注
rxStreamType视频流类型。视频大流或小流,详见双流模式
receivedBitrate统计周期内,实际接收到的远端视频码率。
packetLossRate统计周期内,实际接收到的远端视频流丢包率。图中阶段 2 + 3 + 4此处指使用抗丢包技术之后的丢包率,比使用抗丢包技术前的丢包率更低。
decoderOutputFrameRate远端视频解码器的输出帧率。
rendererOutputFrameRate远端视频渲染器的输出帧率。
totalFrozenTime远端用户/主播在加入频道后发送视频卡顿的累计时长。通话过程中,视频帧率设置不低于 5 fps 时,连续渲染的两帧视频之间间隔超过 500 ms,则计为一次视频卡顿
frozenRate远端用户/主播卡顿累计时长占视频有效时长的百分比。视频有效时长指远端用户/主播加入频道后,既没有停止发送视频流,也没有禁用视频模块的通话时长。
  • 在通信场景下,每隔 2 秒你会收到频道内所有远端用户(不包括你自己)的视频流统计信息。
  • 在直播场景下,如果你是主播,每隔 2 秒你会收到频道内所有远端主播(不包括你自己)的视频流统计信息;如果你是观众,每隔 2 秒你会收到频道内所有远端主播的视频流统计信息。
  • anyRTC 视频模块指视频处理过程,而不是 SDK 中的模块实物。发送视频流时,视频模块指视频采集、前处理、编码等处理过程;接收视频流时,视频模块指视频解码、后处理、渲染/播放等处理过程。
  • 用户只能开启/禁用自己的视频模块。

远端视频流状态监控

远端用户/主播的视频流状态改变时,SDK 会触发 remoteVideoStateChangedOfUid 回调向你报告远端视频流当前状态和状态改变的原因。

  • 在通信场景下,本回调向你报告频道内所有远端用户(不包括你自己)的视频流状态信息。
  • 在直播场景下,如果你是主播,本回调向你报告频道内所有远端主播(不包括你自己)的视频流状态信息;如果你是观众,本回调向你报告频道内所有远端主播的视频流状态信息。

API 参考

开发注意事项

localAudioStateChangeremoteAudioStateChangedOfUidlocalVideoStateChangeremoteVideoStateChangedOfUid 状态监控回调不会每 2 秒被 SDK 自动触发,各自触发条件详见正文。