# FAudioVolumeInfo (/zh-CN/api-reference/rtc/unreal-blueprint/class-audiovolumeinfo)

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

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

```cpp
USTRUCT(BlueprintType)
struct FAudioVolumeInfo {
	GENERATED_BODY()
public:
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioVolumeInfo")
	int64 uid = 0;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioVolumeInfo")
	int64 volume = 0;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioVolumeInfo")
	int64 vad = 0;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioVolumeInfo")
	float voicePitch = 0;
	FAudioVolumeInfo(){}
	FAudioVolumeInfo(const agora::rtc::AudioVolumeInfo & AgoraData){
		uid = AgoraData.uid;
		volume = AgoraData.volume;
		vad = AgoraData.vad;
		voicePitch = AgoraData.voicePitch;
	}
	agora::rtc::AudioVolumeInfo CreateAgoraData() const {
		agora::rtc::AudioVolumeInfo AgoraData;
		AgoraData.uid = uid;
		AgoraData.volume = volume;
		AgoraData.vad = vad;
		AgoraData.voicePitch = voicePitch;
		return AgoraData;
	}
	void FreeAgoraData(agora::rtc::AudioVolumeInfo & AgoraData) const {
	}

};
```

<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-blueprint/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 设为 `true`），但开启了音频采集，volume 的值表示本地采集信号的音量。如果用户调用了 [StartAudioMixing](/zh-CN/api-reference/rtc/unreal-blueprint/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-blueprint/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>