通话中质量监测

功能描述

Agora Web SDK 支持获取以下统计数据来检测通话质量：

• Last mile 上下行网络质量
• 当前通话的统计数据
• 本地轨道的统计数据
• 远端轨道的统计数据
• 频道内的异常事件

实现方法

开始前，请确保你已参考快速开始在你的项目中实现基本的实时音视频功能。

Last mile 上下行网络质量

Last mile 是指你的设备到 Agora 边缘服务器的网络。

本地用户加入频道后，SDK 会每 2 秒触发一次 AgoraRTCClient.on("network-quality") 回调报告本地用户的上下行 last-mile 网络质量打分。

你还可以通过 AgoraRTCClient.getRemoteNetworkQuality 方法获取本地订阅的所有远端用户的上下行 last-mile 网络质量打分。

质量打分对照表如下：

client.on("network-quality", (stats) => {
    console.log("downlinkNetworkQuality", stats.downlinkNetworkQuality);
    console.log("uplinkNetworkQuality", stats.uplinkNetworkQuality);
});

const remoteNetworkQuality = client.getRemoteNetworkQuality();

获取当前通话的统计数据

调用 AgoraRTCClient.getRTCStats 方法获取与当前通话的统计数据，数据说明详见 AgoraRTCStats。

const clientStats = client.getRTCStats();

获取本地音视频轨道的统计数据

调用 AgoraRTCClient.getLocalAudioStats 和 AgoraRTCClient.getLocalVideoStats 方法分别获取本地发布的音频轨道和视频轨道的统计数据。数据说明详见 LocalAudioTrackStats 和 LocalVideoTrackStats。

const localStats = {
  video: client.getLocalVideoStats(),
  audio: client.getLocalAudioStats()
};

获取远端音视频轨道的统计数据

调用 AgoraRTCClient.getRemoteAudioStats 和 AgoraRTCClient.getRemoteVideoStats 方法获取订阅的远端音频轨道和远端视频轨道的统计数据。其中，你可参考下图理解 end2EndDelay、receiveDelay 和 transportDelay 字段，其他数据说明详见 RemoteAudioTrackStats 和 RemoteVideoTrackStats。

const remoteTracksStats = {
  video: client.getRemoteVideoStats()[uid],
  audio: client.getRemoteAudioStats()[uid]
};

关注频道内的异常事件

SDK 通过 AgoraRTCClient.on("exception") 回调报告频道内的异常事件。异常事件不是错误，但是往往会引起通话质量问题。发生异常事件后，如果恢复正常，也会收到该回调。该回调返回：

• code：事件码。
• msg：提示消息。
• uid：发生异常或恢复的用户 UID。

client.on("exception", function(evt) {
  console.log(evt.code, evt.msg, evt.uid);
})

每个异常事件都有对应的恢复事件，详见下表：

开发注意事项

上述所有方法必须在成功加入频道之后调用。