AUDIO_EFFECT_PRESET
Preset audio effects.
To achieve better audio effects, Agora recommends calling
setAudioProfile(AUDIO_PROFILE_TYPE profile, AUDIO_SCENARIO_TYPE scenario) before using preset audio effects, and setting the profile parameter as follows:
| Preset Audio Effect | 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 (excluding AUDIO_EFFECT_OFF) |
AUDIO_PROFILE_MUSIC_HIGH_QUALITY or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO |
Enumerations
- AUDIO_EFFECT_OFF
- (0x00000000): Turns off audio effects and uses the original sound.
- ROOM_ACOUSTICS_KTV
- (0x02010100): Typical audio effect for KTV scenes.
- ROOM_ACOUSTICS_VOCAL_CONCERT
- (0x02010200): Typical audio effect for concert hall scenes.
- ROOM_ACOUSTICS_STUDIO
- (0x02010300): Typical audio effect for studio scenes.
- ROOM_ACOUSTICS_PHONOGRAPH
- (0x02010400): Typical audio effect in the style of a vintage phonograph.
- ROOM_ACOUSTICS_VIRTUAL_STEREO
- (0x02010500): Virtual stereo effect that renders mono audio as stereo.
- ROOM_ACOUSTICS_SPACIAL
- (0x02010600): Audio effect that enhances spatial perception.
- ROOM_ACOUSTICS_ETHEREAL
- (0x02010700): Ethereal-style audio effect.
- ROOM_ACOUSTICS_3D_VOICE
- (0x02010800): 3D audio effect that makes the sound move around the user with a default cycle of 10 seconds. After setting this effect, you can call setAudioEffectParameters to modify the movement cycle.
Note: To enable this effect, you need to use stereo playback devices to achieve the expected audio effect.
- ROOM_ACOUSTICS_VIRTUAL_SURROUND_SOUND
- (0x02010900): Virtual surround sound that simulates surround sound fields based on stereo channels to create a surround effect.
Note: To enable this effect, you need to use stereo playback devices to achieve the expected audio effect.
- ROOM_ACOUSTICS_CHORUS
- (0x02010D00): Chorus audio effect, suitable for chorus scenes, enhancing vocal layering and spatial perception.
- VOICE_CHANGER_EFFECT_UNCLE
- (0x02020100): Voice of a middle-aged man.
Note: Agora recommends using it for processing male voices; otherwise, the expected audio effect may not be achieved.
- VOICE_CHANGER_EFFECT_OLDMAN
- (0x02020200): Voice of an elderly man.
Note: Agora recommends using it for processing male voices; otherwise, the expected audio effect may not be achieved.
- VOICE_CHANGER_EFFECT_BOY
- (0x02020300): Voice of a boy.
Note: Agora recommends using it for processing male voices; otherwise, the expected audio effect may not be achieved.
- VOICE_CHANGER_EFFECT_SISTER
- (0x02020400): Voice of a young woman.
Note: Agora recommends using it for processing female voices; otherwise, the expected audio effect may not be achieved.
- VOICE_CHANGER_EFFECT_GIRL
- (0x02020500): Voice of a girl.
Note: Agora recommends using it for processing female voices; otherwise, the expected audio effect may not be achieved.
- VOICE_CHANGER_EFFECT_PIGKING
- (0x02020600): Voice of Pigsy, similar to a bear roar effect.
- VOICE_CHANGER_EFFECT_HULK
- (0x02020700): Voice of the Hulk.
- STYLE_TRANSFORMATION_RNB
- (0x02030100): Typical audio effect in R&B music style.
- STYLE_TRANSFORMATION_POPULAR
- (0x02030200): Typical audio effect in pop music style.
- PITCH_CORRECTION
- (0x02040100): Pitch correction effect that adjusts the user's pitch based on the natural C major scale. After setting this effect, you can call setAudioEffectParameters to adjust the tuning mode and tonic pitch.