如何用Android实现变声/混响/立体声

现在做直播、语聊、K歌类APP，音频特效基本是必备的。不用自己搞复杂的算法，ZEGO SDK已经把变声、混响、立体声这些功能都封装好了，一行代码就能调用，操作简单还兼容大部分Android手机。这篇文章就手把手教大家，怎么快速在Android端集成这些趣味音效。

一、常用场景

在实时音视频互动中，音频特效是提升趣味性与沉浸感的核心功能，ZEGO SDK音频处理能力适配以下高频场景：

• 直播互动：主播用变声搞怪、混响烘托直播氛围
• 语聊房：用户切换男声/女声/机器人声，增加社交趣味性
• K歌房：搭配KTV、演唱会混响，模拟真实演唱环境
• 游戏语音：3D虚拟立体声实现听声辨位，强化游戏体验
• 社交娱乐：空灵、电音等特效打造个性化声音

二、前置准备（必做）

在实现变声/混响/立体声功能前，请完成以下基础配置：

1. 已在ZEGO控制台创建项目，获取有效AppID
2. 项目已集成ZEGO SDK，实现基础音视频推拉流功能
3. 已获取麦克风权限，确保音频采集正常
4. 开发环境：Android Studio、适配Android 5.0以上系统

三、ZEGO SDK音频特效实现步骤

1. 变声

1.1设置预设变声
调用 setVoiceChangerPreset 方法使用 SDK 预置的变声效果。
ZegoVoiceChangerPreset 预置的变声效果如下，开发者可以根据需要选择：

以下示例代码以"男声变童声"为例：

ZegoExpressEngine.getEngine().setVoiceChangerPreset(ZegoVoiceChangerPreset.MEN_TO_CHILD);

1.2 设置自定义变声
若 SDK 预置的变声效果无法满足需求，开发者可以调用 setVoiceChangerParam 中 ZegoVoiceChangerParam 方法，通过音高参数 "pitch" 设置自定义变声。该参数取值范围为 [-12.0, 12.0]，值越大声音越尖锐，默认值为 "0.0"（即无变声）。
注意
2.18.0 及以前版本，取值范围为 [-8.0, 8.0]。

ZegoVoiceChangerParam voiceChangerParam = new ZegoVoiceChangerParam();
param.pitch = 2.0f;
ZegoExpressEngine.getEngine().setVoiceChangerParam(param);

2. 混响

2.1 设置预设混响
调用 setReverbPreset 通过预设枚举设置混响。
ZegoReverbPreset 预置的混响效果如下，开发者可以根据需要选择：

以下示例代码以"大房间"模式为例：

ZegoExpressEngine.getEngine().setReverbPreset(ZegoReverbPreset.LARGE_ROOM);

2.2设置自定义混响
若 SDK 预设的混响类型无法满足需求，开发者可以调用 setReverbAdvancedParam 中 ZegoReverbAdvancedParam 方法，通过相关参数搭配设置，实现开发者需要的混响效果（详细参数说明请参考 API 文档）。

ZegoReverbAdvancedParam reverbParam = new ZegoReverbAdvancedParam();
// 混响阻尼
reverbParam.damping = 50.0;
// 余响
reverbParam.reverberance = 50.0;
// 房间大小
reverbParam.roomSize = 50.0;
// 只有湿信号
reverbParam.wetOnly = false;
// 湿信号增益(dB)，取值范围 [-20.0, 10.0]
reverbParam.wetGain = 5.0;
// 干信号增益(dB)，取值范围 [-20.0, 10.0]
reverbParam.dryGain = 5.0;
// 低频衰减，默认为不衰减（100%）
reverbParam.toneLow = 80.0;
// 高频衰减，默认为不衰减（100%）
reverbParam.toneHigh = 80.0;
// 初始延迟时间(ms)。取值范围 [0, 200]
reverbParam.preDelay = 20.0;
// 立体声宽度（百分比），默认值为 0%
reverbParam.stereoWidth = 0.0;
ZegoExpressEngine.getEngine().setReverbAdvancedParam(reverbParam);

注意
当设置自定义混响参数后，启用混响时设置的预设混响效果则会失效。如果想再次使用 SDK 预设参数，可以使用 setReverbPreset 预设枚举方法进行设置。

2.3混响回声
调用 setReverbEchoParam 方法，通过相关参数搭配设置，实现开发者需要的混响回声效果（详细参数说明请参考 API 文档）。
以下示例代码以实现"空灵声效"为例：

ZegoReverbEchoParam echoParam = new ZegoReverbEchoParam();
// 输入音频信号的增益，取值范围 [0.0, 1.0]
echoParam.inGain= 0.8f;
// 输出音频信号的增益，取值范围 [0.0, 1.0]
echoParam.outGain =1.0f;
// 回声数量，取值范围 [0, 7]
echoParam.numDelays = 7;
// 回声信号分别的延时，单位为毫秒，取值范围 [0, 5000] ms
int[] delay ={230,460,690,920,1150,1380,1610};
echoParam.delay=delay;
// 回声信号分别的衰减系数，取值范围 [0.0, 1.0]
float[] decay={0.41f,0.18f,0.08f,0.03f,0.009f,0.003f,0.001f};
echoParam.decay=decay;
zegoReverbEchoParamDatas.add(echoParam);
ZegoExpressEngine.getEngine().setReverbEchoParam(echoParam);

3. 虚拟立体声

3.1 设置推流音频声道数
如果需要开启虚拟立体声功能，必须在推流前先调用 setAudioConfig 方法设置音频编码声道为 Stereo 双声道 （默认为 Mono 单声道）。
此处示例通过预设枚举构造 ZegoAudioConfig 设置为双声道。

ZegoAudioConfig audioConfig = new ZegoAudioConfig(STANDARD_QUALITY_STEREO);
ZegoExpressEngine.getEngine().setAudioConfig(audioConfig);

3.2 设置虚拟立体声参数
设置音频编码声道为双声道后，调用 enableVirtualStereo 方法，通过 "enable" 参数开启虚拟立体声，并通过 "angle" 参数设置虚拟立体声的声源角度后，才有立体声效果。角度范围为 0 ～ 360，一般可设为 90 度（即正前方）。

说明
自从 2.15.0 版本开始，SDK 新增支持全方位虚拟立体声效果，使用方式为将 "angle" 角度参数设置为 "-1"。

此处示例为开启虚拟立体声并将角度设置为 90 度：

ZegoExpressEngine.getEngine().enableVirtualStereo(true, 90);

此处示例为开启全方位虚拟立体声：

ZegoExpressEngine.getEngine().enableVirtualStereo(true, -1);

四、关键避坑点（必看）

1. 虚拟立体声前提：必须先设置双声道，否则立体声无效果
2. 参数冲突：自定义混响设置后，预设混响会失效，需重新调用setReverbPreset恢复
3. 实时调整：可在推流中动态切换特效，无需重启引擎
4. 耳返测试：开启耳返可本地试听特效，避免推流后效果不符
5. 资源释放：退出房间/卸载页面时，关闭特效并释放音频资源
6. SDK版本：2.15.0及以上版本支持全方位立体声（angle=-1）

五、总结

基于ZEGO SDK，Android端实现变声、混响、立体声仅需调用对应API，无需复杂音频算法开发，预设效果覆盖主流场景，自定义参数满足个性化需求，全程低性能损耗、高稳定性，完美适配直播、语聊、K歌等实时互动应用，快速提升产品趣味性与竞争力。→ 了解详细文档