美颜处理
本文描述如何在融云音视频 SDK 基础上实现美颜功能。
官方美颜插件
您可以使用融云官方提供了基础美颜插件。
步骤 1:插件集成
集成要求使用的 CallLib 或 RTCLib 版本不小于 5.1.4。有以下两种集成方式:
Maven 集成
在 app/build.gradle
中填入:
dependencies {
...
// x.y.z,请填写具体的 SDK 版本号,需与 CallLib 或 RTCLib 的版本号保持一致。
implementation 'cn.rongcloud.sdk:face_beautifier:x.y.z' // 美颜扩展库(可选)
}
本地集成
-
融云 官网下载 手动集成,选择美颜选项 sdk 下载。
-
将下载的 FaceBeautifier 模块引用到您的工程中。在使用音效的 Module 中添加依赖:
implementation project(':FaceBeautifier')
步骤 2:插件使用
目前融云 Android 音视频 SDK 只支持 Texture 纹理类型为 RGB 视频格式的美颜。即需要在代码中打开 enableEncoderTexture
设置,美颜功能才会生效:
RCRTCEngine.getInstance().init(getApplicationContext(), RCRTCConfig.Builder.create().enableEncoderTexture(true).build());
美颜参数设置分为基础值设置和滤镜设置。详细值及接口说明请参考 接口文档。
美颜基础参数
基础参数目前包括:美白、磨皮、亮度、红润四个参数,取值范 围为 [0-10],0 代表无效果,10 代表最大效果。代码示例如下:
RCRTCBeautyOption beautyOption = RCRTCBeautyEngine.getInstance().getCurrentBeautyOption();
if (seekTypId == R.id.beauty_whiteness) {
beautyOption.setWhitenessLevel(progress); // 设置美白参数
} else if (seekTypId == R.id.beauty_smooth) {
beautyOption.setSmoothLevel(progress); // 设置磨皮参数
} else if (seekTypId == R.id.beauty_bright) {
beautyOption.setBrightLevel(progress); // 设置亮度参数
} else if (seekTypId == R.id.beauty_ruddy) {
beautyOption.setRuddyLevel(progress); // 设置红润参数
}
RCRTCBeautyEngine.getInstance().setBeautyOption(true, beautyOption); // true 是使用美颜,false 不使用美颜
美颜滤镜设置
滤镜目前包括:唯美、清新、浪漫三种风格,代码示例如下:
RCRTCBeautyFilter beautyFilter = RCRTCBeautyEngine.getInstance().getCurrentFilter();
switch (checkedId){
case 0:{
RCRTCBeautyEngine.getInstance().setBeautyFilter(RCRTCBeautyFilter.NONE); // 不使用美颜滤镜
break;
}
case 1:{
RCRTCBeautyEngine.getInstance().setBeautyFilter(RCRTCBeautyFilter.ESTHETIC); // 唯美
break;
}
case 2:{
RCRTCBeautyEngine.getInstance().setBeautyFilter(RCRTCBeautyFilter.FRESH); // 清新
break;
}
case 3:{
RCRTCBeautyEngine.getInstance().setBeautyFilter(RCRTCBeautyFilter.ROMANTIC); // 浪漫
break;
}
default:{
Log.e(TAG, "onCheckedChanged: [group, checkedId]" + checkedId);
break;
}
}
相芯美颜插件
从 5.2.5.3 版本开始,融云 RTCLib SDK 支持相芯美颜插件。使用相芯美颜需要购买相关授权,详情请咨询融云商务。
相芯美颜插件支持美颜、滤镜、美形和美肤功能。后续版本将完善对相芯 SDK 的封装。如需实现更多特效,您可以直接集成相芯 SDK。
当前不支持同时使用官方美颜和相芯美颜插件。
插件对应的相芯 SDK 的版本号为 8.3.0。暂不支持加载用户自定义的 bundle。
集成相芯美颜插件
从 5.2.5.3 开始,支持通过融云的 Maven 集成,请在 app/build.gradle
文件中添加下面内容:
dependencies {
...
// x.y.z,请填写具体的 SDK 版本号,需与 CallLib 或 RTCLib 的版本号保持一致。
implementation 'cn.rongcloud.sdk:fu_beautifier:x.y.z' // 相芯美颜扩展库(可选)
}
x.y.z 代表当前 RTCLib 的具体版本号。您可以在融云下载页或融云 Maven 仓库进行查询。
初始化
如果 SDK 版本 < 5.4.0,必须先初始化 RCRTCEngine
引擎,再初始化相芯美颜插件。
初始化相芯美颜插件时,请提供有效的相芯美颜的授权文件(请联系融云商务购买)。应用运行期间只调用一次即可,建议在 Application#onCreate
中初始化。
RCRTCFUBeautifierEngine.getInstance().register(null, authpack.A());
美颜开关
打开美颜开关后设置的美颜效果才会生效;关闭开关美颜会失效。
RCRTCFUBeautifierEngine.getInstance().setBeautyEnable(enabled);
滤镜设置
滤镜可设置自然、白亮、冷色调、粉嫩、黑白、暖色调、蜜桃等效果。参数分两种:滤镜类别、滤镜级别。
RCRTCFUBeautifierEngine.getInstance().setFilter(FaceBeautyFilterEnum.FENNEN_1, (float) val);
美型设置
美型可设置瘦脸程度、V脸程度、窄脸程度、小脸程度、瘦鼻程度、嘴巴调整程度、开眼角强度、眼睛间距、鼻子长度、人中长度、微笑嘴角强度、瘦颧骨强度等效果。下面是设置瘦脸程度的接口调用示例,其他接口请参考相芯美颜插件 Javadoc 文档。
RCRTCFUBeautifierEngine.getInstance().setCheekThinningLevel((float) val);
美肤设置
可设置磨皮、美白、红润、锐化、亮眼、美牙、去除黑眼圈、去除法令纹强度等。下面是设置磨皮强度的接口调用示例,其他接口请参考相芯美颜插件 Javadoc 文档。
// 设置磨皮强度
RCRTCFUBeautifierEngine.getInstance().setSkinBlurLevel((float) val);