human: 如何处理七牛云的实时音视频通话质量统计

gpt: [实时音视频](https://developer.qiniu.com/rtc) > 使用指南 > Uniapp >通话质量统计

#  通话质量统计

最近更新时间: 2023-12-18 15:13:20

本文主要介绍 SDK 如何对通话过程中的网络以及音视频的质量进行监控。

> 获取通话中的质量监测信息前，请确保您已经**加入了房间** 并且**已经发布或订阅了相关的音视频 Track** 。

# 上下行网络质量

### 获取上下行网络质量

在**加入了房间** 并且**已经发布或者订阅了音视频 Track 后** ，可通过主动调用
[QNRTCClient.getUserNetworkQuality](https://developer.qiniu.com/rtc/11402/UniappQNRTCClient#getUserNetworkQuality)
获取上下行网络质量，这里需要传入目标 **userID** 。

其中，获取到的质量等级可参考
[QNNetworkGrade](https://developer.qiniu.com/rtc/11414/UniappQNNetworkGrade)。

# 音频质量统计

### 获取本地音频质量统计

SDK 质量统计接口均为**主动调用接口** ，您可以在适当的时机通过调用
[QNRTCClient.getLocalAudioTrackStats](https://developer.qiniu.com/rtc/11402/UniappQNRTCClient#getLocalAudioTrackStats)
接口获取当前本地的音频质量统计信息，并通过 trackID 来获取对应轨道的质量统计。获取到的质量统计内容
[QNLocalAudioTrackStats](https://developer.qiniu.com/rtc/11845/quality-
statistics-uniapp/rtc/11420/UniappQNLocalAudioTrackStats) 主要包含如下信息：

属性| 描述  
---|---  
uplinkBitrate| 本地音频上行的码率，单位 bps  
uplinkRTT| 本地音频上行的网络延时，单位 ms  
uplinkLostRate| 本地音频上行的丢包率，范围 [0, 100]  
  
### 获取远端音频质量统计

SDK 质量统计接口均为**主动调用接口** ，您可以在适当的时机通过调用
[QNRTCClient.getRemoteAudioTrackStats](https://developer.qiniu.com/rtc/11402/UniappQNRTCClient#getRemoteAudioTrackStats)
接口获取当前远端的音频质量统计信息，并通过 trackID 来获取对应轨道的质量统计。获取到的质量统计内容
[QNRemoteAudioTrackStats](https://developer.qiniu.com/rtc/11384/UniappQNRemoteAudioTrackStats)
主要包含如下信息：

属性| 描述  
---|---  
downlinkBitrate| 本地拉取远端音频时下行的码率，单位 bps  
downlinkLostRate| 本地拉取远端音频时下行的丢包率，范围 [0, 100]  
uplinkRTT| 远端音频上行的网络延时，单位 ms  
uplinkLostRate| 远端音频上行的丢包率，范围 [0, 100]  
  
# 视频质量统计

## 获取本地视频质量统计

SDK 质量统计接口均为**主动调用接口** ，您可以在适当的时机通过调用
[QNRTCClient.getLocalVideoTrackStats](https://developer.qiniu.com/rtc/11402/UniappQNRTCClient#getLocalVideoTrackStats)
接口获取当前本地的视频质量统计信息，并通过 trackID 来获取对应轨道的质量统计。获取到的质量统计内容
[QNLocalVideoTrackStats](https://developer.qiniu.com/rtc/11389/UniappQNLocalVideoTrackStats)
主要包含如下信息：

属性| 描述  
---|---  
profile|
当前所统计视频的[质量等级](https://developer.qiniu.com/rtc/11427/UniappQNTrackProfile)，profile
说明亦可参考[视频大小流](https://developer.qiniu.com/rtc/11844/video-size-flow-uniapp)文档  
uplinkFrameRate| 本地视频上行的帧率  
uplinkBitrate| 本地视频上行的码率，单位 bps  
uplinkRTT| 本地视频上行的网络延时，单位 ms  
uplinkLostRate| 本地视频上行的丢包率，范围 [0, 100]  
uplinkFrameWidth| 近端上行视频帧的宽度  
uplinkFrameHeight| 近端上行视频帧的高度  
captureFrameRate| 本地采集的视频帧率，单位 fps  
captureFrameWidth| 本地采集的视频帧宽度  
captureFrameHeight| 本地采集的视频帧高度  
targetFrameRate| 期望的视频编码帧率，单位 fps  
targetFrameWidth| 期望的视频编码宽度  
targetFrameHeight| 期望的视频编码高度  
  
## 获取远端视频质量统计

SDK 质量统计接口均为**主动调用接口** ，您可以在适当的时机通过调用
[QNRTCClient.getRemoteVideoTrackStats](https://developer.qiniu.com/rtc/11402/UniappQNRTCClient#getRemoteVideoTrackStats)
接口获取当前远端的视频质量统计信息，并通过 trackID 来获取对应轨道的质量统计。获取到的质量统计内容
[QNRemoteVideoTrackStats](https://developer.qiniu.com/rtc/11428/UniappQNRemoteVideoTrackStats)
主要包含如下信息：

属性| 描述  
---|---  
profile|
当前订阅的视频的[质量等级](https://developer.qiniu.com/rtc/11427/UniappQNTrackProfile)，profile
说明亦可参考[视频大小流](https://developer.qiniu.com/rtc/11844/video-size-flow-uniapp)文档  
downlinkFrameRate| 本地拉取远端视频时下行的帧率  
downlinkBitrate| 本地拉取远端视频时下行的码率，单位 bps  
downlinkLostRate| 本地拉取远端视频时下行的丢包率，范围 [0, 100]  
uplinkRTT| 远端视频上行的网络延时，单位 ms  
uplinkLostRate| 远端视频上行的丢包率，范围 [0, 100]  
uplinkFrameWidth| 远端上行视频帧宽度  
uplinkFrameHeight| 远端上行视频帧高度  
  
以上内容是否对您有帮助？