VoiceBeautifierPreset

The options for SDK preset voice beautifier effects.

Enumerator

voiceBeautifierOff
Turn off voice beautifier effects and use the original voice.
chatBeautifierMagnetic

A more magnetic voice.

Attention: Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may experience vocal distortion.
chatBeautifierFresh

A fresher voice.

Attention: Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion.
chatBeautifierVitality

A more vital voice.

Attention: Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion.
singingBeautifier

Singing beautifier effect.

  • If you call setVoiceBeautifierPreset(singingBeautifier), you can beautify a male-sounding voice and add a reverberation effect that sounds like singing in a small room. Agora recommends using this enumerator to process a male-sounding voice; otherwise, you might experience vocal distortion.
  • If you call setVoiceBeautifierParameters(singingBeautifier, param1, param2), you can beautify a male or female-sounding voice and add a reverberation effect.
timbreTransformationVigorous
A more vigorous voice.
timbreTransformationDeep
A deep voice.
timbreTransformationMellow
A mellower voice.
timbreTransformationFalsetto
Falsetto.
timbreTransformationFull
A fuller voice.
timbreTransformationClear
A clearer voice.
timbreTransformationResounding
A more resounding voice.
timbreTransformationRinging
A more ringing voice.
ultraHighQualityVoice
A ultra-high quality voice, which makes the audio clearer and restores more details.
  • To achieve better audio effect quality, Agora recommends that you set the profile of to audioProfileMusicHighQuality(4) or audioProfileMusicHighQualityStereo(5) and scenario to audioScenarioGameStreaming(3) before calling setVoiceBeautifierPreset.
  • If you have an audio capturing device that can already restore audio details to a high degree, Agora recommends that you do not enable ultra-high quality; otherwise, the SDK may over-restore audio details, and you may not hear the anticipated voice effect.