文档中心
互动直播
Agora.io 社区
中文
search-icon
Agora Java API Reference for Android
概览 RtcEngine IRtcEngineEventHandler RtcChannel IRtcChannelEventHandler

Public 属性

int uid
 
int quality
 
int networkTransportDelay
 
int jitterBufferDelay
 
int audioLossRate
 
int numChannels
 
int receivedSampleRate
 
int receivedBitrate
 
int totalFrozenTime
 
int frozenRate
 
int totalActiveTime
 
int publishDuration
 
int qoeQuality
 
int qualityChangedReason
 
int mosValue
 

详细描述

远端音频统计信息。

类成员变量说明

◆ uid

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.uid

用户 ID，指定是哪个用户/主播的音频流。

◆ quality

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.quality

远端用户发送的音频流质量：

  • 0: 质量未知
  • 1: 质量极好
  • 2: 用户主观感觉和极好差不多 ，但码率可能略低于极好
  • 3: 用户主观感受有瑕疵，但不影响沟通
  • 4: 勉强能沟通但不顺畅
  • 5: 网络质量非常差，基本不能沟通
  • 6: 网络连接已断开，完全无法沟通

◆ networkTransportDelay

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.networkTransportDelay

音频发送端到接收端的网络延迟（毫秒）。

◆ jitterBufferDelay

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.jitterBufferDelay

接收端到网络抖动缓冲的网络延迟 (ms)。

注解
当接收端为观众且 audienceLatencyLevel 为 1 时，该参数不生效。

◆ audioLossRate

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.audioLossRate

统计周期内的远端音频流的丢帧率 (%)。

◆ numChannels

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.numChannels

声道数。

自从
v2.8.0。

◆ receivedSampleRate

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.receivedSampleRate

统计周期内接收到的远端音频采样率（Hz）。

自从
v2.8.0。

◆ receivedBitrate

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.receivedBitrate

接收流在统计周期内的平均码率（Kbps）。

自从
v2.8.0。

◆ totalFrozenTime

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.totalFrozenTime

远端用户在加入频道后发生音频卡顿的累计时长 (ms)。

一个统计周期内，音频丢帧率达到 4% 即记为一次音频卡顿。

自从
v2.8.0。

◆ frozenRate

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.frozenRate

远端用户在加入频道后发生音频卡顿的累计时长占音频总有效时长的百分比 (%)。

自从
v2.8.0。 音频有效时长是指远端用户加入频道后音频未被停止发送或禁用的时长。

◆ totalActiveTime

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.totalActiveTime

远端用户在音频通话开始到本次回调之间的有效时长（ms）。

自从
v3.0.0。

有效时长是指去除了远端用户进入mute状态的总时长。

◆ publishDuration

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.publishDuration

远端音频流的累计发布时长（毫秒）。

自从
v3.1.0。

◆ qoeQuality

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.qoeQuality

接收远端音频时，本地用户的主观体验质量。

自从
v3.3.0。

◆ qualityChangedReason

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.qualityChangedReason

接收远端音频时，本地用户主观体验质量较差的原因。

自从
v3.3.0。

◆ mosValue

int io.agora.rtc.IRtcEngineEventHandler.RemoteAudioStats.mosValue

统计周期内，Agora 实时音频 MOS（平均主观意见分）评估方法对接收到的远端音频流的质量评分。返回值范围为 [0,500]。返回值除以 100 即可得到 MOS 分数，范围为 [0,5] 分，分数越高，音频质量越好。

自从
v3.3.1。

Agora 实时音频 MOS 评分对应的主观音质感受如下：

MOS 分数 音质感受
大于 4 分 音频质量佳，清晰流畅。
3.5 - 4 分 音频质量较好，偶有音质损伤，但依然清晰。
3 - 3.5 分 音频质量一般，偶有卡顿，不是非常流畅，需要一点注意力才能听清。
2.5 - 3 分 音频质量较差，卡顿频繁，需要集中精力才能听清。
2 - 2.5 分 音频质量很差，偶有杂音，部分语义丢失，难以交流。
小于 2 分 音频质量非常差，杂音频现，大量语义丢失，完全无法交流。