setVoiceBeautifierParameters method
- VoiceBeautifierPreset preset,
- int param1,
- int param2
设置 SDK 预设美声效果的参数。
自从 v3.3.1
调用该方法可以设置歌唱美声效果的性别特征和混响效果。该方法对本地发流用户进行设置。设置后,频道内所有用户都能听到该效果。
为获取更好的人声效果,Agora 推荐你在调用该方法前将 RtcEngine.setAudioProfile 的 scenario
设为 GameStreaming(3)
,并将 profile
设为 MusicHighQuality(4)
或 MusicHighQualityStereo(5)
。
Parameter preset
SDK 预设的音效: VoiceBeautifierPreset.SingingBeautifier.
Parameter param1
歌声的性别特征:
1
: 男声。2
: 女声。
Parameter param2
歌声的混响效果:
1
: 歌声在小房间的混响效果。2
: 歌声在大房间的混响效果。3
: 歌声在大厅的混响效果。
Note
- 该方法在加入频道前后都能调用。
- 请勿将 RtcEngine.setAudioProfile 的
profile
参数设置为SpeechStandard(1)
,否则该方法不生效。 - 该方法对人声的处理效果最佳,Agora 不推荐调用该方法处理含音乐的音频数据。
- 调用该方法后,Agora 不推荐调用以下方法,否则该方法设置的效果会被覆盖:
Implementation
@override
Future<void> setVoiceBeautifierParameters(
VoiceBeautifierPreset preset, int param1, int param2) {
return _invokeMethod('setVoiceBeautifierParameters', {
'preset': VoiceBeautifierPresetConverter(preset).e,
'param1': param1,
'param2': param2
});
}