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

RTC小课堂
1 阅读6分钟

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

一、常用场景

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

  • 直播互动：主播用变声搞怪、混响烘托直播氛围

  • 语聊房：用户切换男声/女声/机器人声，增加社交趣味性

  • K歌房：搭配KTV、演唱会混响，模拟真实演唱环境

  • 游戏语音：3D虚拟立体声实现听声辨位，强化游戏体验

  • 社交娱乐：空灵、电音等特效打造个性化声音

二、前置准备（必做）

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

  1. 已在ZEGO控制台创建项目，获取有效AppID

  2. 项目已集成ZEGO Express SDK，实现基础音视频推拉流功能

  3. 已获取麦克风权限，确保音频采集正常

  4. 开发环境：Android Studio、适配Android 5.0以上系统

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

  1. 变声

1.1设置预设变声

调用 setVoiceChangerPreset 方法使用 SDK 预置的变声效果。

ZegoVoiceChangerPreset 预置的变声效果如下，开发者可以根据需要选择：

类型名描述变声类型
NONE无变声-
MEN_TO_CHILD男声变童声变声
MEN_TO_WOMEN男声变女声变声
WOMEN_TO_CHILD女声变童声变声
WOMEN_TO_MEN女声变男声变声
FOREIGNER外国人声效变声
OPTIMUS_PRIME擎天柱声效变声
ANDROID机器人声效变声
ETHEREAL空灵声效音色变换
MALE_MAGNETIC磁性男房间美声
FEMALE_FRESH清新女房间美声
MAJOR_CC 大调电音电音音效
MINOR_AA 小调电音电音音效
HARMONIC_MINOR和声小调电音电音音效
FEMALE_ENERGETIC女活力音效房间美声
RICH_NESS浑厚音效房间美声
MUFFLED低沉音效房间美声
ROUNDNESS圆润音效房间美声
FALSETTO假音音效房间美声
FULLNESS饱满音效房间美声
CLEAR清澈音效房间美声
HIGHLY_RESONANT高亢音效房间美声
LOUD_CLEAR嘹亮音效房间美声
MINIONS小黄人音效变声
AUTOBOT汽车人音效变声
OUT_OF_POWER没电了音效变声

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

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);

  1. 混响

2.1 设置预设混响

调用 setReverbPreset 通过预设枚举设置混响。

ZegoReverbPreset 预置的混响效果如下，开发者可以根据需要选择：

类型名描述混响类型
NONE无-
SOFT_ROOM小房间空间塑造
LARGE_ROOM大房间空间塑造
CONCERT_HALL音乐厅空间塑造
VALLEY山谷空间塑造
RECORDING_STUDIO录音室空间塑造
BASEMENT地下室空间塑造
KTVKTV，适用于音色瑕疵较为明显的用户空间塑造
POPULAR流行曲风
ROCK摇滚曲风
VOCAL_CONCERT演唱会空间塑造
GRAMO_PHONE留声机空间塑造
ENHANCED_KTV增强型 KTV，更集中、亮度更好的 KTV 人声效果，适用于普通用户和专业用户空间塑造

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

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);

  1. 虚拟立体声

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歌等实时互动应用，快速提升产品趣味性与竞争力。→ 了解详细文档

avatar
文章
阅读
粉丝