setVoiceBeautifierPreset abstract method

Future<void> setVoiceBeautifierPreset(
  1. VoiceBeautifierPreset preset
)

设置预设的美声效果。

调用该方法可以为本地发流用户设置预设的人声美化效果。设置美声效果后,频道内所有用户都能听到该效果。根据不同的场景,你可以为用户设置不同的美声效果。 请勿将 setAudioProfile 的 profile 参数设置为 audioProfileSpeechStandard (1) 或 audioProfileIot (6),否则该方法不生效。 该方法对人声的处理效果最佳,不建议调用该方法处理含音乐的音频数据。 调用 setVoiceBeautifierPreset ,不建议调用以下方法,否则 setVoiceBeautifierPreset 设置的效果会被覆盖: setAudioEffectPreset setAudioEffectParameters setLocalVoicePitch setLocalVoiceEqualization setLocalVoiceReverb setVoiceBeautifierParameters setVoiceConversionPreset 该方法依赖于美声动态库 libagora_audio_beauty_extension.dll ,如果删除该动态库会导致无法正常开启该功能。

  • preset 预设的美声效果选项,详见 VoiceBeautifierPreset 。

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

Implementation

Future<void> setVoiceBeautifierPreset(VoiceBeautifierPreset preset);