需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

AgoraVoiceBeautifierPreset

  • macOS

更新时间不可用

用于设置 SDK 预设的声动语聊美声效果。

枚举值

参数名描述
AgoraVoiceBeautifierPresetOff

（0x00000000）：关闭声动语聊美声效果，使用原始语音。

AgoraVoiceBeautifierPresetChatBeautifierMagnetic

（0x01010100）：更具磁性的声音。

注： 声网建议用于处理男性音色，否则可能会出现声音失真。

AgoraVoiceBeautifierPresetChatBeautifierFresh

（0x01010200）：更清新的声音。

注： 声网建议用于处理女性音色，否则可能会出现声音失真。

AgoraVoiceBeautifierPresetChatBeautifierVitality

（0x01010300）：更有活力的声音。

注： 声网建议用于处理女性音色，否则可能会出现声音失真。

AgoraVoiceBeautifierPresetSingingBeautifier

（0x01020100）：歌唱美声效果。

注： 如果调用 setVoiceBeautifierPreset:（AgoraVoiceBeautifierPresetSingingBeautifier），可美化男性音色并添加小房间混响效果。声网建议用于处理男性音色，否则可能会出现声音失真。若调用 setVoiceBeautifierParameters:param1:param2:（AgoraVoiceBeautifierPresetSingingBeautifier, param1, param2），可美化男性或女性音色并添加混响效果。

AgoraVoiceBeautifierTimbreTransformationVigorous

（0x01030100）：更有力量感的声音。

AgoraVoiceBeautifierTimbreTransformationDeep

（0x01030200）：更深沉的声音。

AgoraVoiceBeautifierTimbreTransformationMellow

（0x01030300）：更圆润的声音。

AgoraVoiceBeautifierTimbreTransformationFalsetto

（0x01030400）：假声效果。

AgoraVoiceBeautifierTimbreTransformationFull

（0x01030500）：更饱满的声音。

AgoraVoiceBeautifierTimbreTransformationClear

（0x01030600）：更清晰的声音。

AgoraVoiceBeautifierTimbreTransformationResounding

（0x01030700）：更响亮的声音。

AgoraVoiceBeautifierTimbreTransformatRinging

（0x01030800）：更有穿透力的声音。

AgoraVoiceBeautifierUltraHighQuality

（0x01040100）：超高音质效果，使音频更清晰并还原更多细节。

注： 为获得更好的音效质量，声网建议在调用 setVoiceBeautifierPreset: 前，将 setAudioProfile: 的 profile 设置为 AgoraAudioProfileMusicHighQuality（4）或 AgoraAudioProfileMusicHighQualityStereo（5），并将 scenario 设置为 AgoraAudioScenarioGameStreaming（3）。如果你的音频采集设备已能高度还原音频细节，声网建议不要启用超高音质，否则 SDK 可能会过度还原音频细节，导致无法听到预期的声音效果。

表格内容超出当前宽度，可横向滚动查看更多列。

这个页面有帮助吗？

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利