# VoiceBeautifierPreset (/zh-CN/api-reference/rtc/electron/enum-voicebeautifierpreset)

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

<a id="enum_voicebeautifierpreset__parameters"></a>

## 枚举值 [#枚举值]

<ParameterList>
<a id="voicebeautifieroff"></a>
<Parameter name="VoiceBeautifierOff">

原声，即关闭美声效果。

</Parameter>
<a id="chatbeautifiermagnetic"></a>
<Parameter name="ChatBeautifierMagnetic">

磁性（男）。

:::note
注： 该设置仅对男声有效，请勿用于设置女声，否则音频会失真。
:::

</Parameter>
<a id="chatbeautifierfresh"></a>
<Parameter name="ChatBeautifierFresh">

清新（女）。

:::note
注： 该设置仅对女声有效，请勿用于设置男声，否则音频会失真。
:::

</Parameter>
<a id="chatbeautifiervitality"></a>
<Parameter name="ChatBeautifierVitality">

活力（女）。

:::note
注： 该设置仅对女声有效，请勿用于设置男声，否则音频会失真。
:::

</Parameter>
<a id="singingbeautifier"></a>
<Parameter name="SingingBeautifier">

歌唱美声。

- 如果调用 [setVoiceBeautifierPreset](/zh-CN/api-reference/rtc/electron/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset)(SingingBeautifier)，你可以美化男声并添加歌声在小房间的混响效果。请勿用于设置女声，否则音频会失真。
- 如果调用 [setVoiceBeautifierParameters](/zh-CN/api-reference/rtc/electron/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierparameters)(SingingBeautifier, param1, param2)，你可以美化男声或女声并添加混响效果。

</Parameter>
<a id="timbretransformationvigorous"></a>
<Parameter name="TimbreTransformationVigorous">

浑厚。

</Parameter>
<a id="timbretransformationdeep"></a>
<Parameter name="TimbreTransformationDeep">

低沉。

</Parameter>
<a id="timbretransformationmellow"></a>
<Parameter name="TimbreTransformationMellow">

圆润。

</Parameter>
<a id="timbretransformationfalsetto"></a>
<Parameter name="TimbreTransformationFalsetto">

假音。

</Parameter>
<a id="timbretransformationfull"></a>
<Parameter name="TimbreTransformationFull">

饱满。

</Parameter>
<a id="timbretransformationclear"></a>
<Parameter name="TimbreTransformationClear">

清澈。

</Parameter>
<a id="timbretransformationresounding"></a>
<Parameter name="TimbreTransformationResounding">

高亢。

</Parameter>
<a id="timbretransformationringing"></a>
<Parameter name="TimbreTransformationRinging">

嘹亮。

</Parameter>
<a id="ultrahighqualityvoice"></a>
<Parameter name="UltraHighQualityVoice">

超高音质，即让音频更清晰、细节更丰富。

- 为达到更好的效果，建议在调用 [setVoiceBeautifierPreset](/zh-CN/api-reference/rtc/electron/audio/audio-prenpost/audio-effect#api_irtcengine_setvoicebeautifierpreset) 前将 `setAudioProfile2` 的 `profile` 参数设置为 `AudioProfileMusicHighQuality`(4) 或 `AudioProfileMusicHighQualityStereo`(5)，且 `scenario` 参数设置为 `AudioScenarioGameStreaming`(3)。
- 如果用户的音频采集设备可以高度还原音频细节，建议你不要开启超高音质，否则 SDK 会过度还原音频细节，达不到预期效果。

</Parameter>
</ParameterList>