AgoraRtcRemoteAudioStats
远端用户的音频统计数据。
__attribute__((visibility("default"))) @interface AgoraRtcRemoteAudioStats : NSObject @property(assign, nonatomic) NSUInteger uid; @property(assign, nonatomic) NSUInteger quality; @property(assign, nonatomic) NSUInteger networkTransportDelay; @property(assign, nonatomic) NSUInteger jitterBufferDelay; @property(assign, nonatomic) NSUInteger audioLossRate; @property(assign, nonatomic) NSUInteger numChannels; @property(assign, nonatomic) NSUInteger receivedSampleRate; @property(assign, nonatomic) NSUInteger receivedBitrate; @property(assign, nonatomic) NSUInteger totalFrozenTime; @property(assign, nonatomic) NSUInteger totalActiveTime; @property(assign, nonatomic) NSInteger publishDuration; @property(assign, nonatomic) NSUInteger frozenRate; @property(assign, nonatomic) NSUInteger mosValue; @property(assign, nonatomic) NSInteger qoeQuality; @property(assign, nonatomic) AgoraExperiencePoorReason qualityChangedReason; @end
属性
- uid
- 远端用户的用户 ID。
- quality
-
远端用户发送的音频流质量。详见 AgoraNetworkQuality。
- networkTransportDelay
- 音频发送端到接收端的网络延迟(毫秒)。
- jitterBufferDelay
-
音频接收端到网络抖动缓冲的网络延迟(毫秒)。
- audioLossRate
- 统计周期内的远端音频流的丢帧率 (%)。
- numChannels
- 声道数。
- receivedSampleRate
- 统计周期内接收到的远端音频流的采样率。
- receivedBitrate
- 接收到的远端音频流在统计周期内的平均码率(Kbps)。
- totalFrozenTime
- 远端用户在加入频道后发生音频卡顿的累计时长(毫秒)。通话过程中,音频丢帧率达到 4% 即记为一次音频卡顿。
- frozenRate
- 音频卡顿的累计时长占音频总有效时长的百分比 (%)。音频有效时长是指远端用户加入频道后音频未被停止发送或禁用的时长。
- totalActiveTime
-
远端用户在音频通话开始到本次回调之间的有效时长(毫秒)。
有效时长是指去除了远端用户进入静音状态的总时长。
- publishDuration
-
远端音频流的累计发布时长(毫秒)。
- qoeQuality
-
接收远端音频时,本地用户的主观体验质量。详见 AgoraExperienceQuality。
- qualityChangedReason
-
接收远端音频时,本地用户主观体验质量较差的原因。详见 AgoraExperiencePoorReason。
- mosValue
-
统计周期内,声网实时音频 MOS(平均主观意见分)评估方法对接收到的远端音频流的质量评分。返回值范围为 [0,500]。返回值除以 100 即可得到 MOS 分数,范围为 [0,5] 分,分数越高,音频质量越好。
声网实时音频 MOS 评分对应的主观音质感受如下:MOS 分数 音质感受 大于 4 分 音频质量佳,清晰流畅。 3.5 - 4 分 音频质量较好,偶有音质损伤,但依然清晰。 3 - 3.5 分 音频质量一般,偶有卡顿,不是非常流畅,需要一点注意力才能听清。 2.5 - 3 分 音频质量较差,卡顿频繁,需要集中精力才能听清。 2 - 2.5 分 音频质量很差,偶有杂音,部分语义丢失,难以交流。 小于 2 分 音频质量非常差,杂音频现,大量语义丢失,完全无法交流。