# 通话中质量监测 (/zh-CN/realtime-media/rtc/build/optimize-and-operate/in-call-quality/electron) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 在通话过程中,RTC SDK 会触发与通话和直播质量相关的回调。从这些回调中,你可以了解用户的互动体验,进行问题排查和优化用户体验。 本文介绍这些回调的详细信息以及回调的使用方法。 ## 技术原理 [#技术原理-4] 用户加入频道后,SDK 会每隔 2 秒触发一系列回调,上报以下信息:上下行网络质量、实时互动统计信息、本地和远端音视频流的统计信息。 当用户的音频或视频状态发生变化时,SDK 会触发回调,上报最新的音频或视频状态,以及状态变化的原因。 ### 上下行网络质量报告 [#上下行网络质量报告-1] `onNetworkQuality` 回调上报当前通话中每个用户(`ChannelProfileCommunication` 场景)或主播(`ChannelProfileLiveBroadcasting` 场景)的上下行 last mile 网络质量,详见[质量打分](#rate)。其中: - last mile 是指你的设备到声网边缘服务器的网络。 - 上行 last mile 网络质量打分基于实际发送码率、上行网络丢包率、平均往返时延和上行网络抖动计算。 - 下行 last mile 网络质量打分基于下行网络丢包率、平均往返时延和下行网络抖动计算。 :::info[信息] - 实际发送码率与目标发送码率的比值越高,该网络下的通话质量越好,该网络质量打分越高。 - 平均往返时延指的是多次往返时延的平均值。 ::: ### 统计信息报告 [#统计信息报告-4] `onRtcStats` 回调每 2 秒触发一次,上报本地通话统计信息。你可以了解到通话时长、当前通话频道中的人数、当前系统的 CPU 使用率、当前 App 的 CPU 使用率等重要参数。 ### 音频质量报告 [#音频质量报告-4] 音频质量报告包括本地音频流统计信息报告、本地音频流状态监控、远端音频流统计信息报告和远端音频流状态监控。 #### 本地音频流统计信息报告 [#本地音频流统计信息报告-4] `onLocalAudioStats` 回调每 2 秒触发一次,上报本地设备发送音频流的统计信息。你可以了解到以下重要统计信息: - 当前通话声道数 - 发送音频的采样率 - 发送音频码率的平均值 #### 本地音频流状态监控 [#本地音频流状态监控-4] 本地音频的状态发生改变时,如音频录制状态和音频编码状态发生改变,SDK 会触发 `onLocalAudioStateChanged` 回调上报当前本地音频状态。当本地音频出现故障时,你可以通过错误码排查问题。 #### 远端音频流统计信息报告 [#远端音频流统计信息报告-4] `onRemoteAudioStats` 回调每 2 秒触发一次,上报当前通话中每个远端用户(`ChannelProfileCommunication` 场景)或远端主播(`ChannelProfileLiveBroadcasting` 场景)音频流的统计信息,包括远端发送的音频流质量(详见[质量打分](#rate))、声道数等重要参数信息。 `onRemoteAudioStats` 侧重报告远端音频流的全链路音频质量,更贴近你的主观感受。即使网络发生丢包,但由于 FEC(Forward Error Correction)、重传恢复和带宽估计等**抗丢包**和拥塞控制技术,最终在接收端的音频丢帧率也可能不高,所以你感知到的音频质量较好。 #### 远端音频流状态监控 [#远端音频流状态监控-4] 远端用户(`ChannelProfileCommunication` 场景)或远端主播(`ChannelProfileLiveBroadcasting` 场景)的音频流状态改变时,SDK 会触发 `onRemoteAudioStateChanged` 回调上报远端音频流当前状态和状态改变的原因。 ### 视频质量报告 [#视频质量报告-4] 视频质量报告包括本地视频流统计信息报告、本地视频流状态监控、远端视频流统计信息报告和远端视频流状态监控。 #### 本地视频流统计信息报告 [#本地视频流统计信息报告-4] `onLocalVideoStats` 回调上报本地设备发送视频流的统计信息,包括视频编码宽/高、目标编码率、发送视频的码率等重要参数信息。 :::info[信息] 如果你此前调用 `enableDualStreamMode` 方法开启了双流模式,则本回调描述本地设备发送的视频大流的统计信息。 ::: #### 本地视频流状态监控 [#本地视频流状态监控-4] 本地视频的状态发生改变时,SDK 会触发 `onLocalVideoStateChanged` 回调上报当前本地视频状态。当本地视频出现故障时,你可以通过错误码排查问题。 #### 远端视频流统计信息报告 [#远端视频流统计信息报告-4] `onRemoteVideoStats` 回调上报当前通话中每个远端用户(`ChannelProfileCommunication` 场景)或远端主播(`ChannelProfileLiveBroadcasting` 场景)视频流的统计信息。你可以了解到每个远端用户或远端主播的视频宽/高、接收视频的码率等重要参数信息。 #### 远端视频流状态监控 [#远端视频流状态监控-4] 远端用户(`ChannelProfileCommunication` 场景)或远端主播(`ChannelProfileLiveBroadcasting` 场景)的视频流状态改变时,SDK 会触发 `onRemoteVideoStateChanged` 回调上报远端视频流当前状态和状态改变的原因。 ## 前提条件 [#前提条件-5] 请确保你的项目中已实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-5] 在 `IRtcEngineEventHandler` 中,实现以下实时互动质量统计信息回调和音频或视频状态监控回调,从而了解用户互动体验: - `onNetworkQuality`:报告上下行 last mile 网络质量。 - `onRtcStats`:报告实时互动统计信息。 - `onLocalAudioStats`:报告发送的音频流的统计信息。 - `onLocalAudioStateChanged`:报告本地音频流状态监控。 - `onRemoteAudioStats`:报告接收的远端音频流统计信息。 - `onRemoteAudioStateChanged`:报告远端音频流状态监控。 - `onLocalVideoStats`:报告发送的视频流统计信息。 - `onLocalVideoStateChanged`:报告本地视频流状态监控。 - `onRemoteVideoStats`:报告接收的远端视频流统计信息。 - `onRemoteVideoStateChanged`:报告远端视频流状态监控。 ```typescript const EventHandles = { // 报告实时互动统计信息 onRtcStats: (connection, state) => { console.log(`connection:${connection}, state:${state}`); }, // 报告发送的音频流的统计信息。 onLocalAudioStats: (connection, state) => { console.log(`connection:${connection}, state:${state}`); }, // 报告本地音频流状态监控。 onLocalAudioStateChanged: (connection, state, error) => { console.log(`connection:${connection}, state:${state}, error:${error}`); }, // 报告接收的远端音频流统计信息。 onRemoteAudioStats: (connection, state) => { console.log(`connection:${connection}, state:${state}`); }, // 报告远端音频流状态监控。 onRemoteAudioStateChanged: ( connection, remoteUid, state, reason, elapsed ) => { console.log( `connection:${connection},remoteUid:${remoteUid}, state:${state}, reason:${reason}, elapsed:${elapsed}` ); }, // 报告发送的视频流统计信息。 onLocalVideoStats: (source, stats) => { console.log(`source:${source}, stats:${stats}`); }, // 报告本地视频流状态监控。 onLocalVideoStateChanged: (source, state, error) => { console.log(`source:${source}, state:${state}, error:${error}`); }, // 报告接收的远端视频流统计信息。 onRemoteVideoStats: (connection, stats) => { console.log(`connection:${connection}, stats:${stats}`); }, // 报告远端视频流状态监控。 onRemoteVideoStateChanged: ( connection, remoteUid, state, reason, elapsed ) => { console.log( `connection:${connection},remoteUid:${remoteUid}, state:${state}, reason:${reason}, elapsed:${elapsed}` ); }, }; // 注册事件回调 let rtcEngine = createAgoraRtcEngine(); rtcEngine.registerEventHandler(EventHandles); ``` ## 参考信息 [#参考信息-4] ### API 参考 [#api-参考-4] - [`onNetworkQuality`](/zh-CN/api-reference/rtc/electron/network#callback_irtcengineeventhandler_onnetworkquality) - [`onRtcStats`](/zh-CN/api-reference/rtc/electron/channel#callback_irtcengineeventhandler_onrtcstats) - [`onLocalAudioStats`](/zh-CN/api-reference/rtc/electron/audio/audio-basic#callback_irtcengineeventhandler_onlocalaudiostats) - [`onLocalAudioStateChanged`](/zh-CN/api-reference/rtc/electron/audio/audio-basic#callback_irtcengineeventhandler_onlocalaudiostatechanged) - [`onRemoteAudioStats`](/zh-CN/api-reference/rtc/electron/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats) - [`onRemoteAudioStateChanged`](/zh-CN/api-reference/rtc/electron/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) - [`onLocalVideoStats`](/zh-CN/api-reference/rtc/electron/video/video-basic#callback_irtcengineeventhandler_onlocalvideostats) - [`onLocalVideoStateChanged`](/zh-CN/api-reference/rtc/electron/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) - [`onRemoteVideoStats`](/zh-CN/api-reference/rtc/electron/video/video-basic#callback_irtcengineeventhandler_onremotevideostats) - [`onRemoteVideoStateChanged`](/zh-CN/api-reference/rtc/electron/video/video-basic#callback_irtcengineeventhandler_onremotevideostatechanged) ### 质量打分 [#质量打分-4] | 代码 | 描述 | | :---------------------- | :----------------------------------------------------------- | | `QualityUnknown`(0) | 网络质量未知。 | | `QualityExcellent`(1) | 网络质量极好。 | | `QualityGood`(2) | 用户主观感觉和 `QualityExcellent`(1) 差不多,但码率可能略低于 `QualityExcellent`(1)。 | | `QualityPoor`(3) | 用户主观感受有瑕疵但不影响沟通。 | | `QualityBad`(4) | 勉强能沟通但不顺畅。 | | `QualityVbad`(5) | 网络质量非常差,基本不能沟通。 | | `QualityDown`(6) | 完全无法沟通。 |