通话中质量监听

功能描述

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

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

示例项目

我们在 GitHub 上提供已实现通话中质量监测功能的开源示例项目。你可以下载体验并参考源代码

上下行网络质量报告

onNetworkQuality 回调向你报告当前通话中每个用户/主播的上下行 last mile 网络质量。其中，last mile 是指你的设备到 AR 边缘服务器的网络。上行 last mile 网络质量打分基于实际发送码率、上行网络丢包率、平均往返时延和上行网络抖动计算；下行 last mile 网络质量打分基于下行网络丢包率、平均往返时延和下行网络抖动计算。

在通信场景下，每隔 2 秒你会收到频道内所有用户（包括你自己）的网络质量报告。

在直播场景下，如果你是主播，每隔 2 秒你会收到频道内所有主播（包括你自己）的网络质量报告；如果你是观众，每隔 2 秒你会收到所有主播和你自己的网络质量报告。

实际发送码率与目标发送码率的比值越高，该网络下的通话质量越好，该网络质量打分越高。

平均往返时延指的是多次往返时延的平均值。

统计信息报告

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

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

示例代码

    override fun onRtcStats(stats: RtcStats?) {
        callback(RtcEngineEvents.RtcStats, stats?.toMap())
    }

音频质量报告

本地音频流统计信息报告

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

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

示例代码

    override fun onLocalAudioStats(stats: LocalAudioStats?) {
        callback(RtcEngineEvents.LocalAudioStats, stats?.toMap())
    }

本地音频流状态监控

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

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

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

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

在通信场景下，每隔 2 秒你会收到频道内所有远端用户（不包括你自己）的音频流统计信息。

在直播场景下，如果你是主播，每隔 2 秒你会收到频道内所有远端主播（不包括你自己）的音频流统计信息；如果你是观众，每隔 2 秒你会收到频道内所有远端主播的音频流统计信息。

AR 音频模块指音频处理过程，而不是 SDK 中的模块实物。发送音频流时，音频模块指音频采样、前处理、编码等处理过程；接收音频流时，音频模块指音频解码、后处理、播放等处理过程。

用户只能开启/禁用自己的音频模块。

AR 默认一个统计周期内的的音频卡顿不会多于 1 次。

示例代码

    @Deprecated("", ReplaceWith("onRemoteAudioStats"))
    override fun onRemoteAudioTransportStats(uid: String, delay: Int, lost: Int, rxKBitRate: Int) {
        callback(RtcEngineEvents.RemoteAudioTransportStats, uid, delay, lost, rxKBitRate)
    }

视频质量报告

本地视频流统计信息报告

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

如果你此前调用 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 会触发 onRemoteVideoStateChanged 回调向你报告远端视频流当前状态和状态改变的原因。

在通信场景下，本回调向你报告频道内所有远端用户（不包括你自己）的视频流状态信息。

在直播场景下，如果你是主播，本回调向你报告频道内所有远端主播（不包括你自己）的视频流状态信息；如果你是观众，本回调向你报告频道内所有远端主播的视频流状态信息。

示例代码

    @Deprecated("", ReplaceWith("onRemoteVideoStateChanged"))
    override fun onUserMuteVideo(uid: String, muted: Boolean) {
        callback(RtcEngineEvents.UserMuteVideo, uid, muted)
    }

开发注意事项

onLocalAudioStateChanged、onRemoteAudioStateChanged、onLocalVideoStateChanged 和 onRemoteVideoStateChanged 状态监控回调不会每 2 秒被 SDK 自动触发，各自触发条件详见正文。