# 设置人声效果 (/zh-CN/realtime-media/rtc/build/audio/voice-changer/ios) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 在社交娱乐场景中,为增添场景的趣味性并提升互动体验,通常需要设置人声效果,如语聊美声、歌唱美声、音色变换等。例如,在 KTV 场景中,主播可以使用立体声音效增添自己声音的立体感,快速吸引大量听众。 本文介绍如何在你的项目中实现人声效果。 ## 功能介绍 [#功能介绍-1] 声网提供封装在枚举中的预设人声效果参数,帮助你实现以下人声效果: - **美声** - 语聊美声:在不改变原声辨识度的前提下,根据男女声各自的特点美化说话声。 - 歌唱美声:在保留歌声原有特点的前提下,根据男女声各自的特点美化歌声。 - 音色变换:将人声的音色朝特定的方向微调。 - **音效** - 曲风音效:在演唱特定风格的歌曲时,使歌声与伴奏更加契合。 - 空间塑造:通过空间混响效果营造一定的空间氛围,让人声仿佛从特定的场地中传出。 - 电音音效:通过调整人声的音调使其与伴奏的调式和主音音高完全匹配,从而实现电音效果。 - **变声** - 基础变声:保留一定的人声辨识度,使其更加中性、甜美或稳重。 - 进阶变声:大幅改变人声,实现大叔音、少女音、猪八戒、绿巨人等声音。 - **自定义人声效果**:如果预设效果无法满足你的需求,你可以手动调整人声的音调、均衡和混响效果以自定义人声效果。 ## 前提条件 [#前提条件-1] 项目已经实现了[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 设置音频场景和编码属性 [#设置音频场景和编码属性-2] 为了获得更好的人声效果,声网推荐你在实现人声效果前先调用以下方法: - [`setAudioScenario`](/zh-CN/api-reference/rtc/ios/audio/audio-basic#setaudioscenario):将音频场景设置为高音质场景 `AgoraAudioScenarioGameStreaming` (3)。 - [`setAudioProfile`[2/2]](/zh-CN/api-reference/rtc/ios/audio/audio-basic#api_irtcengine_setaudioprofile2):将音频编码属性设置为高音质编码: - 使用单声道传输:设为 `AgoraAudioProfileMusicHighQuality` - 使用立体声传输:设为 `AgoraAudioProfileMusicHighQualityStereo` ```swift // 创建 RtcEngine 对象 let agoraKit = AgoraRtcEngineKit.sharedEngine(with: config, delegate: self) // 设置音频场景 agoraKit.setAudioScenario(.gameStreaming) // 设置音频编码属性 agoraKit.setAudioProfile(.musicHighQaulityStereo) ``` ## 实现人声效果 [#实现人声效果-1] 本节介绍如何在你的项目中实现各种人声效果。 ### 美声 [#美声-1] 调用 [`setVoiceBeautifierPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset) 方法,设置曲风音效、空间塑造、电音音效等效果。 - 语聊美声 ```swift // 将人声效果设置为磁性(男) agoraKit.setVoiceBeautifierPreset(.chatBeautifierMagnetic) // 关闭人声效果 agoraKit.setVoiceBeautifierPreset(.voiceBeautifierOff) ``` - 歌唱美声 ```swift // 示例 1:设置男声音效 // 设置为歌唱美声预设,可美化男声并添加小房间混响效果 agoraKit.setVoiceBeautifierPreset(.singingBeautifier) // 关闭人声效果 agoraKit.setVoiceBeautifierPreset(.voiceBeautifierOff) // 示例 2:设置女声音效 // 调用 setVoiceBeautifierParameters 方法,实现美化女声,并添加大厅混响效果 agoraKit.setVoiceBeautifierParameters(.singingBeautifier, 2, 3) // 关闭人声效果 agoraKit.setVoiceBeautifierPreset(.voiceBeautifierOff) ``` - 音色变换 ```swift // 设置音色为浑厚 agoraKit.setVoiceBeautifierPreset(.timbreTransformationVigorous) // 关闭人声效果 agoraKit.setVoiceBeautifierPreset(.voiceBeautifierOff) ``` ### 音效 [#音效-1] 调用 [`setAudioEffectPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset) 方法,设置曲风音效、空间塑造、电音音效等效果。 - 曲风音效 ```swift // 设置曲风为流行 agoraKit.setAudioEffectPreset(.styleTransformationPopular) // 关闭人声效果 agoraKit.setAudioEffectPreset(.audioEffectOff) ``` - 空间塑造 ```swift // 设置空间塑造效果为 KTV 中的效果 agoraKit.setAudioEffectPreset(.roomAcousticKTV) // 关闭人声效果 agoraKit.setAudioEffectPreset(.audioEffectOff) ``` - 电音音效 ```swift // 示例 1:采用预设的音调调整方式实现电音音效 // 预设以主音音高为 C 的自然大调为基础,修正音频的实际音高 agoraKit.setAudioEffectPreset(.pitchCorrection) // 关闭人声效果 agoraKit.setAudioEffectPreset(.audioEffectOff) // 示例 2:自行调整基础调式和主音音高实现电音音效 // 调用 setAudioEffectParameters 调整修音的基础调式为自然小调,主音音高为 D agoraKit.setAudioEffectParameters(.pitchCorrection, 2, 6); // 关闭人声效果 agoraKit.setAudioEffectPreset(.audioEffectOff) ``` ### 变声 [#变声-1] 调用 [`setAudioEffectPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset) 和 [`setVoiceConversionPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setvoiceconversionpreset) 方法,分别实现基础变声和进阶变声效果。 - 基础变声 ```swift // 设置变声效果为更中性化的声音 agoraKit.setVoiceConversionPreset(.voiceChangerNeutral) // 关闭人声效果 agoraKit.setVoiceConversionPreset(.voiceConversionOff) ``` - 进阶变声 ```swift // 设置变声效果为绿巨人的声音 agoraKit.setAudioEffectPreset(.voiceChangerEffectHulk) // 关闭人声效果 agoraKit.setAudioEffectPreset(.audioEffectOff) ``` ### 自定义人声效果 [#自定义人声效果-2] 调用 [`setLocalVoicePitch`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch)、[`setLocalVoiceEqualization`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization) 和 [`setLocalVoiceReverb`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb),以调整音调、均衡和混响效果,来自定义人声效果。 以下示例代码展示如何通过手动设置参数值把原始人声变成绿巨人的声音: ```swift agoraKit.setLocalVoicePitch(1) // 设置本地人声均衡波段的中心频率 // 第 1 个参数为频谱子带索引,取值范围 [0,9],分别代表 10 个频带,对应的中心频率是 [31,62,125,250,500,1000,2000,4000,8000,16000] Hz // 第 2 个参数为每个频率区间的增益值,取值范围 [-15,15],单位 dB, 默认值为 0 agoraKit.setLocalVoiceEqualizationOf(.band31, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band62, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band125, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band250, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band500, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band1K, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band2K, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band4K, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band8K, withGain: 0) agoraKit.setLocalVoiceEqualizationOf(.band16K, withGain: 0) // 原始人声强度,即 dry signal,取值范围 [-20,10],单位为 dB agoraKit.setLocalVoiceReverbOf(.dryLevel, withValue: -1) // 早期反射信号强度,即 wet signal,取值范围 [-20,10],单位为 dB agoraKit.setLocalVoiceReverbOf(.wetLevel, withValue: -7) // 所需混响效果的房间尺寸,一般房间越大,混响效果越强。 取值范围 [0,100] agoraKit.setLocalVoiceReverbOf(.roomSize, withValue: 57) // Wet signal 的初始延迟长度,取值范围 [0,200],单位为 ms agoraKit.setLocalVoiceReverbOf(.wetDelay, withValue: 135) // 混响效果持续的强度,取值范围为 [0,100],值越大,混响效果越强 agoraKit.setLocalVoiceReverbOf(.strength, withValue: 45) ``` ## 开发注意事项 [#开发注意事项-1] - 同一时间只能设置一种人声效果,否则先设置的人声音效会被后设置的覆盖。 - `setVoiceBeautifierPreset`、`setAudioEffectPreset`、`setVoiceConversionPreset` 中的部分枚举适用于不同性别,需要加以区分。如果用于不适用的性别人声,会导致失真。 ## 参考信息 [#参考信息-1] ### 示例项目 [#示例项目-1] 声网在 Gitee、GitHub 上提供开源的实现人声效果示例项目 VoiceChanger ([Gitee](https://gitee.com/agoraio-community/API-Examples/tree/main/iOS/APIExample/APIExample/Examples/Advanced/VoiceChanger), [GitHub](https://github.com/Shengwang-Community/API-Examples/tree/main/iOS/APIExample/APIExample/Examples/Advanced/VoiceChanger)) 供你参考,你可以前往下载或查看其中的源代码。 ### API 参考 [#api-参考-1] #### 设置音频场景和编码属性 [#设置音频场景和编码属性-3] - [`setAudioScenario`](/zh-CN/api-reference/rtc/ios/audio/audio-basic#setaudioscenario) - [`setAudioProfile`[2/2]](/zh-CN/api-reference/rtc/ios/audio/audio-basic#api_irtcengine_setaudioprofile2) #### 预设人声效果 [#预设人声效果-1] - [`setVoiceBeautifierPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset) - [`setAudioEffectPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset) - [`setVoiceConversionPreset`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setvoiceconversionpreset) - [`setAudioEffectParameters`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters) - [`setVoiceBeautifierParameters`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierparameters) #### 自定义人声效果 [#自定义人声效果-3] - [`setLocalVoicePitch`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch) - [`setLocalVoiceEqualization`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization) - [`setLocalVoiceReverb`](/zh-CN/api-reference/rtc/ios/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb)