setVoiceBeautifierParameters abstract method

Future<void> setVoiceBeautifierParameters({
  1. required VoiceBeautifierPreset preset,
  2. required int param1,
  3. required int param2,
})

设置预设美声效果的参数。

调用该方法可以设置歌唱美声效果的性别特征和混响效果。该方法对本地发流用户进行设置。设置后，频道内所有用户都能听到该效果。 为获取更好的人声效果，建议你在调用该方法前进行以下操作： 调用 setAudioScenario 将音频场景设为高音质场景，即 audioScenarioGameStreaming (3)。 调用 setAudioProfile 将 profile 设为 audioProfileMusicHighQuality (4) 或 audioProfileMusicHighQualityStereo (5)。 该方法在加入频道前后都能调用。 请勿将 setAudioProfile 的 profile 参数设置为 audioProfileSpeechStandard (1) 或 audioProfileIot (6)，否则该方法不生效。 该方法对人声的处理效果最佳，不建议调用该方法处理含音乐的音频数据。 调用 setVoiceBeautifierParameters ，不建议调用以下方法，否则 setVoiceBeautifierParameters 设置的效果会被覆盖： setAudioEffectPreset setAudioEffectParameters setVoiceBeautifierPreset setLocalVoicePitch setLocalVoiceEqualization setLocalVoiceReverb setVoiceConversionPreset 该方法依赖于美声动态库 libagora_audio_beauty_extension.dll ，如果删除该动态库会导致无法正常开启该功能。

  • preset 预设的音效： SINGING_BEAUTIFIER : 歌唱美声。
  • param1 歌声的性别特征： 1 : 男声。 2 : 女声。
  • param2 歌声的混响效果： 1 : 歌声在小房间的混响效果。 2 : 歌声在大房间的混响效果。 3 : 歌声在大厅的混响效果。

Returns 方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

Implementation

Future<void> setVoiceBeautifierParameters(
    {required VoiceBeautifierPreset preset,
    required int param1,
    required int param2});