RTC SDK 提供基础美颜和智能美化特效两种美颜功能,且二者不能共用。
自客户端 SDK 3.42 起,基础美颜功能可用。
你已经集成了 RTC SDK,并实现音视频通话功能。
基础美颜依赖智能美化特效 CV SDK,RTC SDK 包中提供了可用于基础美颜的 CV SDK。你也可以选择其他版本的 CV SDK(版本不低于 4.4.2)。集成方法参看智能美化特效。
基础美颜首次运行时需要连接网络下载所需文件,因此需要确保你的设备具有网络连接,且系统时间正常。
调用 enableEffectBeauty,将参数 enable 设置为 true,开启基础美颜。各基础美颜模式的强度默认值分别为:美白 0.7,磨皮 0.8,锐化 0.5,清晰 0.7。
调用 setBeautyIntensity 调整基础美颜强度。 若在开启基础美颜前设置调用,则对应美颜功能的强度初始值会根据设置更新。 销毁引擎后,强度设置将会失效,再次开启美颜时强度恢复默认值。
调用 enableEffectBeauty,将参数 enable 设置为 false,关闭基础美颜。
首次安装 App 时,调用enableEffectBeauty(true)会返回 -1004,这表明当前正在下载美颜所需文件,下载完成后美颜会自动生效。文件下载成功后,后续开启基础美颜将立即生效,接口返回 0。
基础美颜的有效强度范围为 [0, 1],超过此范围则不生效。强度设置为 0 时无效果。
RTCVideo mRTCVideo = RTCVideo.createRTCVideo(...);
// 开启基础美颜,各基础美颜模式的强度默认值分别为:美白 0.7,磨皮 0.8,锐化 0.5,清晰 0.7。
mRTCVideo.enableEffectBeauty(true);
// 调节美颜强度,例如将美白强度调整至 0.8
mRTCVideo.setBeautyIntensity(EffectBeautyMode.EFFECT_WHITE_MODE, 0.8);
// 关闭基础美颜,关闭后画面无美颜效果
mRTCVideo.enableEffectBeauty(false);
// 调节磨皮强度,例如将磨皮强度调节至 0.2
mRTCVideo.setBeautyIntensity(EffectBeautyMode.EFFECT_SMOOTH_MODE, 0.2);
// 开启基础美颜,开启后美白强度为 0.8, 磨皮强度为 0.2,锐化强度为 0.5
mRTCVideo.enableEffectBeauty(true);
java// 开启基础美颜,各基础美颜模式的强度默认值分别为:美白 0.7,磨皮 0.8,锐化 0.5,清晰 0.7。
[self.rtcVideo enableEffectBeauty:YES];
// 调节美颜强度,例如将美白强度调整至 0.8
[self.rtcVideo setBeautyIntensity:ByteRTCEffectWhiteMode withIntensity:0.8f];
// 关闭基础美颜,关闭后画面无美颜效果
[self.rtcVideo enableEffectBeauty:NO];
// 调节磨皮强度,例如将磨皮强度调节至 0.2
[self.rtcVideo setBeautyIntensity:ByteRTCEffectSmoothMode withIntensity:0.2f];
// 开启基础美颜,开启后美白强度为 0.8, 磨皮强度为 0.2,锐化强度为 0.5
[self.rtcVideo enableEffectBeauty:YES];
objectivec| Android | iOS | Windows | |
|---|---|---|---|
| 开启/关闭基础美颜 | enableEffectBeauty | enableEffectBeauty: | enableEffectBeauty |
| 调整基础美颜强度 | setBeautyIntensity | setBeautyIntensity:withIntensity: | setBeautyIntensity |