# RemoteAudioStats (/zh-CN/api-reference/rtc/unreal-cpp/class-remoteaudiostats)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="class_remoteaudiostats__prototype"></a>

```cpp
struct RemoteAudioStats
{
  uid_t uid;
  int quality;
  int networkTransportDelay;
  int jitterBufferDelay;
  int audioLossRate;
  int numChannels;
  int receivedSampleRate;
  int receivedBitrate;
  int totalFrozenTime;
  int frozenRate;
  int mosValue;
  int totalActiveTime;
  int publishDuration;
  int qoeQuality;
  int qualityChangedReason;
  int e2eDelay;

  RemoteAudioStats() :
    uid(0),
    quality(0),
    networkTransportDelay(0),
    jitterBufferDelay(0),
    audioLossRate(0),
    numChannels(0),
    receivedSampleRate(0),
    receivedBitrate(0),
    totalFrozenTime(0),
    frozenRate(0),
    mosValue(0),
    totalActiveTime(0),
    publishDuration(0),
    qoeQuality(0)
    qualityChangedReason(0)
    e2eDelay(0) {}
};
```

<a id="class_remoteaudiostats__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="uid"></a>
<Parameter name="uid">

远端用户的用户 ID。

</Parameter>
<a id="quality"></a>
<Parameter name="quality">

远端用户发送的音频流质量。详见 [QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-qualitytype)。

</Parameter>
<a id="networktransportdelay"></a>
<Parameter name="networkTransportDelay">

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

</Parameter>
<a id="jitterbufferdelay"></a>
<Parameter name="jitterBufferDelay">

音频接收端到网络抖动缓冲的网络延迟（毫秒）。

:::caution
注意： 当接收端为观众且 [ClientRoleOptions](/zh-CN/api-reference/rtc/unreal-cpp/class-clientroleoptions) 的 audienceLatencyLevel 为 1 时，该参数不生效。
:::

</Parameter>
<a id="audiolossrate"></a>
<Parameter name="audioLossRate">

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

</Parameter>
<a id="numchannels"></a>
<Parameter name="numChannels">

声道数。

</Parameter>
<a id="receivedsamplerate"></a>
<Parameter name="receivedSampleRate">

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

</Parameter>
<a id="receivedbitrate"></a>
<Parameter name="receivedBitrate">

接收到的远端音频流在统计周期内的平均码率（Kbps）。

</Parameter>
<a id="totalfrozentime"></a>
<Parameter name="totalFrozenTime">

远端用户在加入频道后发生音频卡顿的累计时长（毫秒）。通话过程中，音频丢帧率达到 4% 即记为一次音频卡顿。

</Parameter>
<a id="frozenrate"></a>
<Parameter name="frozenRate">

音频卡顿的累计时长占音频总有效时长的百分比 (%)。音频有效时长是指远端用户加入频道后音频未被停止发送或禁用的时长。

</Parameter>
<a id="totalactivetime"></a>
<Parameter name="totalActiveTime">

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

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

</Parameter>
<a id="publishduration"></a>
<Parameter name="publishDuration">

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

</Parameter>
<a id="qoequality"></a>
<Parameter name="qoeQuality">

接收远端音频时，本地用户的主观体验质量。详见 [EXPERIENCE_QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-experiencequalitytype)。

</Parameter>
<a id="qualitychangedreason"></a>
<Parameter name="qualityChangedReason">

接收远端音频时，本地用户主观体验质量较差的原因。详见 [EXPERIENCE_POOR_REASON](/zh-CN/api-reference/rtc/unreal-cpp/enum-experiencepoorreason)。

</Parameter>
<a id="mosvalue"></a>
<Parameter name="mosValue">

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

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

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

</Parameter>
<a id="e2edelay"></a>
<Parameter name="e2eDelay">

端到端音频延时（毫秒），即自远端用户音频采集起，至本地用户开始播放音频的总时长。

</Parameter>
</ParameterList>