RTC SDK 提供基础美颜和智能美化特效两种美颜功能,且二者不能共用。

功能变更日志

自客户端 SDK 3.42 起,基础美颜功能可用。

前提条件
使用步骤
  1. 调用 enableEffectBeauty,将参数 enable 设置为 true,开启基础美颜。 若未在开启前设置基础美颜强度,则美白、锐化、磨皮的默认强度为 0.5。

  2. 调用 setBeautyIntensity 调整基础美颜强度。 若在开启基础美颜前设置调用,则对应美颜功能的强度初始值会根据设置更新。 销毁引擎后,强度设置将会失效,再次开启美颜时强度恢复默认值。

  3. 调用 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
API 参考
AndroidiOSWindows
开启/关闭基础美颜enableEffectBeautyenableEffectBeauty:enableEffectBeauty
调整基础美颜强度setBeautyIntensitysetBeautyIntensity:withIntensity:setBeautyIntensity