Agora Java API Reference for Android
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 |
远端用户发送的音频流质量：
- QUALITY_UNKNOWN(0): 质量未知
- QUALITY_EXCELLENT(1): 质量极好
- QUALITY_GOOD(2): 用户主观感觉和极好差不多 ，但码率可能略低于极好
- QUALITY_POOR(3): 用户主观感受有瑕疵，但不影响沟通
- QUALITY_BAD(4): 勉强能沟通但不顺畅
- QUALITY_VBAD(5): 网络质量非常差，基本不能沟通
- QUALITY_DOWN(6): 网络连接已断开，完全无法沟通
- QUALITY_DETECTING(8)：网络质量探测中
◆ 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 |
◆ 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 分 | 音频质量非常差，杂音频现，大量语义丢失，完全无法交流。 |
