设置人声效果

  • HarmonyOS

更新时间

了解实时互动 RTC 在不同平台上的设置人声效果方式,包括接入流程、关键配置和平台差异。

在社交娱乐、KTV 和互动直播等场景中,你可以使用 HarmonyOS RTC SDK 调整本地人声的预设效果、音调、均衡和混响。

本文只介绍当前 HarmonyOS API 参考中已公开且支持的能力。

前提条件

在进行操作之前,请确保你的项目已经实现基本的实时音视频功能,详见实现音视频互动。

为了获得更好的人声效果,建议将音频场景设置为 GAME_STREAMING,并使用高音质音频编码属性:

TypeScript
this.rtcEngine = RtcEngine.create(config);
this.rtcEngine?.setAudioScenario(Constants.AudioScenarioType.GAME_STREAMING);
this.rtcEngine?.setAudioProfile(Constants.AudioProfileType.MUSIC_HIGH_QUALITY_STEREO);

设置预设人声效果

调用 setVoiceBeautifierPreset 设置预设美声或音色效果。以下示例分别设置磁性人声和浑厚人声,并使用 OFF 恢复原始人声:

TypeScript
// 磁性人声,适合男声
this.rtcEngine?.setVoiceBeautifierPreset(
    Constants.VoiceBeautifierPreset.CHAT_BEAUTIFIER_MAGNETIC
);

// 音色变换为浑厚
this.rtcEngine?.setVoiceBeautifierPreset(
    Constants.VoiceBeautifierPreset.TIMBRE_TRANSFORMATION_VIGOROUS
);

// 关闭预设人声效果
this.rtcEngine?.setVoiceBeautifierPreset(Constants.VoiceBeautifierPreset.OFF);

部分预设针对特定音色或性别进行了调校。使用前请阅读 API 参考中的枚举说明,否则可能产生失真。

设置预设音效

调用 setAudioEffectPreset 设置空间塑造或其他预设音效:

TypeScript
// 设置 KTV 空间音效
this.rtcEngine?.setAudioEffectPreset(
    Constants.AudioEffectPreset.ROOM_ACOUSTICS_KTV
);

// 关闭预设音效
this.rtcEngine?.setAudioEffectPreset(Constants.AudioEffectPreset.AUDIO_EFFECT_OFF);

同一时间建议只使用一种预设人声或音效。重复设置时,后一次调用可能覆盖前一次效果。

自定义人声效果

调整音调

调用 setLocalVoicePitch 调整音调。pitch 的取值范围为 0.5 到 2.0,默认值为 1.0:

TypeScript
this.rtcEngine?.setLocalVoicePitch(0.8);

调整均衡

调用 setLocalVoiceEqualization 调整指定频段的增益。频段枚举和增益范围以 API 参考为准:

TypeScript
// 调整低频和中频,使人声更厚实
this.rtcEngine?.setLocalVoiceEqualization(
    Constants.AudioEqualizationBandFrequency.BAND_31,
    3
);
this.rtcEngine?.setLocalVoiceEqualization(
    Constants.AudioEqualizationBandFrequency.BAND_1K,
    -2
);

调整混响

调用 setLocalVoiceReverb 调整干声、湿声、房间大小、延迟和混响强度:

TypeScript
this.rtcEngine?.setLocalVoiceReverb(
    Constants.AudioReverbType.DRY_LEVEL,
    0
);
this.rtcEngine?.setLocalVoiceReverb(
    Constants.AudioReverbType.WET_LEVEL,
    6
);
this.rtcEngine?.setLocalVoiceReverb(
    Constants.AudioReverbType.ROOM_SIZE,
    40
);

开发注意事项

  • 预设美声、预设音效、音调、均衡和混响可能互相覆盖。需要切换效果时,先明确当前生效的效果,再设置新的效果。
  • 人声效果主要用于人声。将其用于音乐或复杂混音可能无法得到预期效果。
  • 关闭预设效果时,调用对应枚举中的 OFF 值;自定义参数需要根据业务逻辑恢复到默认值。

参考信息

API 参考