setAudioEffectPreset method
- AudioEffectPreset preset
设置 SDK 预设的人声音效。
自从 v3.2.1
调用该方法可以为本地发流用户设置 SDK 预设的人声音效,且不会改变原声的性别特征。设置音效后,频道内所有用户都能听到该效果。
根据不同的场景,你可以为用户设置不同的音效,各音效的适用场景可参考《美声与音效》。
为获取更好的人声效果,Agora 推荐你在调用该方法前将 RtcEngine.setAudioProfile 的 scenario
设为 GameStreaming(3)
。
Note
- 该方法在加入频道前后都能调用。
- 请勿将
setAudioProfile
的profile
参数设置为SpeechStandard(1)
,否则该方法会调用失败。 - 该方法对人声的处理效果最佳,Agora 不推荐调用该方法处理含音乐的音频数据。
- 如果调用该方法并设置除
RoomAcoustics3DVoice
或PitchCorrection
外的枚举,请勿再调用setAudioEffectParameters
,否则该方法设置的效果会被覆盖。 - 调用该方法后,Agora 不推荐调用以下方法,否则该方法设置的效果会被覆盖:
Parameter preset
预设的音效选项: AudioEffectPreset。
Implementation
@override
Future<void> setAudioEffectPreset(AudioEffectPreset preset) {
return _invokeMethod('setAudioEffectPreset',
{'preset': AudioEffectPresetConverter(preset).value()});
}