美颜

---

1 功能简介

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

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

2 前提条件

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

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

3 使用步骤

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

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

3.1 美白

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

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

// 开启美白功能
[self.effects enableWhiten:YES];

// 设置美白的程度，范围 [0, 100]，默认为 50
ZegoEffectsWhitenParam *param = [[ZegoEffectsWhitenParam alloc] init];
param.intensity = 100;
[self.effects setWhitenParam:param];

3.2 磨皮

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

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

// 开启磨皮功能
[self.effects enableSmooth:YES];

// 设置磨皮的程度，范围 [0, 100]，默认为 50
ZegoEffectsSmoothParam *param = [[ZegoEffectsSmoothParam alloc] init];
param.intensity = 100;
[self.effects setSmoothParam:param];

3.3 红润

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

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

// 开启红润功能
[self.effects enableRosy:YES];

// 设置红润的程度，范围 [0, 100]，默认为 50
ZegoEffectsRosyParam *param = [[ZegoEffectsRosyParam alloc] init];
param.intensity = 100;
[self.effects setRosyParam:param];

3.4 锐化

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

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

// 开启锐化功能
[self.effects enableSharpen:YES];

// 设置锐化的程度，范围 [0, 100]，默认为 50
ZegoEffectsSharpenParam *param = [[ZegoEffectsSharpenParam alloc] init];
param.intensity = 100;
[self.effects setSharpenParam:param];

3.5 去除法令纹

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

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

// 开启法令纹去除功能
[self.effects enableWrinklesRemoving:YES];

// 设置法令纹去除的程度，范围 [0, 100]，默认为 50
ZegoEffectsWrinklesRemovingParam *param = [[ZegoEffectsWrinklesRemovingParam  alloc] init];
param.intensity = 100;
[self.effects setWrinklesRemovingParam:param];

3.6 去除黑眼圈

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

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

// 开启黑眼圈去除功能
[self.effects enableDarkCirclesRemoving:YES];

// 设置黑眼圈去除的程度，范围 [0, 100]，默认为 50
ZegoEffectsDarkCirclesRemovingParam *param = [[ZegoEffectsDarkCirclesRemovingParam  alloc] init];
param.intensity = 100;
[self.effects setDarkCirclesRemovingParam:param];

3.7 祛痘斑

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

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

// 开启祛痘祛斑功能
[self.effects enableAcneRemoving:YES];

// 设置祛痘祛斑的程度，范围 [0, 100]，默认为 0
ZegoEffectsAcneRemovingParam *param = [[ZegoEffectsAcneRemovingParam  alloc] init];
param.intensity = 0;
[self.effects setAcneRemovingParam:param];

3.8 清晰效果

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

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

// 开启清晰功能
[self.effects enableClarity:YES];

// 设置清晰的程度，范围 [0, 100]，默认为 0
ZegoEffectsClarityParam *param = [[ZegoEffectsClarityParam  alloc] init];
param.intensity = 0;
[self.effects setClarityParam:param];

3.9 调整肤色效果

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

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

// 开启肤色功能
[self.effects enableSkinColor:YES];

// 加载可支持/指定的肤色资源
NSString *skinResPath = @"SkinColorResources/***";
[self.effects setSkinColorResPath:skinResPath];

// 设置肤色的程度，范围 [0, 100]，默认为 0
ZegoEffectsSkinColorParam *param = [[ZegoEffectsSkinColorParam  alloc] init];
param.intensity = 0;
[self.effects setSkinColorParam:param];

相关文档

开启美白后画面整体变黑或者偏蓝，该如何处理？