变声/混响/立体声

功能简介

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

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

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

前提条件

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

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

使用步骤

变声

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

设置预设变声

1. 调用 createZegoStream 接口，创建 ZegoLocalStream 媒体流。

// 变声模块引入
import {VoiceChanger} from "zego-express-engine-webrtc/voice-changer";
// 需要在 new ZegoExpressEngine 前调用
ZegoExpressEngine.use(VoiceChanger);
// 初始化实例
const zg = new ZegoExpressEngine(appID, server);
// 创建媒体流
const localstream = await zg.createZegoStream();

// 变声模块引入
import {VoiceChanger} from "zego-express-engine-webrtc/voice-changer";
// 需要在 new ZegoExpressEngine 前调用
ZegoExpressEngine.use(VoiceChanger);
// 初始化实例
const zg = new ZegoExpressEngine(appID, server);
// 创建媒体流
const localstream = await zg.createZegoStream();

2. 设置变声效果。调用 setVoiceChangerPreset 接口，传入需要进行变声的媒体流，开始变声处理，并完成变声处理的相关设置。

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

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

// localStream 为通过 createZegoStream 创建的 zego 流对象
zg.setVoiceChangerPreset(1, localStream);

// localStream 为通过 createZegoStream 创建的 zego 流对象
zg.setVoiceChangerPreset(1, localStream);

设置自定义变声

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

// localStream 为通过 createZegoStream 创建的 zego 流对象
zg.setVoiceChangerParam(localStream, 5);

// localStream 为通过 createZegoStream 创建的 zego 流对象
zg.setVoiceChangerParam(localStream, 5);

混响

创建媒体流

调用 createZegoStream 接口，创建 ZegoLocalStream 媒体流，示例代码请参考 变声 的第 1 步。

设置混响效果

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

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

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

// localStream 为通过 createZegoStream 创建的 zego 流对象
zg.setReverbPreset(localStream, 2);

// localStream 为通过 createZegoStream 创建的 zego 流对象
zg.setReverbPreset(localStream, 2);

虚拟立体声

设置推流音频声道数

如果需要开启虚拟立体声功能，必须在创建 ZegoLocalStream 媒体流时设置双声道，即调用 createZegoStream 方法时，设置 ZegoStreamOptions.camera.audio.channelCount 为 2（默认为单声道）。

示例代码为创建一个双声道的纯音频媒体流。

const localStream = await zg.createZegoStream({
    camera: {
        video: false,
        audio: {
            channelCount: 2
        },
    }
});

const localStream = await zg.createZegoStream({
    camera: {
        video: false,
        audio: {
            channelCount: 2
        },
    }
});

设置虚拟立体声参数

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

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

zg.enableVirtualStereo(localStream, true, 90);

zg.enableVirtualStereo(localStream, true, 90);

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

zg.enableVirtualStereo(localStream, true, -1);

zg.enableVirtualStereo(localStream, true, -1);

常见问题

1. 在 Safari 浏览器上，拉流方开启麦克风采集时，为什么没有立体声效果了？

   在拉流方开启麦克风采集的情况下，拉流渲染的声音会变成 单声道 效果。如果需要在拉流时保持 立体声 效果，拉流方应关闭麦克风采集。