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

功能变更日志

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

前提条件
操作步骤
  1. 调用 enableEffectBeauty,将参数 enable 设置为 true,开启基础美颜。各基础美颜模式的强度默认值分别为:美白 0.7,磨皮 0.8,锐化 0.5,清晰 0.7。

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

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