美颜

功能简介

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

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

前提条件

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

已在项目中集成 ZegoEffects SDK，实现基本的图像处理功能，详情请参考快速开始 - 实现图像处理。

导入基础通用资源 “CommonResources” 文件，详情请参考快速开始 - 导入资源和模型。

使用步骤

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

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

美白

注意

使用美白功能前，请先导入对应的 “FaceWhiteningResources” 资源文件，否则功能无法生效。详情请参考快速开始 - 导入资源和模型。

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

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

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

// 设置美白的程度，范围 [0, 100]，默认为 50
mEffects.setWhitenParam({ intensity: 100 });

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

// 设置美白的程度，范围 [0, 100]，默认为 50
mEffects.setWhitenParam({ intensity: 100 });

磨皮

调用 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];

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

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

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

// 设置磨皮的程度，范围 [0, 100]，默认为 50

mEffects.setSmoothParam({ intensity: 100 });

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

// 设置磨皮的程度，范围 [0, 100]，默认为 50

mEffects.setSmoothParam({ intensity: 100 });

红润

注意

使用红润功能前，请先导入对应的 “RosyResources” 资源文件，否则功能无法生效。详情请参考快速开始 - 导入资源和模型。

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

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

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

// 设置红润的程度，范围 [0, 100]，默认为 50
mEffects.setRosyParam({ intensity: 100 });

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

// 设置红润的程度，范围 [0, 100]，默认为 50
mEffects.setRosyParam({ intensity: 100 });

锐化

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

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

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

// 设置锐化的程度，范围 [0, 100]，默认为 50

mEffects.setSharpenParam({ intensity: 100 });

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

// 设置锐化的程度，范围 [0, 100]，默认为 50

mEffects.setSharpenParam({ intensity: 100 });

去除法令纹

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

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

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

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

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

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

去除黑眼圈

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

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

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

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

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

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

祛痘斑

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

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

// 开启祛痘斑功能
mEffects.enableAcneRemoving(true);

// 设置祛痘斑的程度，范围 [0, 100]，默认为 0
mEffects.setAcneRemovingParam({ intensity: 100 });

// 开启祛痘斑功能
mEffects.enableAcneRemoving(true);

// 设置祛痘斑的程度，范围 [0, 100]，默认为 0
mEffects.setAcneRemovingParam({ intensity: 100 });

清晰效果

注意

使用清晰效果功能前，请先导入对应的 “ClarityResources” 资源文件，否则功能无法生效。详情请参考快速开始 - 导入资源和模型。

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

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

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

// 设置清晰的程度，范围 [0, 100]，默认为 0
mEffects.setClarityParam({ intensity: 100 });

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

// 设置清晰的程度，范围 [0, 100]，默认为 0
mEffects.setClarityParam({ intensity: 100 });

调整肤色效果

注意

调整肤色效果，请先导入“SkinColorResources” 对应的皮肤资源文件并加载，否则功能无法正常生效。详情请参考快速开始 - 导入资源和模型。

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

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

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

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

// 设置肤色的程度，范围 [0, 100]，默认为 0;
mEffects.setSkinColorParam({ intensity: 100 });

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

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

// 设置肤色的程度，范围 [0, 100]，默认为 0;
mEffects.setSkinColorParam({ intensity: 100 });

美颜