Agora C++ API Reference for All Platforms
概览
IRtcEngine
IRtcEngineEventHandler
IChannel
IChannelEventHandler
IAudioDeviceManager
IVideoDeviceManager
Public 属性 | |
| uid_t | 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
| uid_t agora::rtc::RemoteAudioStats::uid |
用户 ID，指定是哪个用户/主播的音频流。
◆ quality
| int agora::rtc::RemoteAudioStats::quality |
远端用户发送的音频流质量 QUALITY_TYPE
◆ networkTransportDelay
| int agora::rtc::RemoteAudioStats::networkTransportDelay |
音频发送端到接收端的网络延迟（毫秒）。
◆ jitterBufferDelay
| int agora::rtc::RemoteAudioStats::jitterBufferDelay |
接收端到网络抖动缓冲的网络延迟（毫秒）。
- 注解
- 当接收端为观众且 AUDIENCE_LATENCY_LEVEL_TYPE 为
1时，该参数不生效。
◆ audioLossRate
| int agora::rtc::RemoteAudioStats::audioLossRate |
统计周期内的远端音频流的丢帧率 (%)。
◆ numChannels
| int agora::rtc::RemoteAudioStats::numChannels |
声道数。
◆ receivedSampleRate
| int agora::rtc::RemoteAudioStats::receivedSampleRate |
统计周期内接收到的远端音频采样率。
◆ receivedBitrate
| int agora::rtc::RemoteAudioStats::receivedBitrate |
接收流在统计周期内的平均码率（Kbps）。
◆ totalFrozenTime
| int agora::rtc::RemoteAudioStats::totalFrozenTime |
远端用户在加入频道后发生音频卡顿的累计时长（ms）。通话过程中，音频丢帧率达到 4% 即记为一次音频卡顿。
◆ frozenRate
| int agora::rtc::RemoteAudioStats::frozenRate |
远端用户在加入频道后发生音频卡顿的累计时长占音频总有效时长的百分比 (%)。音频有效时长是指远端用户加入频道后音频未被停止发送或禁用的时长。
◆ totalActiveTime
| int agora::rtc::RemoteAudioStats::totalActiveTime |
音频有效时长（毫秒），即远端用户/主播加入频道后，既没有停止发送音频流，也没有禁用音频模块的通话时长。
◆ publishDuration
| int agora::rtc::RemoteAudioStats::publishDuration |
远端音频流的累计发布时长（毫秒）。
◆ qoeQuality
| int agora::rtc::RemoteAudioStats::qoeQuality |
接收远端音频时，本地用户的主观体验质量，详见 EXPERIENCE_QUALITY_TYPE
- 自从
- v3.3.0
◆ qualityChangedReason
| int agora::rtc::RemoteAudioStats::qualityChangedReason |
接收远端音频时，本地用户主观体验质量较差的原因，详见 EXPERIENCE_POOR_REASON
- 自从
- v3.3.0
◆ mosValue
| int agora::rtc::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 分 | 音频质量非常差，杂音频现，大量语义丢失，完全无法交流。 |
