基础美颜

---

功能简介

ZEGO 提供基础美颜功能，为用户呈现出良好的肌肤状态，打造独特自然的美颜效果。该功能常用于视频通话、直播等场景。

开发者可以开启美颜开关，然后根据需要调整美白、磨皮、锐化以及红润的程度，轻松实现基础美颜功能。

前提条件

在实现美颜功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

使用步骤

初始化基础美颜环境

若您需要使用基础美颜功能，则必须在 startPreview 开始预览、startPublishingStream 推流前，调用 startEffectsEnv 接口初始化美颜环境。

// 创建美颜环境 
await this.engine.startEffectsEnv();

开关基础美颜效果

初始化美颜环境后，您可以在推流前后，调用 enableEffectsBeauty 接口实时开启或关闭美颜效果。

// 开关美颜效果 
await this.engine.enableEffectsBeauty(true);

设置基础美颜效果参数

初始化美颜环境后，您可以在推流前后，调用 setEffectsBeautyParam 接口实时设置美颜效果参数。

• smoothIntensity：磨皮，在保留脸部细节的基础上进行磨皮，比如脸上的痣会保留。
• whitenIntensity：美白，对画面整体调高亮度来美白脸部。
• rosyIntensity：红润，对画面整体进行暖色处理。
• sharpenIntensity：锐化，对画面整体进行锐化处理，当画面有些模糊时可以稍微调大锐化使轮廓清晰。

以上四个参数的取值范围都为 0 ～ 100，取值越大美颜程度越高，默认值为 50。

// 创建美颜参数对象
let beautyParam = {};

// 美白、红润、磨皮、锐化
beautyParam.whitenIntensity = 50;
beautyParam.rosyIntensity = 50;
beautyParam.smoothIntensity = 50;
beautyParam.sharpenIntensity = 50;

// 设置美颜参数 
await this.engine.setEffectsBeautyParam(beautyParam);

销毁基础美颜环境

当调用 enableEffectsBeauty 接口设为 “false” 时，会关闭美颜效果，但美颜模块还是会占用资源并消耗性能。如果想彻底释放资源，节省性能消耗，则需要在预览和推流前调用 stopEffectsEnv 接口销毁美颜环境。

// 销毁美颜环境 
await this.engine.stopEffectsEnv();