AUDIO_EFFECT_PRESET

Preset audio effects.

To get better audio effects, Agora recommends calling SetAudioProfile [1/2] and setting the profile parameter as recommended below before using the preset audio effects.


Preset audio effects	profile
ROOM_ACOUSTICS_VIRTUAL_STEREO ROOM_ACOUSTICS_3D_VOICE ROOM_ACOUSTICS_VIRTUAL_SURROUND_SOUND	AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO or AUDIO_PROFILE_MUSIC_STANDARD_STEREO
Other preset audio effects (except for AUDIO_EFFECT_OFF)	AUDIO_PROFILE_MUSIC_HIGH_QUALITY or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO

Enumerator

AUDIO_EFFECT_OFF: Turn off voice effects, that is, use the original voice.
ROOM_ACOUSTICS_KTV: The voice effect typical of a KTV venue.
ROOM_ACOUSTICS_VOCAL_CONCERT: The voice effect typical of a concert hall.
ROOM_ACOUSTICS_STUDIO: The voice effect typical of a recording studio.
ROOM_ACOUSTICS_PHONOGRAPH: The voice effect typical of a vintage phonograph.
ROOM_ACOUSTICS_VIRTUAL_STEREO: The virtual stereo effect, which renders monophonic audio as stereo audio.
ROOM_ACOUSTICS_SPACIAL: A more spatial voice effect.
ROOM_ACOUSTICS_ETHEREAL: A more ethereal voice effect.
ROOM_ACOUSTICS_VIRTUAL_SURROUND_SOUND: Virtual surround sound, that is, the SDK generates a simulated surround sound field on the basis of stereo channels, thereby creating a surround sound effect.
Attention: If the virtual surround sound is enabled, users need to use stereo audio playback devices to hear the anticipated audio effect.
ROOM_ACOUSTICS_CHORUS: The audio effect of chorus. Agora recommends using this effect in chorus scenarios to enhance the sense of depth and dimension in the vocals.
ROOM_ACOUSTICS_3D_VOICE: A 3D voice effect that makes the voice appear to be moving around the user. The default cycle period is 10 seconds. After setting this effect, you can call SetAudioEffectParameters to modify the movement period.

Attention: If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect.
VOICE_CHANGER_EFFECT_UNCLE: A middle-aged man's voice.

Attention: Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.
VOICE_CHANGER_EFFECT_OLDMAN: An older man's voice.

Attention: Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.
VOICE_CHANGER_EFFECT_BOY: A boy's voice.

Attention: Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.
VOICE_CHANGER_EFFECT_SISTER: A young woman's voice.

Attention: Agora recommends using this preset to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect.
VOICE_CHANGER_EFFECT_GIRL: A girl's voice.

Attention: Agora recommends using this preset to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect.
VOICE_CHANGER_EFFECT_PIGKING: The voice of Pig King, a character in Journey to the West who has a voice like a growling bear.
VOICE_CHANGER_EFFECT_HULK: The Hulk's voice.
STYLE_TRANSFORMATION_RNB: The voice effect typical of R&B music.
STYLE_TRANSFORMATION_POPULAR: The voice effect typical of popular music.
PITCH_CORRECTION: A pitch correction effect that corrects the user's pitch based on the pitch of the natural C major scale. After setting this voice effect, you can call SetAudioEffectParameters to adjust the basic mode of tuning and the pitch of the main tone.