FAudioVolumeInfo

用户音量信息。

C++

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 {
}
};

uid

用户 ID。

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

volume

用户的音量，取值范围为 [0,255]。如果用户将自己静音（将 MuteLocalAudioStream 设为 true），但开启了音频采集，volume 的值表示本地采集信号的音量。如果用户调用了 StartAudioMixing，则 volume 为用户混音后的音量。

vad

本地用户的人声状态。

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

注意

• vad 无法报告远端用户的人声状态。对于远端用户，vad 的值始终为 1。
• 如需使用此参数，请在调用 EnableAudioVolumeIndication 时设置 reportVad 为 true。

voicePitch

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

注意

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