美颜

---

1 功能简介

ZegoEffects SDK 提供美颜功能，为用户呈现出良好的肌肤状态，打造出独特自然的美颜效果。

开发者可以根据需要调整美白、磨皮、锐化等的程度，实现美颜功能。

2 前提条件

在使用 ZegoEffects SDK 美颜功能前，请确保：

• 已在项目中集成 ZegoEffects SDK，实现基本的图像处理功能，详情请参考 快速开始 - 集成 SDK。
• 已上传待处理图像的宽、高。
• 导入基础通用资源 “CommonResources” 文件，详情请参考 快速开始 - 导入资源和模型。

3 使用步骤

美颜包括美白、磨皮、锐化、红润等功能。

开启美颜功能之后，开发者可根据实际的需求来自定义美颜参数。如果未自定义，SDK 将采用默认参数值实现美颜功能。

3.1 美白

调用 enableWhiten 接口开启美白功能，并调用 setWhitenParam 接口设置美白的程度。

ZegoEffectsWhitenParam 对象的美白程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “50”。取值越大，美白程度越大，开发者可以根据需求自定义取值。

// 开启美白功能
mEffects.enableWhiten(true);   

// 设置美白的程度，范围 [0, 100]，默认为 50
ZegoEffectsWhitenParam param = new ZegoEffectsWhitenParam();
param.intensity = 100;
mEffects.setWhitenParam(param);

3.2 磨皮

调用 enableSmooth 接口开启磨皮功能，并调用 setSmoothParam 接口设置磨皮的程度。

ZegoEffectsSmoothParam 对象的磨皮程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “50”。取值越大，磨皮程度越大，开发者可以根据需求自定义取值。

// 开启磨皮功能
mEffects.enableSmooth(true);

// 设置磨皮的程度，范围 [0, 100]，默认为 50
ZegoEffectsSmoothParam param = new ZegoEffectsSmoothParam();
param.intensity = 100;
mEffects.setSmoothParam(param);

3.3 红润

调用 enableRosy 接口红润功能，并调用 setRosyParam 接口设置红润的程度。

ZegoEffectsRosyParam 对象的红润程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “50”。取值越大，红润程度越大，开发者可以根据需求自定义取值。

// 开启红润功能
mEffects.enableRosy(true)   

// 设置红润的程度，范围 [0, 100]，默认为 50
ZegoEffectsRosyParam param = new ZegoEffectsRosyParam();
param.intensity = 100;
mEffects.setRosyParam(param);

3.4 锐化

调用 enableSharpen 接口开启锐化功能，并调用 setSharpenParam 接口设置锐化的程度。

ZegoEffectsSharpenParam 对象的锐化程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “50”。取值越大，锐化程度越大，开发者可以根据需求自定义取值。

// 开启锐化功能
mEffects.enableSharpen(true);

// 设置锐化的程度，范围 [0, 100]，默认为 50
ZegoEffectsSharpenParam param = new ZegoEffectsSharpenParam();
param.intensity = 100;
mEffects.setSharpenParam(param);

3.5 去除法令纹

调用 enableWrinklesRemoving 接口开启法令纹去除功能，并调用 setWrinklesRemovingParam 接口设置法令纹去除的程度。

ZegoEffectsWrinklesRemovingParam 对象的法令纹去除程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “50”。取值越大，法令纹去除程度越大，开发者可以根据需求自定义取值。

// 开启法令纹去除除功能
mEffects.enableWrinklesRemoving(true);

// 设置法令纹去除的程度，范围 [0, 100]，默认为 50
ZegoEffectsWrinklesRemovingParam param = new ZegoEffectsWrinklesRemovingParam ();
param.intensity = 100;
mEffects.setWrinklesRemovingParam(param);

3.6 去除黑眼圈

调用 enableDarkCirclesRemoving 接口开启黑眼圈去除功能，并调用 setDarkCirclesRemovingParam 接口设置黑眼圈去除的程度。

ZegoEffectsDarkCirclesRemovingParam 对象的黑眼圈去除程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “50”。取值越大，黑眼圈去除程度越大，开发者可以根据需求自定义取值。

// 开启黑眼圈去除功能
mEffects.enableDarkCirclesRemoving(true);

// 设置黑眼圈去除的程度，范围 [0, 100]，默认为 50
ZegoEffectsDarkCirclesRemovingParam param = new ZegoEffectsDarkCirclesRemovingParam ();
param.intensity = 100;
mEffects.setDarkCirclesRemovingParam(param);

3.7 祛痘斑

调用 enableAcneRemoving 接口开启祛痘斑功能，并调用setAcneRemovingParam 接口设置祛痘祛斑的强度。

ZegoEffectsAcneRemovingParam 对象的祛痘斑程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “0”。取值越大，祛痘斑效果强度越大，开发者可以根据需求自定义取值。

// 开启原肤功能
mEffects.enableAcneRemoving(true);

// 设置原肤的程度，范围 [0, 100]，默认为 0
ZegoEffectsAcneRemovingParam param = new ZegoEffectsAcneRemovingParam();
param.intensity = 0;
mEffects.setAcneRemovingParam(param);

3.8 清晰效果

调用 enableClarity 接口开启清晰功能，并调用setClarityParam 接口设置清晰程度。

ZegoEffectsClarityParam 对象的清晰程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “0”。取值越大，越清晰，开发者可以根据需求自定义取值。

// 开启清晰功能
mEffects.enableClarity(true);

// 设置清晰的程度，范围 [0, 100]，默认为 0
ZegoEffectsClarityParam param = new ZegoEffectsClarityParam();
param.intensity = 0;
mEffects.setClarityParam(param);

3.9 调整肤色效果

调用 enableSkinColor 接口开启调整肤色功能，并调用 setSkinColorResPath 加载可支持的皮肤资源，再调用 setSkinColorParam 接口设置肤色效果的程度。

ZegoEffectsSkinColorParam 对象的肤色效果程度参数 “intensity” 的取值范围为 [0, 100]，默认为 “0”。取值越大，皮肤颜色变化越明显，开发者可以根据需求自定义取值。

// 开启肤色功能
mEffects.enableSkinColor(true);

// 加载可支持/指定的肤色资源
String skinResPath = "SkinColorResources/***";
mEffects.setSkinColorResPath(skinResPath);

// 设置肤色的程度，范围 [0, 100]，默认为 0
ZegoEffectsSkinColorParam param = new ZegoEffectsSkinColorParam();
param.intensity = 0;
mEffects.setSkinColorParam(param);