RTC SDK 提供基础美颜和高级视频特效功能,且二者不能共用。基础美颜提供美白、锐化、磨皮效果,广泛适用于视频通话、直播等场景。高级视频特效提供美颜、滤镜、背景贴纸等高级特效,参看 RTC 和智能美颜特效产品深度融合打造的美颜特效功能。
自客户端 SDK 3.42 起,基础美颜功能可用。
你已经集成了 RTC SDK,并实现音视频通话功能。
基础美颜依赖特效 SDK,RTC SDK 包中提供了可用于基础美颜的特效 SDK。你也可以选择其他版本的特效 SDK(版本不低于 4.3.2)。集成方法参看如何集成 CV SDK 动态库。
基础美颜首次运行时需要连接网络下载所需文件,因此需要确保你的设备具有网络连接,且系统时间正常。
调用 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 |