实时音视频
  • iOS
  • Android : Java
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web
  • 小程序
  • Flutter
  • Electron
  • Unreal Engine
  • Unity3D
  • uni-app
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 体验 App
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 实时音视频 SDK 与实时语音 SDK 差异
    • 场景化音视频配置
  • 通信能力
  • 房间能力
  • 音频能力
  • 视频能力
  • 直播能力
  • 其他能力
  • 最佳实践
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 实时音视频
  • 音频能力
  • 变声
  • 混响
  • 立体声

变声/混响/立体声

更新时间:2024-01-02 18:48

功能简介

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

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

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

该功能只针对 SDK 采集的声音有效,开发者可以在通话或直播过程中动态调整变声、混响、混响回声、虚拟立体声。

示例源码下载

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

相关源码请查看 “/ZegoExpressExample/AdvancedAudioProcessing/src/main/java/im/zego/advancedaudioprocessing/voicechange” 目录下的文件。

前提条件

在进行变声/混响/立体声之前,请确保:

使用步骤

变声

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

设置预设变声

如果需要设置自定义变声,请查看 设置自定义变声

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

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

类型名 预设值 描述 变声类型
NONE 0 无变声 -
MEN_TO_CHILD 1 男声变童声 变声
MEN_TO_WOMEN 2 男声变女声 变声
WOMEN_TO_CHILD 3 女声变童声 变声
WOMEN_TO_MEN 4 女声变男声 变声
FOREIGNER 5 外国人声效 变声
OPTIMUS_PRIME 6 擎天柱声效 变声
ANDROID 7 机器人声效 变声
ETHEREAL 8 空灵声效 音色变换
MALE_MAGNETIC 9 磁性男 房间美声
FEMALE_FRESH 10 清新女 房间美声
MAJOR_C 11 C 大调电音 电音音效
MINOR_A 12 A 小调电音 电音音效
HARMONIC_MINOR 13 和声小调电音 电音音效
FEMALE_ENERGETIC 14 女活力音效 房间美声
RICH_NESS 15 浑厚音效 房间美声
MUFFLED 16 低沉音效 房间美声
ROUNDNESS 17 圆润音效 房间美声
FALSETTO 18 假音音效 房间美声
FULLNESS 19 饱满音效 房间美声
CLEAR 20 清澈音效 房间美声
HIGHLY_RESONANT 21 高亢音效 房间美声
LOUD_CLEAR 22 嘹亮音效 房间美声
MINIONS 23 小黄人音效 变声

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

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

设置自定义变声

如果需要设置预设变声,请查看 设置预设变声

若 SDK 预置的变声效果无法满足需求,开发者可以调用 setVoiceChangerParamZegoVoiceChangerParam 方法,通过音高参数 “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);

混响

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

设置预设混响

如果需要设置自定义混响,请查看 设置自定义混响

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

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

类型名 预设值 描述 混响类型
NONE
0
-
SOFT_ROOM
1
小房间
空间塑造
LARGE_ROOM
2
大房间
空间塑造
CONCERT_HALL
3
音乐厅
空间塑造
VALLEY
4
山谷
空间塑造
RECORDING_STUDIO
5
录音室
空间塑造
BASEMENT
6
地下室
空间塑造
KTV
7
KTV,适用于音色瑕疵较为明显的用户
空间塑造
POPULAR
8
流行
曲风
ROCK
9
摇滚
曲风
VOCAL_CONCERT
10
演唱会
空间塑造
GRAMO_PHONE
11
留声机
空间塑造
ENHANCED_KTV
12
增强型 KTV,更集中、亮度更好的 KTV 人声效果,适用于普通用户和专业用户
空间塑造

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

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

设置自定义混响

如果需要设置预设混响,请查看 设置预设混响

若 SDK 预设的混响类型无法满足需求,开发者可以调用 setReverbAdvancedParamZegoReverbAdvancedParam 方法,通过相关参数搭配设置,实现开发者需要的混响效果(详细参数说明请参考 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 预设枚举方法进行设置。

混响回声

调用 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 设置推流音频声道数

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

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

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

2 设置虚拟立体声参数

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

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

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

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

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

ZegoExpressEngine.getEngine().enableVirtualStereo(true, -1);
本篇目录