美声特效
融云音视频 SDK 以插件库的形式提供了多种声音特效选项。本音效插件只对麦克风采集的数据做处理，且不会对耳返的原始声音造成影响，仅远端订阅用户能听到处理后的效果。RTCLib 从 5.1.12 版本开始，支持集成声音特效插件库 VoiceBeautifier 来实现声音特效功能。
集成插件
插件支持 CallKit, CallLib, RTCLib。插件版本需要与主 SDK 版本保持一致。
-
maven 集成方式：注意替换 x.y.z 为具体版本号。可前往 融云官网 SDK 下载页面 或 融云的 Maven 代码库 查询。
implementation 'cn.rongcloud.sdk:voice_beautifier:x.y.z' -
本地集成方式：
- 融云 官网下载 手动集成，选择音效选项 SDK 下载。
- 将加载的 VoiceBeautifier module 引用到您的工程中，在使用音效的 module 中添加依赖。
implementation project(':VoiceBeautifier')
启用插件
集成音效 SDK 后，默认不启用音效效果。调用 RCRTCVoiceBeautifierEngine 的 enable 方法启用插件。启用成功后，可通过 setPreset 方法设置效果。例如，设置为男孩音效（RCRTCVoiceBeautifierPreset.BOY）。
RCRTCVoiceBeautifierEngine.getInstance().enable(true, new IRCRTCResultCallback() {
@Override
public void onFailed(RTCErrorCode errorCode) {
}
@Override
public void onSuccess() {
RCRTCVoiceBeautifierEngine.getInstance().setPreset(RCRTCVoiceBeautifierPreset.BOY);
}
});
声音特效种类
RCRTCVoiceBeautifierPreset 中提供了预设音效，提供美声、变声、混响三类效果。
| 音效枚举 | 特效类别 | 说明 |
|---|---|---|
| NONE | 原声 | 关闭 |
| FULL | 美声 | 饱满 |
| LOW | 美声 | 低沉 |
| HYPERACTIVITY | 美声 | 高亢 |
| MAGNETIC | 美声 | 磁性（SDK ≧ 5.4.1） |
| FRESH | 美声 | 清新（SDK ≧ 5.4.1） |
| VITALITY | 美声 | 活力（SDK ≧ 5.4.1） |
| MELLOW | 美声 | 圆润（SDK ≧ 5.4.1） |
| CLEAR | 美声 | 清澈（SDK ≧ 5.4.1） |
| RINGING | 美声 | 嘹亮（SDK ≧ 5.4.1） |
| VIGOROUS | 美声 | 浑厚（SDK ≧ 5.4.1） |
| FALSETTO | 变声 | 假声 |
| BOY | 变声 | 男孩 |
| BOY_TO_MAN | 变声 | 男青年 |
| OLD_MAN | 变声 | 老年人 |
| GIRL | 变声 | 女孩 |
| SISTER | 变声 | 小姐姐 （SDK ≧ 5.4.1） |
| GIRL_TO_WOMAN | 变声 | 女孩变女人 |
| PIGKING | 变声 | 猪八戒（SDK ≧ 5.4.1） |
| HULK | 变声 | 绿巨人 |
| KTV | 混响 | KTV |
| VOCAL_CONCERT | 混响 | 演唱会 |
| STUDIO | 混响 | 录音棚（SDK ≧ 5.4.1） |
| PHONOGRAPH | 混响 | 留声机（SDK ≧ 5.4.1） |
| STEREO | 混响 | 立体声（SDK ≧ 5.4.1） |
| VALLEY | 混响 | 空旷（SDK ≧ 5.4.1） |
| LOBBY | 混响 | 3D 环绕（SDK ≧ 5.4.1） |
性能与功耗
声音特效插件 RCRTCVoiceBeautifier 自身包体积为 5M 左右，使用声音特效插件会增加 CPU 与运行内存使用率。以下参考值来自融云实验室自测评估，仅供参考：
- CPU 消耗增加 7% 左右。
- 内存（RAM）消耗增加 2M 左右。