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