# 人声音效 (/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="toc_audio_effect"></a>

<a id="api_irtcengine_enablevoiceaituner"></a>

<a id="ariaid-title2"></a>

## enableVoiceAITuner [#enablevoiceaituner]

开启或关闭 AI 调音器功能。

<a id="api_irtcengine_enablevoiceaituner__prototype"></a>

```cpp
virtual int enableVoiceAITuner(bool enabled, VOICE_AI_TUNER_TYPE type) = 0;
```

<a id="api_irtcengine_enablevoiceaituner__detailed_desc"></a>

AI 调音器功能支持美化音质，调整音色风格。

<a id="api_irtcengine_enablevoiceaituner__scenario"></a>

### 适用场景 [#适用场景]

在线 K 歌、在线播客、秀场直播等对音质有较高要求的社交娱乐场景。

<a id="api_irtcengine_enablevoiceaituner__timing"></a>

### 调用时机 [#调用时机]

加入频道前后均可调用。

<a id="api_irtcengine_enablevoiceaituner__restriction"></a>

### 调用限制 [#调用限制]

无。

<a id="api_irtcengine_enablevoiceaituner__parameters"></a>

### 参数 [#参数]

<ParameterList>
<a id="enabled"></a>
<Parameter name="enabled">

是否开启 AI 调音器功能：

- `true`：开启 AI 调音器功能。
- `false`：（默认）关闭 AI 调音器功能。

</Parameter>
<a id="type"></a>
<Parameter name="type">

AI 调音器音效类型，详见 [VOICE_AI_TUNER_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-voiceaitunertype)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_enablevoiceaituner__return_values"></a>

### 返回值 [#返回值]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setadvancedaudiooptions"></a>

<a id="ariaid-title3"></a>

## setAdvancedAudioOptions [#setadvancedaudiooptions]

设置音频的高级选项。

<a id="api_irtcengine_setadvancedaudiooptions__prototype"></a>

```cpp
virtual int setAdvancedAudioOptions(media::base::AdvancedAudioOptions &options) = 0;
```

<a id="api_irtcengine_setadvancedaudiooptions__detailed_desc"></a>

### 详情 [#详情]

如果你对音频处理有进阶需求，例如需要采集和发送立体声，可以调用该方法设置音频的高级选项。

:::caution
注意： 你需要在 [joinChannel [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/channel#api_irtcengine_joinchannel2)、[enableAudio](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_enableaudio) 和 [enableLocalAudio](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-capture#api_irtcengine_enablelocalaudio) 前调用该方法。
:::

<a id="api_irtcengine_setadvancedaudiooptions__parameters"></a>

### 参数 [#参数-1]

<ParameterList>
<a id="options"></a>
<Parameter name="options">

音频的高级选项。详见 [AdvancedAudioOptions](/zh-CN/api-reference/rtc/unreal-cpp/class-advancedaudiooptions)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setadvancedaudiooptions__return_values"></a>

### 返回值 [#返回值-1]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-1]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setainsmode"></a>

<a id="ariaid-title4"></a>

## setAINSMode [#setainsmode]

设置是否开启 AI 降噪功能并设置降噪模式。

<a id="api_irtcengine_setainsmode__prototype"></a>

```cpp
virtual int setAINSMode(bool enabled,  AUDIO_AINS_MODE mode) = 0;
```

<a id="api_irtcengine_setainsmode__detailed_desc"></a>

你可以调用开方法来开启 AI 降噪功能。该功能可以在保证语音质量的前提下，智能化检测并降低周围环境中多种稳态与非稳态噪声，使人声更加清晰。
                稳态噪声指在任何时间点上都具有相同频率的噪声，常见的稳态噪声有：

- 电视机噪声
- 空调噪声
- 工厂机器噪声等

非稳态噪声是指随时间而快速变化的噪声，常见的非稳态噪声有：

- 雷声
- 爆炸声
- 破裂声等

<a id="api_irtcengine_setainsmode__scenario"></a>

### 适用场景 [#适用场景-1]

在语音连麦、在线教育、在线会议等场景中，如果周围环境比较嘈杂，AI 降噪功能可以在保证语音质量的前提下，识别并降低周围的稳态噪声和非稳态噪声，提高语音质量和体验。

<a id="api_irtcengine_setainsmode__timing"></a>

### 调用时机 [#调用时机-1]

该方法在加入频道前后均可调用。

<a id="api_irtcengine_setainsmode__restriction"></a>

### 调用限制 [#调用限制-1]

- 目前暂不推荐在 Android 6.0 及以下版本的设备上开启该功能。

<a id="api_irtcengine_setainsmode__parameters"></a>

### 参数 [#参数-2]

<ParameterList>
<a id="enabled-1"></a>
<Parameter name="enabled">

是否开启 AI 降噪功能：

- `true`：开启 AI 降噪功能。
- `false`：（默认）关闭 AI 降噪功能。

</Parameter>
<a id="mode"></a>
<Parameter name="mode">

降噪模式，详见 [AUDIO_AINS_MODE](/zh-CN/api-reference/rtc/unreal-cpp/enum-audioainsmode)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setainsmode__return_values"></a>

### 返回值 [#返回值-2]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-2]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setaudioeffectparameters"></a>

<a id="ariaid-title5"></a>

## setAudioEffectParameters [#setaudioeffectparameters]

设置 SDK 预设人声音效的参数。

<a id="api_irtcengine_setaudioeffectparameters__prototype"></a>

```cpp
virtual int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2) = 0;
```

<a id="api_irtcengine_setaudioeffectparameters__detailed_desc"></a>

### 详情 [#详情-1]

调用该方法可以对本地发流用户进行如下设置：

- 3D 人声音效：设置 3D 人声音效的环绕周期。
- 电音音效：设置电音音效的基础调式和主音音高。为方便用户自行调节电音音效，建议你将基础调式和主音音高配置选项与应用的 UI 元素绑定。

设置后，频道内所有用户都能听到该效果。

为获取更好的人声效果，建议你在调用该方法前进行以下操作：

- 调用 [setAudioScenario](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioscenario) 将音频场景设为高音质场景，即 AUDIO_SCENARIO_GAME_STREAMING(3)。
- 调用 [setAudioProfile [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioprofile2) 将 profile 设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

:::caution
注意：

- 该方法在加入频道前后都能调用。
- 请勿将 setAudioProfile [2/2] 的 profile 参数设置为 AUDIO_PROFILE_SPEECH_STANDARD(1)或 AUDIO_PROFILE_IOT(6)，否则该方法不生效。
- 该方法对人声的处理效果最佳，不建议调用该方法处理含音乐的音频数据。
- 调用 setAudioEffectParameters 后，不建议调用以下方法，否则 setAudioEffectParameters 设置的效果会被覆盖：

  - [setAudioEffectPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset)
  - [setVoiceBeautifierPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset)
  - [setLocalVoicePitch](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch)
  - [setLocalVoiceEqualization](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization)
  - [setLocalVoiceReverb](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb)
  - [setVoiceBeautifierParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierparameters)
  - [setVoiceConversionPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoiceconversionpreset)
- 该方法依赖于美声动态库 `libagora_audio_beauty_extension.dll`，如果删除该动态库会导致无法正常开启该功能。
:::

<a id="api_irtcengine_setaudioeffectparameters__parameters"></a>

### 参数 [#参数-3]

<ParameterList>
<a id="preset"></a>
<Parameter name="preset">

SDK 预设的音效，支持以下设置：

- ROOM_ACOUSTICS_3D_VOICE，3D 人声音效。

  - 你需要在使用该枚举前将 setAudioProfile [2/2] 的 profile 参数设置 为 AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)，否则该枚举设置无效。
  - 启用 3D 人声后，用户需要使用支持双声道的音频播放设备才能听到预期效果。
- PITCH_CORRECTION，电音音效。

</Parameter>
<a id="param1"></a>
<Parameter name="param1">

- 如果 preset 设为 ROOM_ACOUSTICS_3D_VOICE，则 param1 表示 3D 人声音效的环绕周期。取值范围为 [1,60]，单位为秒。默认值为 10，表示人声会 10 秒环绕 360 度。
- 如果 preset 设为 PITCH_CORRECTION，则 param1 表示电音音效的基础调式：

  - `1`: （默认）自然大调。
  - `2`: 自然小调。
  - `3`: 和风小调。

</Parameter>
<a id="param2"></a>
<Parameter name="param2">

- 如果 preset 设为 ROOM_ACOUSTICS_3D_VOICE，你需要将 param2 设置为 `0`。
- 如果 preset 设为 PITCH_CORRECTION，则 param2 表示电音音效的主音音高：

  - `1`: A
  - `2`: A#
  - `3`: B
  - `4`: (Default) C
  - `5`: C#
  - `6`: D
  - `7`: D#
  - `8`: E
  - `9`: F
  - `10`: F#
  - `11`: G
  - `12`: G#

</Parameter>
</ParameterList>

<a id="api_irtcengine_setaudioeffectparameters__return_values"></a>

### 返回值 [#返回值-3]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-3]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setaudioeffectpreset"></a>

<a id="ariaid-title6"></a>

## setAudioEffectPreset [#setaudioeffectpreset]

设置 SDK 预设的人声音效。

<a id="api_irtcengine_setaudioeffectpreset__prototype"></a>

```cpp
virtual int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset) = 0;
```

<a id="api_irtcengine_setaudioeffectpreset__detailed_desc"></a>

调用该方法可以为本地发流用户设置 SDK 预设的人声音效，且不会改变原声的性别特征。设置音效后，频道内所有用户都能听到该效果。

<a id="api_irtcengine_setaudioeffectpreset__timing"></a>

### 调用时机 [#调用时机-2]

加入频道前后均可调用。

为获取更好的人声效果，建议你在调用该方法前进行以下操作：

- 调用 [setAudioScenario](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioscenario) 将音频场景设为高音质场景，即 AUDIO_SCENARIO_GAME_STREAMING(3)。
- 调用 [setAudioProfile [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioprofile2) 将 profile 设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

<a id="api_irtcengine_setaudioeffectpreset__restriction"></a>

### 调用限制 [#调用限制-2]

- 请勿将 setAudioProfile [2/2] 的 profile 参数设置为 AUDIO_PROFILE_SPEECH_STANDARD(1)或 AUDIO_PROFILE_IOT(6)，否则该方法不生效。
- 如果调用 setAudioEffectPreset 并设置除 ROOM_ACOUSTICS_3D_VOICE 或 PITCH_CORRECTION 外的枚举，请勿再调用 [setAudioEffectParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters)，否则 setAudioEffectPreset 设置的效果会被覆盖。
- 调用 setAudioEffectPreset 后，不建议调用以下方法，否则 setAudioEffectPreset 设置的效果会被覆盖：

  - [setVoiceBeautifierPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset)
  - [setLocalVoicePitch](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch)
  - [setLocalVoiceEqualization](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization)
  - [setLocalVoiceReverb](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb)
  - [setVoiceBeautifierParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierparameters)
  - [setVoiceConversionPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoiceconversionpreset)
- 该方法依赖于美声动态库 `libagora_audio_beauty_extension.dll`，如果删除该动态库会导致无法正常开启该功能。

<a id="api_irtcengine_setaudioeffectpreset__parameters"></a>

### 参数 [#参数-4]

<ParameterList>
<a id="preset-1"></a>
<Parameter name="preset">

预设的音效选项，详见 [AUDIO_EFFECT_PRESET](/zh-CN/api-reference/rtc/unreal-cpp/enum-audioeffectpreset)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setaudioeffectpreset__return_values"></a>

### 返回值 [#返回值-4]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-4]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setlocalvoiceequalization"></a>

<a id="ariaid-title7"></a>

## setLocalVoiceEqualization [#setlocalvoiceequalization]

设置本地语音音效均衡。

<a id="api_irtcengine_setlocalvoiceequalization__prototype"></a>

```cpp
virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0;
```

<a id="api_irtcengine_setlocalvoiceequalization__detailed_desc"></a>

<a id="api_irtcengine_setlocalvoiceequalization__timing"></a>

### 调用时机 [#调用时机-3]

加入频道前后均可调用。

<a id="api_irtcengine_setlocalvoiceequalization__restriction"></a>

### 调用限制 [#调用限制-3]

无。

<a id="api_irtcengine_setlocalvoiceequalization__parameters"></a>

### 参数 [#参数-5]

<ParameterList>
<a id="bandfrequency"></a>
<Parameter name="bandFrequency">

频谱子带索引。取值范围是 [0,9]，分别代表音效的 10 个频带。对应的中心频率为 [31，62，125，250，500，1k，2k，4k，8k，16k] Hz。详见 [AUDIO_EQUALIZATION_BAND_FREQUENCY](/zh-CN/api-reference/rtc/unreal-cpp/enum-audioequalizationbandfrequency) 。

</Parameter>
<a id="bandgain"></a>
<Parameter name="bandGain">

每个 band 的增益，单位是 dB，每一个值的范围是 [-15,15]，默认值为 0。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setlocalvoiceequalization__return_values"></a>

### 返回值 [#返回值-5]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-5]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setlocalvoiceformant"></a>

<a id="ariaid-title8"></a>

## setLocalVoiceFormant [#setlocalvoiceformant]

设置共振峰比率以改变语音的音色。

<a id="api_irtcengine_setlocalvoiceformant__prototype"></a>

```cpp
virtual int setLocalVoiceFormant(double formantRatio) = 0;
```

<a id="api_irtcengine_setlocalvoiceformant__detailed_desc"></a>

共振峰比率是影响声音音色的一个参数，共振峰比率取值越小声音会更低沉，取值越大声音会更尖锐。设置共振峰比率后，频道内所有用户都能听到该效果。如果你想要在调整音色的同时改变音调，声网推荐你搭配 [setLocalVoicePitch](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch) 一起使用。

<a id="api_irtcengine_setlocalvoiceformant__scenario"></a>

### 适用场景 [#适用场景-2]

在语音直播、语聊房、K 歌房等场景中，你可以调用该方法设置本地语音的共振峰比率参数从而改变音色效果。

<a id="api_irtcengine_setlocalvoiceformant__timing"></a>

### 调用时机 [#调用时机-4]

加入频道前后均可调用。

<a id="api_irtcengine_setlocalvoiceformant__restriction"></a>

### 调用限制 [#调用限制-4]

无。

<a id="api_irtcengine_setlocalvoiceformant__parameters"></a>

### 参数 [#参数-6]

<ParameterList>
<a id="formantratio"></a>
<Parameter name="formantRatio">

共振峰比率，取值范围为 [-1.0，1.0]。默认值为 0.0，即不改变原声的音色。

:::note
注： 声网推荐的取值范围为 [-0.4，0.6] ，超出此范围外音效听感可能不佳。
:::

</Parameter>
</ParameterList>

<a id="api_irtcengine_setlocalvoiceformant__return_values"></a>

### 返回值 [#返回值-6]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-6]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setlocalvoicepitch"></a>

<a id="ariaid-title9"></a>

## setLocalVoicePitch [#setlocalvoicepitch]

设置本地语音音调。

<a id="api_irtcengine_setlocalvoicepitch__prototype"></a>

```cpp
virtual int setLocalVoicePitch(double pitch) = 0;
```

<a id="api_irtcengine_setlocalvoicepitch__detailed_desc"></a>

<a id="api_irtcengine_setlocalvoicepitch__timing"></a>

### 调用时机 [#调用时机-5]

加入频道前后均可调用。

<a id="api_irtcengine_setlocalvoicepitch__restriction"></a>

### 调用限制 [#调用限制-5]

无。

<a id="api_irtcengine_setlocalvoicepitch__parameters"></a>

### 参数 [#参数-7]

<ParameterList>
<a id="pitch"></a>
<Parameter name="pitch">

语音频率。可以 [0.5,2.0] 范围内设置。取值越小，则音调越低。默认值为 1.0，表示不需要修改音调。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setlocalvoicepitch__return_values"></a>

### 返回值 [#返回值-7]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-7]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setlocalvoicereverb"></a>

<a id="ariaid-title10"></a>

## setLocalVoiceReverb [#setlocalvoicereverb]

设置本地音效混响。

<a id="api_irtcengine_setlocalvoicereverb__prototype"></a>

```cpp
virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0;
```

<a id="api_irtcengine_setlocalvoicereverb__detailed_desc"></a>

### 详情 [#详情-2]

SDK 提供一个使用更为简便的方法 [setAudioEffectPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset)，直接实现流行、R&B、KTV 等预置的混响效果。

:::note
注： 该方法在加入频道前后都能调用。
:::

<a id="api_irtcengine_setlocalvoicereverb__parameters"></a>

### 参数 [#参数-8]

<ParameterList>
<a id="reverbkey"></a>
<Parameter name="reverbKey">

混响音效 Key。该方法共有 5 个混响音效 Key，详见 [AUDIO_REVERB_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-audioreverbtype)。

</Parameter>
<a id="value"></a>
<Parameter name="value">

各混响音效 Key 所对应的值。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setlocalvoicereverb__return_values"></a>

### 返回值 [#返回值-8]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-8]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setvoicebeautifierparameters"></a>

<a id="ariaid-title11"></a>

## setVoiceBeautifierParameters [#setvoicebeautifierparameters]

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

<a id="api_irtcengine_setvoicebeautifierparameters__prototype"></a>

```cpp
virtual int setVoiceBeautifierParameters(VOICE_BEAUTIFIER_PRESET preset, int param1, int param2) = 0;
```

<a id="api_irtcengine_setvoicebeautifierparameters__detailed_desc"></a>

### 详情 [#详情-3]

调用该方法可以设置歌唱美声效果的性别特征和混响效果。该方法对本地发流用户进行设置。设置后，频道内所有用户都能听到该效果。

为获取更好的人声效果，建议你在调用该方法前进行以下操作：

- 调用 [setAudioScenario](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioscenario) 将音频场景设为高音质场景，即 AUDIO_SCENARIO_GAME_STREAMING(3)。
- 调用 [setAudioProfile [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioprofile2) 将 profile 设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

:::caution
注意：

- 该方法在加入频道前后都能调用。
- 请勿将 setAudioProfile [2/2] 的 profile 参数设置为 AUDIO_PROFILE_SPEECH_STANDARD(1)或 AUDIO_PROFILE_IOT(6)，否则该方法不生效。
- 该方法对人声的处理效果最佳，不建议调用该方法处理含音乐的音频数据。
- 调用 setVoiceBeautifierParameters，不建议调用以下方法，否则 setVoiceBeautifierParameters 设置的效果会被覆盖：

  - [setAudioEffectPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset)
  - [setAudioEffectParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters)
  - [setVoiceBeautifierPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset)
  - [setLocalVoicePitch](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch)
  - [setLocalVoiceEqualization](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization)
  - [setLocalVoiceReverb](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb)
  - [setVoiceConversionPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoiceconversionpreset)
- 该方法依赖于美声动态库 `libagora_audio_beauty_extension.dll`，如果删除该动态库会导致无法正常开启该功能。
:::

<a id="api_irtcengine_setvoicebeautifierparameters__parameters"></a>

### 参数 [#参数-9]

<ParameterList>
<a id="preset-2"></a>
<Parameter name="preset">

预设的音效：

- `SINGING_BEAUTIFIER`: 歌唱美声。

</Parameter>
<a id="param1-1"></a>
<Parameter name="param1">

歌声的性别特征：

- `1`: 男声。
- `2`: 女声。

</Parameter>
<a id="param2-1"></a>
<Parameter name="param2">

歌声的混响效果：

- `1`: 歌声在小房间的混响效果。
- `2`: 歌声在大房间的混响效果。
- `3`: 歌声在大厅的混响效果。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setvoicebeautifierparameters__return_values"></a>

### 返回值 [#返回值-9]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-9]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setvoicebeautifierpreset"></a>

<a id="ariaid-title12"></a>

## setVoiceBeautifierPreset [#setvoicebeautifierpreset]

设置预设的美声效果。

<a id="api_irtcengine_setvoicebeautifierpreset__prototype"></a>

```cpp
virtual int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) = 0;
```

<a id="api_irtcengine_setvoicebeautifierpreset__detailed_desc"></a>

调用该方法可以为本地发流用户设置预设的人声美化效果。设置美声效果后，频道内所有用户都能听到该效果。根据不同的场景，你可以为用户设置不同的美声效果。

<a id="api_irtcengine_setvoicebeautifierpreset__timing"></a>

### 调用时机 [#调用时机-6]

加入频道前后均可调用。

<a id="api_irtcengine_setvoicebeautifierpreset__recommend"></a>

为获取更好的人声效果，建议你在调用该方法前进行以下操作：

- 调用 [setAudioScenario](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioscenario) 将音频场景设为高音质场景，即 AUDIO_SCENARIO_GAME_STREAMING(3)。
- 调用 [setAudioProfile [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioprofile2) 将 profile 设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

<a id="api_irtcengine_setvoicebeautifierpreset__restriction"></a>

### 调用限制 [#调用限制-6]

- 请勿将 setAudioProfile [2/2] 的 profile 参数设置为 AUDIO_PROFILE_SPEECH_STANDARD(1)或 AUDIO_PROFILE_IOT(6)，否则该方法不生效。
- 该方法对人声的处理效果最佳，不建议调用该方法处理含音乐的音频数据。
- 调用 setVoiceBeautifierPreset，不建议调用以下方法，否则 setVoiceBeautifierPreset 设置的效果会被覆盖：

  - [setAudioEffectPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset)
  - [setAudioEffectParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters)
  - [setLocalVoicePitch](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch)
  - [setLocalVoiceEqualization](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization)
  - [setLocalVoiceReverb](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb)
  - [setVoiceBeautifierParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierparameters)
  - [setVoiceConversionPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoiceconversionpreset)
- 该方法依赖于美声动态库 `libagora_audio_beauty_extension.dll`，如果删除该动态库会导致无法正常开启该功能。

<a id="api_irtcengine_setvoicebeautifierpreset__parameters"></a>

### 参数 [#参数-10]

<ParameterList>
<a id="preset-3"></a>
<Parameter name="preset">

预设的美声效果选项，详见 [VOICE_BEAUTIFIER_PRESET](/zh-CN/api-reference/rtc/unreal-cpp/enum-voicebeautifierpreset)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setvoicebeautifierpreset__return_values"></a>

### 返回值 [#返回值-10]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-10]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setvoiceconversionpreset"></a>

<a id="ariaid-title13"></a>

## setVoiceConversionPreset [#setvoiceconversionpreset]

设置预设的变声效果。

<a id="api_irtcengine_setvoiceconversionpreset__prototype"></a>

```cpp
virtual int setVoiceConversionPreset(VOICE_CONVERSION_PRESET preset) = 0;
```

<a id="api_irtcengine_setvoiceconversionpreset__detailed_desc"></a>

调用该方法可以为本地发流用户设置 SDK 预设的变声效果。设置变声效果后，频道内所有用户都能听到该效果。根据不同的场景，你可以为用户设置不同的变声效果。

<a id="api_irtcengine_setvoiceconversionpreset__timing"></a>

### 调用时机 [#调用时机-7]

加入频道前后均可调用。

为获取更好的人声效果，建议你在调用该方法前进行以下操作：

- 调用 [setAudioScenario](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioscenario) 将音频场景设为高音质场景，即 AUDIO_SCENARIO_GAME_STREAMING(3)。
- 调用 [setAudioProfile [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_setaudioprofile2) 将 profile 设为 AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4) 或 AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)。

<a id="api_irtcengine_setvoiceconversionpreset__restriction"></a>

### 调用限制 [#调用限制-7]

- 请勿将 setAudioProfile [2/2] 的 profile 参数设置为 AUDIO_PROFILE_SPEECH_STANDARD(1)或 AUDIO_PROFILE_IOT(6)，否则该方法不生效。
- 该方法对人声的处理效果最佳，不建议调用该方法处理含音乐的音频数据。
- 调用 setVoiceConversionPreset 后，不建议调用以下方法，否则 setVoiceConversionPreset 设置的效果会被覆盖：

  - [setAudioEffectPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectpreset)
  - [setAudioEffectParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters)
  - [setVoiceBeautifierPreset](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset)
  - [setVoiceBeautifierParameters](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierparameters)
  - [setLocalVoicePitch](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicepitch)
  - [setLocalVoiceFormant](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceformant)
  - [setLocalVoiceEqualization](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoiceequalization)
  - [setLocalVoiceReverb](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-prenpost/audio-effect#api_irtcengine_setlocalvoicereverb)
- 该方法依赖于美声动态库 `libagora_audio_beauty_extension.dll`，如果删除该动态库会导致无法正常开启该功能。

<a id="api_irtcengine_setvoiceconversionpreset__parameters"></a>

### 参数 [#参数-11]

<ParameterList>
<a id="preset-4"></a>
<Parameter name="preset">

预设的变声效果选项: [VOICE_CONVERSION_PRESET](/zh-CN/api-reference/rtc/unreal-cpp/enum-voiceconversionpreset)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setvoiceconversionpreset__return_values"></a>

### 返回值 [#返回值-11]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-11]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)