# AudioVolumeInfo (/zh-CN/api-reference/rtc/unreal-cpp/class-audiovolumeinfo)

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

<a id="class_audiovolumeinfo__prototype"></a>

```cpp
struct AudioVolumeInfo {
                    uid_t uid;
                    unsigned int volume;
                    unsigned int vad;
                    double voicePitch;
                    AudioVolumeInfo() : uid(0), volume(0), vad(0), voicePitch(0.0) {}
                    };
```

<a id="class_audiovolumeinfo__parameters"></a>

## 属性 [#属性]

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

用户 ID。

<a id="class_audiovolumeinfo__ul_pfj_4dt_rqb"></a>

- 在本地用户的回调中，uid 为 0。
- 在远端用户的回调中，uid 为瞬时音量最高的远端用户（最多 3 位）的 ID。

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

用户的音量，取值范围为 [0,255]。如果用户将自己静音（将 [muteLocalAudioStream](/zh-CN/api-reference/rtc/unreal-cpp/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 设为 `true`），但开启了音频采集，volume 的值表示本地采集信号的音量。如果用户调用了 [startAudioMixing [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/play/audio-mixing#api_irtcengine_startaudiomixing2)，则 volume 为用户混音后的音量。

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

本地用户的人声状态。

- 0：本地无人声。
- 1：本地有人声。

:::caution
注意：

- vad 无法报告远端用户的人声状态。对于远端用户，vad 的值始终为 1。
- 如需使用此参数，请在调用 [enableAudioVolumeIndication](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 时设置 reportVad 为 `true`。
:::

</Parameter>
<a id="voicepitch"></a>
<Parameter name="voicePitch">

本地用户的人声音调（Hz）。取值范围为 [0.0,4000.0]。

:::caution
注意： voicePitch 无法报告远端用户的人声音调。对于远端用户，voicePitch 的值始终为 0.0。
:::

</Parameter>
</ParameterList>