# AgoraAudioEffectPreset (/zh-CN/api-reference/rtc/macos/enum-audioeffectpreset)

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

<a id="enum_audioeffectpreset__detailed_desc"></a>

为了获得更好的音效效果，Agora 建议在使用预设音效前调用 [setAudioProfile\:scenario:](/zh-CN/api-reference/rtc/macos/audio/audio-basic#api_irtcengine_setaudioprofile) 方法，并按如下建议设置 `profile` 参数。

| 预设音效效果 | `profile` |
| --- | --- |
| `AgoraAudioEffectPresetRoomAcousVirtualStereo`、`AgoraAudioEffectPresetRoomAcous3DVoice`、`AgoraAudioEffectPresetRoomAcousVirtualSurroundSound` | `AgoraAudioProfileMusicHighQualityStereo` 或 `AgoraAudioProfileMusicStandardStereo` |
| 其他预设音效（不包括 `AgoraAudioEffectPresetOff`） | `AgoraAudioProfileMusicHighQuality` 或 `AgoraAudioProfileMusicHighQualityStereo` |

<a id="enum_audioeffectpreset__parameters"></a>

## 枚举值 [#枚举值]

<ParameterList>
<a id="agoraaudioeffectpresetoff"></a>
<Parameter name="AgoraAudioEffectPresetOff">

（0x00000000）：关闭音效处理，使用原始声音。

</Parameter>
<a id="agoraaudioeffectpresetroomacousticsktv"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousticsKTV">

（0x02010100）：KTV 场景音效。

</Parameter>
<a id="agoraaudioeffectpresetroomacousvocalconcer"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousVocalConcer">

（0x02010200）：音乐厅场景音效。

</Parameter>
<a id="agoraaudioeffectpresetroomacousstudio"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousStudio">

（0x02010300）：录音棚场景音效。

</Parameter>
<a id="agoraaudioeffectpresetroomacousphonograph"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousPhonograph">

（0x02010400）：老式留声机音效。

</Parameter>
<a id="agoraaudioeffectpresetroomacousvirtualstereo"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousVirtualStereo">

（0x02010500）：虚拟立体声效果，将单声道音频渲染为立体声。

</Parameter>
<a id="agoraaudioeffectpresetroomacousspatial"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousSpatial">

（0x02010600）：增强空间感的音效。

</Parameter>
<a id="agoraaudioeffectpresetroomacousethereal"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousEthereal">

（0x02010700）：增强空灵感的音效。

</Parameter>
<a id="agoraaudioeffectpresetroomacous3dvoice"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcous3DVoice">

（0x02010800）：3D 音效，使声音围绕用户移动，默认循环周期为 10 秒。设置该效果后，可调用 [setAudioEffectParameters\:param1\:param2:](/zh-CN/api-reference/rtc/macos/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters) 修改移动周期。

:::note
注： 启用 3D 音效时，用户需使用立体声播放设备以获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetroomacousvirtualsurroundsound"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousVirtualSurroundSound">

（0x02010900）：虚拟环绕音效，基于立体声通道生成模拟环绕声场。

:::note
注： 启用虚拟环绕音效时，用户需使用立体声播放设备以获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetroomacousticschorus"></a>
<Parameter name="AgoraAudioEffectPresetRoomAcousticsChorus">

（0x02010D00）：合唱音效，增强人声的层次感和空间感，适用于合唱场景。

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffectuncle"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectUncle">

（0x02020100）：中年男性音色。

:::note
注： 建议用于处理男性音色，否则可能无法获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffectoldman"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectOldMan">

（0x02020200）：年长男性音色。

:::note
注： 建议用于处理男性音色，否则可能无法获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffectboy"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectBoy">

（0x02020300）：男孩音色。

:::note
注： 建议用于处理男性音色，否则可能无法获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffectsister"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectSister">

（0x02020400）：年轻女性音色。

:::note
注： 建议用于处理女性音色，否则可能无法获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffectgirl"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectGirl">

（0x02020500）：女孩音色。

:::note
注： 建议用于处理女性音色，否则可能无法获得预期音效。
:::

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffectpigkin"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectPigKin">

（0x02020600）：猪八戒音色，类似熊吼的声音。

</Parameter>
<a id="agoraaudioeffectpresetvoicechangereffecthulk"></a>
<Parameter name="AgoraAudioEffectPresetVoiceChangerEffectHulk">

（0x02020700）：绿巨人音色。

</Parameter>
<a id="agoraaudioeffectpresetstyletransformationrnb"></a>
<Parameter name="AgoraAudioEffectPresetStyleTransformationRnb">

（0x02030100）：R&B 音乐风格音效。

</Parameter>
<a id="agoraaudioeffectpresetstyletransformationpopular"></a>
<Parameter name="AgoraAudioEffectPresetStyleTransformationPopular">

（0x02030200）：流行音乐风格音效。

</Parameter>
<a id="agoraaudioeffectpresetpitchcorrection"></a>
<Parameter name="AgoraAudioEffectPresetPitchCorrection">

（0x02040100）：音高修正效果，基于自然 C 大调音阶修正用户音高。设置该效果后，可调用 [setAudioEffectParameters\:param1\:param2:](/zh-CN/api-reference/rtc/macos/audio/audio-prenpost/audio-effect#api_irtcengine_setaudioeffectparameters) 调整调音模式和主音音高。

</Parameter>
</ParameterList>