文档中心
视频通话
Console Agora.io 社区 提交工单
简体中文
search-icon

设置人声效果

更新时间 2022/03/07 07:30:10

功能描述

在社交娱乐应用中，为增添场景的趣味性并提升互动体验，通常需要设置人声效果。例如在语聊房场景中，用户可以选择音效来增添自己声音的立体感。Agora RTC SDK 提供预设的人声效果，也支持通过音调、声音均衡和混响等设置自定义人声效果。你可以通过 Agora 提供的在线 Demo 体验 SDK 预设的人声效果。

示例项目

Agora 在 GitHub 上提供实现了美声与音效功能的开源示例项目 VoiceEffects.java，你可以前往下载体验或参考源代码。

使用预设的人声效果

为满足不同场景对人声效果的需求，SDK 提供 setVoiceBeautifierPreset 和 setAudioEffectPreset 方法，你可以使用以下预设的人声效果：

人声效果 适用场景
美声

setVoiceBeautifierPreset

 语聊美声 以说话声为主的音视频场景：
  • 语音相亲
  • 情感电台
  • 语音连麦直播
  • 语音 PK 直播
  • 语聊房
  • 开黑语音
    		•
    歌唱美声 以歌声为主的音视频场景：
  • K 歌房
  • 音乐电台
  • 直播秀场
    		•
    音色变换 以说话声或歌声为主的音视频场景：
  • 语音连麦直播
  • 语音 PK 直播
  • 语聊房
  • 开黑语音
  • 语音相亲
  • K 歌房
  • FM 电台
    		•
    音效

    setAudioEffectPreset

    		 变声音效 以说话声为主的音视频场景：
  • 语音连麦直播
  • 语音 PK 直播
  • 语聊房
  • 开黑语音
    		•
    曲风音效 以歌声为主的音视频场景：
  • K 歌房
  • 音乐电台
  • 直播秀场
    		•
    空间塑造 以说话声或歌声为主的音视频场景：
  • 语音连麦直播
  • 语音 PK 直播
  • 语聊房
  • 开黑语音
  • 语音相亲
  • K 歌房
  • FM 电台
    		•
    电音音效 以歌声为主的音视频场景：
  • K 歌房
  • 音乐电台
  • 直播秀场
    		•
    变声

    setVoiceConversionPreset

    		 基础变声 以说话声或歌声为主的音视频场景：
  • 语音连麦直播
  • 语音 PK 直播
  • 语聊房
  • 开黑语音
  • 语音相亲
  • K 歌房
  • FM 电台
    		•

    语聊美声

    语聊美声是指在不改变原声辨识度的前提下，根据男女声各自的特点美化说话声。

    通过 setVoiceBeautifierPreset 中以下枚举值，你可以实现语聊美声效果：

    枚举值 描述
    CHAT_BEAUTIFIER_MAGNETIC 磁性（男）。请确保使用该枚举美化男声，否则音频可能会产生失真。
    CHAT_BEAUTIFIER_FRESH 清新（女）。请确保使用该枚举美化女声，否则音频可能会产生失真。
    CHAT_BEAUTIFIER_VITALITY 活力（女）。请确保使用该枚举美化女声，否则音频可能会产生失真。
    为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    // 预设人声效果为磁性（男）。
mRtcEngine.setVoiceBeautifierPreset(Constants.CHAT_BEAUTIFIER_MAGNETIC); 
// 关闭人声效果。
mRtcEngine.setVoiceBeautifierPreset(Constants.VOICE_BEAUTIFIER_OFF);

    歌唱美声

    歌唱美声是指在保留歌声原有特点的前提下，根据男女声各自的特点美化歌声并添加混响效果。

    通过 SINGING_BEAUTIFIER 枚举值，你可以实现歌唱美声效果。

    • 如果调用 setVoiceBeautifierPreset(SINGING_BEAUTIFIER)，你可以美化男声并添加歌声在小房间的混响效果。请勿用于设置女声，否则音频会失真。
    • 如果调用 setVoiceBeautifierParameters(SINGING_BEAUTIFIER, param1, param2)，你可以美化男声或女声并添加混响效果。
    为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    // 预设人声效果为歌唱美声。 
mRtcEngine.setVoiceBeautifierPreset(Constants.SINGING_BEAUTIFIER); 
// 美化女声并添加歌声在大厅的混响效果。 
mRtcEngine.setVoiceBeautifierParameters(Constants.SINGING_BEAUTIFIER, 2, 3); 
// 关闭人声效果。 
mRtcEngine.setVoiceBeautifierPreset(Constants.VOICE_BEAUTIFIER_OFF);

    音色变换

    音色变换可以让人声的音色朝特定的方向改变，用户可以选择最合适自己的效果。

    通过 setVoiceBeautifierPreset 中以下枚举值，你可以实现音色变换效果：

    枚举值 描述
    TIMBRE_TRANSFORMATION_VIGOROUS 浑厚。
    TIMBRE_TRANSFORMATION_DEEP 低沉。
    TIMBRE_TRANSFORMATION_MELLOW 圆润。
    TIMBRE_TRANSFORMATION_FALSETTO 假音。
    TIMBRE_TRANSFORMATION_FULL 饱满。
    TIMBRE_TRANSFORMATION_CLEAR 清澈。
    TIMBRE_TRANSFORMATION_RESOUNDING 高亢。
    TIMBRE_TRANSFORMATION_RINGING 嘹亮。
    为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    // 预设人声效果为浑厚。
mRtcEngine.setVoiceBeautifierPreset(Constants.TIMBRE_TRANSFORMATION_VIGOROUS);
// 关闭人声效果。
mRtcEngine.setVoiceBeautifierPreset(Constants.VOICE_BEAUTIFIER_OFF);

    变声音效

    变声音效可以改变原声，起到增添趣味性等作用。该效果下的声音不太自然，听众能辨认出用户使用了变声效果。

    通过 setAudioEffectPreset 中以下枚举值，你可以实现变声音效：

    枚举值 描述
    VOICE_CHANGER_EFFECT_UNCLE 大叔。建议用于处理男声，否则无法达到预期效果。
    VOICE_CHANGER_EFFECT_OLDMAN 老年男性。建议用于处理男声，否则无法达到预期效果。
    VOICE_CHANGER_EFFECT_BOY 男孩。建议用于处理男声，否则无法达到预期效果。
    VOICE_CHANGER_EFFECT_SISTER 少女。建议用于处理女声，否则无法达到预期效果。
    VOICE_CHANGER_EFFECT_GIRL 女孩。建议用于处理女声，否则无法达到预期效果。
    VOICE_CHANGER_EFFECT_PIGKING 猪八戒。
    VOICE_CHANGER_EFFECT_HULK 绿巨人。
    为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    // 预设人声效果为绿巨人。
mRtcEngine.setAudioEffectPreset(Constants.VOICE_CHANGER_EFFECT_HULK);
// 关闭人声效果。
mRtcEngine.setAudioEffectPreset(Constants.AUDIO_EFFECT_OFF);

    曲风音效

    曲风音效可以在演唱特定风格的歌曲时，使歌声与伴奏更加契合。

    通过 setAudioEffectPreset 中以下枚举值，你可以实现曲风音效：

    枚举值 描述
    STYLE_TRANSFORMATION_POPULAR 流行。
    STYLE_TRANSFORMATION_RNB R&B。
  • 你需要在使用该枚举前将 setAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。
  • 为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    • // 预设人声效果为流行。
mRtcEngine.setAudioEffectPreset(Constants.STYLE_TRANSFORMATION_POPULAR); 
// 关闭人声效果。
mRtcEngine.setAudioEffectPreset(Constants.AUDIO_EFFECT_OFF);

    空间塑造

    空间塑造是指通过空间混响效果营造一定的空间氛围，让人声仿佛从特定的场地中传出。

    通过 setAudioEffectPreset 中以下枚举值，你可以实现空间塑造效果：

    枚举值 描述
    ROOM_ACOUSTICS_KTV KTV。
    ROOM_ACOUSTICS_VOCAL_CONCERT 演唱会。
    ROOM_ACOUSTICS_STUDIO 录音棚。
    ROOM_ACOUSTICS_PHONOGRAPH 留声机。
    ROOM_ACOUSTICS_VIRTUAL_STEREO 虚拟立体声，即 SDK 将单声道的音频渲染出双声道的音效。

    Note

  • 你需要在使用该枚举前将 setAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。
  • 为获取更好的人声效果，Agora 建议你将 setAudioProfile 的 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    		•
    ROOM_ACOUSTICS_SPACIAL 空旷。
    ROOM_ACOUSTICS_ETHEREAL 空灵。
    ROOM_ACOUSTICS_3D_VOICE 3D 人声，即 SDK 将音频渲染出在用户周围环绕的效果，环绕周期为 10 秒。设置该音效后，你还可以调用 setAudioEffectParameters 修改环绕周期。

    Note

  • 你需要在使用该枚举前将 setAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。
  • 启用 3D 人声后，用户需要使用支持双声道的音频播放设备才能听到预期效果。
  • 为获取更好的人声效果，Agora 建议你将 setAudioProfile 的 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    		•
    如果你使用除 ROOM_ACOUSTICS_VIRTUAL_STEREO 和 ROOM_ACOUSTICS_3D_VOICE 外的枚举，为获取更好的人声效果，Agora 建议你将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    // 预设人声效果为 3D 人声。
mRtcEngine.setAudioEffectPreset(Constants.ROOM_ACOUSTICS_3D_VOICE);
// 将环绕周期设置为 30 秒。
mRtcEngine.setAudioEffectParameters(Constants.ROOM_ACOUSTICS_3D_VOICE, 30, 0);
// 关闭人声效果。
mRtcEngine.setAudioEffectPreset(Constants.AUDIO_EFFECT_OFF);

    电音音效

    电音音效是指对歌声进行修音，使其与伴奏的调式和主音音高完全匹配的效果。

    通过 setAudioEffectPreset 中以下枚举值，你可以实现电音音效：

    枚举值 描述
    PITCH_CORRECTION 电音，即 SDK 以主音音高为 C 的自然大调为基础修正音频的实际音高。设置该音效后，你还可以调用 setAudioEffectParameters 调整修音的基础调式和主音音高。
    为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。不同歌曲的调式和主音音高不同，建议将该方法与 app 界面元素绑定，让用户自行调节电音音效。
    // 预设人声效果为电音音效。
mRtcEngine.setAudioEffectPreset(Constants.PITCH_CORRECTION);
// 将电音音效设置为主音音高为 D 的自然小调。
mRtcEngine.setAudioEffectParameters(Constants.PITCH_CORRECTION, 2, 6);
// 关闭人声效果。
mRtcEngine.setAudioEffectPreset(Constants.AUDIO_EFFECT_OFF);

    基础变声

    基础变声可以自然地改变原声，起到匿名等作用。听众在没听过原声的情况下，无法辨认用户是否使用了变声效果。

    通过 setVoiceConversionPreset 中以下枚举值，你可以实现基础变声效果：

    枚举值 描述
    VOICE_CONVERSION_OFF 原声，即关闭变声效果。
    VOICE_CHANGER_NEUTRAL 中性。为避免音频失真，请确保仅对女声设置该效果。
    VOICE_CHANGER_SWEET 甜美。为避免音频失真，请确保仅对女声设置该效果。
    VOICE_CHANGER_SOLID 稳重。为避免音频失真，请确保仅对男声设置该效果。
    VOICE_CHANGER_BASS 低沉。为避免音频失真，请确保仅对男声设置该效果。
    为获取更好的人声效果，Agora 建议你在使用该枚举前将 setAudioProfile 的 profile 参数设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，并将 scenario 参数设为 AUDIO_SCENARIO_GAME_STREAMING(3)。
    // 预设变声效果为更中性化的声音。  
mRtcEngine.setVoiceConversionPreset(Constants.VOICE_CHANGER_NEUTRAL);  
// 关闭变声效果。  
mRtcEngine.setVoiceConversionPreset(Constants.VOICE_CONVERSION_OFF);

    自定义人声效果

    如果预设效果无法满足你的需求，你还可以通过 setLocalVoicePitch、setLocalVoiceEqualization 和 setLocalVoiceReverb 自行调整音调、均衡和混响效果，获取想要的人声效果。

    以下示例代码展示如何把原始人声变成绿巨人浩克的声音：

    // 设置音调。可以在 [0.5,2.0] 范围内设置。取值越小，则音调越低。默认值为 1.0，表示原始音调
double pitch = 0.5;
mRtcEngine.setLocalVoicePitch(pitch);

// 设置本地人声均衡波段的中心频率
// 第 1 个参数为频谱子带索引，取值范围 [0,9]，分别代表 10 个频带，对应的中心频率是 [31,62,125,250,500,1000,2000,4000,8000,16000] Hz
// 第 2 个参数为每个频率区间的增益值，取值范围 [-15,15]，单位 dB, 默认值为 0
mRtcEngine.setLocalVoiceEqualization(0, -15);
mRtcEngine.setLocalVoiceEqualization(1, 3);
mRtcEngine.setLocalVoiceEqualization(2, -9);
mRtcEngine.setLocalVoiceEqualization(3, -8);
mRtcEngine.setLocalVoiceEqualization(4, -6);
mRtcEngine.setLocalVoiceEqualization(5, -4);
mRtcEngine.setLocalVoiceEqualization(6, -3);
mRtcEngine.setLocalVoiceEqualization(7, -2);
mRtcEngine.setLocalVoiceEqualization(8, -1);
mRtcEngine.setLocalVoiceEqualization(9, 1);

// 原始人声强度，即所谓的 dry signal，取值范围 [-20,10]，单位为 dB
mRtcEngine.setLocalVoiceReverb(Constants.AUDIO_REVERB_DRY_LEVEL, 10);

// 早期反射信号强度，即所谓的 wet signal，取值范围 [-20,10]，单位为 dB
mRtcEngine.setLocalVoiceReverb(Constants.AUDIO_REVERB_WET_LEVEL, 7);

// 所需混响效果的房间尺寸，一般房间越大，混响效果越强。取值范围 [0,100]
mRtcEngine.setLocalVoiceReverb(Constants.AUDIO_REVERB_ROOM_SIZE, 6);

// Wet signal 的初始延迟长度，取值范围 [0,200]，单位为 ms
mRtcEngine.setLocalVoiceReverb(Constants.AUDIO_REVERB_WET_DELAY, 124);

// 混响效果持续的强度，取值范围为 [0,100]，值越大，混响效果越强
mRtcEngine.setLocalVoiceReverb(Constants.AUDIO_REVERB_STRENGTH, 78);

    API 参考

    预设的人声效果：

    自定义人声效果：

    开发注意事项

    • 请勿将 setAudioProfile 的 profile 参数设置为 AUDIO_PROFILE_SPEECH_STANDARD(1)，否则以下方法不生效：
      • setAudioEffectPreset
      • setVoiceBeautifierPreset
      • setAudioEffectParameters
      • setVoiceBeautifierParameters
      • setVoiceConversionPreset
    • 本文所有方法对人声的处理效果最佳，Agora 不推荐调用这类方法处理含音乐的音频数据。
    • Agora 建议不要将以下方法一起使用，否则先调用的方法设置的效果会被覆盖：
      • setAudioEffectPreset
      • setVoiceBeautifierPreset
      • setAudioEffectParameters
      • setVoiceBeautifierParameters
      • setVoiceConversionPreset
      • setLocalVoicePitch
      • setLocalVoiceEqualizationOfBandFrequency
      • setLocalVoiceReverbOfType