变声/混响/立体声

---

功能简介

在直播、语聊房、K 歌房场景中，为增加趣味性和互动性，玩家可以通过变声来搞怪，通过混响烘托气氛，通过立体声使声音更具立体感。ZegoExpress SDK 提供了多种预设的变声、混响、混响回声、立体声效果，开发者可以灵活设置自己想要的声音，如果需要试听，可以启用耳返进行测试。

• 变声：通过改变用户的音调，使输出的声音在感官上与原始声音不同，实现男声变女生等多种效果。
• 混响：通过对声音的特殊处理，制造不同环境的混响效果，让声音如同在音乐厅、大教堂等场景中发出一般。
• 混响回声：通过对声音的特殊处理，可搭配变声、混响以实现自定义各式各样的声音效果，例如空灵，机器人的声音。
• 虚拟立体声：通过深度使用双声道技术，虚拟出发音源的各个位置角度，实现立体声、3D 环绕音、听声辩位等效果。

您可通过 ZEGO 提供的 音效体验 DEMO 体验 SDK 预设的人声效果。

示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “lib\topics\AudioAdvanced\voice_change” 目录下的文件。

前提条件

在进行变声/混响/立体声之前，请确保：

• 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。

使用步骤

变声

有两种方式设置变声，分别为预设变声和自定义变声。

设置预设变声

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

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

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

ZegoExpressEngine.instance.setVoiceChangerPreset(ZegoVoiceChangerPreset.MenToChild);

设置自定义变声

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

var voiceChangerParam = ZegoVoiceChangerParam(2.0);
ZegoExpressEngine.instance.setVoiceChangerParam(ZegoMediaPlayerAudioChannel.All, param);

混响

有两种方式设置混响，分别为预设混响和自定义混响。

设置预设混响

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

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

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

ZegoExpressEngine.instance.setReverbPreset(ZegoReverbPreset.LargeRoom);

设置自定义混响

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

var reverbParam = ZegoReverbAdvancedParam(
    50.0, // roomSize 房间大小（百分比）
    50.0, // reverberance 余响（百分比）
    50.0, // damping 混响阻尼（百分比）
    false, // wetOnly 只有湿信号
    5.0, // wetGain 湿信号增益(dB)
    5.0, // dryGain 干信号增益(dB)
    80.0, // toneLow 低频衰减
    80.0, // toneHigh 高频衰减
    20.0, // preDelay 初始延迟时间(ms)
    0.0 // stereoWidth 立体声宽度（百分比）
   );
ZegoExpressEngine.instance.setReverbAdvancedParam(reverbParam);

混响回声

调用 setReverbEchoParam 方法，通过相关参数搭配设置，实现开发者需要的混响回声效果（详细参数说明请参考 API 文档）。

以下示例代码以实现“空灵声效”为例：

var echoParam = ZegoReverbEchoParam(
    0.8, // inGain 输入音频信号的增益
    1.0, // outGain 输出音频信号的增益
    7, // numDelays 回声数量
    [230,460,690,920,1150,1380,1610], // delay 回声信号分别的延时，单位为毫秒
    [0.41f,0.18f,0.08f,0.03f,0.009f,0.003f,0.001f] // decay 回声信号分别的衰减系数
    );
ZegoExpressEngine.instance.setReverbEchoParam(echoParam);

虚拟立体声

设置推流音频声道数

如果需要开启虚拟立体声功能，必须在推流前先调用 setAudioConfig 方法设置音频编码声道为 Stereo 双声道 （默认为 Mono 单声道）。

此处示例通过预设枚举构造 ZegoAudioConfig 设置为双声道。

var audioConfig = ZegoAudioConfig.preset(ZegoAudioConfigPreset.StandardQualityStereo);
ZegoExpressEngine.instance.setAudioConfig(audioConfig);

设置虚拟立体声参数

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

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

ZegoExpressEngine.instance.enableVirtualStereo(true, 90);

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

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