美妆

---

1 功能简介

ZegoEffects SDK 提供美妆功能，包含眼线，眼影，眼睫毛，腮红，口红，美瞳，风格妆等，进行局部上妆，打造出自然精致的妆容，可广泛应用于短视频，直播等场景。

2 前提条件

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

3 使用步骤

美妆提供了以下功能：眼线、眼影、眼睫毛、腮红、口红、美瞳、风格妆。

各个功能包含的风格有：

• 眼线：自然（Natural）、野猫（Cat Eye）、俏皮（naughty）、心机（innocent）、气质（dignified）。
• 眼影：粉雾海（Pink Mist）、微光蜜（Shimmer Pink）、暖茶棕（Tea Brown）、元气橙（Bright Orange）、摩卡棕（Mocha_Brown）。
• 眼睫毛：自然（Natural）、温柔（Tender）、卷翘（Curl）、纤长（Everlong）、浓密（Thick）。
• 腮红：微醺（Slightly Drunk）、蜜桃（Peach）、奶橘（Milky Orange）、杏粉（Apricot Pink）、甜橙（Sweet Orange）。
• 口红：豆沙粉（Cameo Pink）、甜橘色（Sweet Orange）、铁锈红（Rust Red）、珊瑚色（Coral）、丝绒红（Red Velvet）。
• 美瞳：水光黑（Darknight Black）、星空蓝（Starry Blue）、仙棕绿（Mystery Brown-Green）、异瞳棕（Polar Lights Brown）、可可棕（Chocolate Brown）。
• 风格妆：眼睑下至妆（Vulnerable & Innocent Eyes）、银河眼妆（Milky Eyes）、奶凶（Cutie & Cool）、纯欲（Pure & Sexy）、神颜（Flawless）。

开发者在调用接口时，可以根据需要，选择对应的美妆资源使用。

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

3.1 眼线

1. 开启眼线。

   调用 setEyeliner 接口开启/关闭眼线功能，传入对应的眼线绝对路径。调用 setEyelinerParam 接口设置眼线强度。

   ZegoEffectsEyelinerParam 对象的眼线强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启眼线功能
   // 1. 开启眼线功能，并且传入对应的眼线绝对路径
   [self.effects setEyeliner:@"/xxx/xxx/eyelinerdir/eyelinerdir_natural.bundle"];
   
   // 设置眼线强度，范围 [0, 100]
   ZegoEffectsEyelinerParam* param = [[ZegoEffectsEyelinerParam alloc] init];
   param.intensity = 100;
   [self.effects setEyelinerParam:param];

2. 移除眼线。

   如果需要移除眼线，可将 nil 传入 setEyeliner 接口。

   // 移除眼线功能
   [self.effects setEyeliner:nil];

3.2 眼影

1. 开启眼影。

   调用 setEyeshadow 接口开启/关闭眼影功能，传入对应的眼影绝对路径。调用 setEyeshadowParam 接口设置眼影强度。

   ZegoEffectsEyeshadowParam 对象的眼影强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启眼影功能
   // 1. 开启眼影功能，并且传入对应的眼影绝对路径
   [self.effects setEyeshadow:@"/xxx/xxx/eyeshadowdir/eyeshadowdir_mist_pink.bundle"];
   
   // 设置眼影强度，范围 [0, 100]
   ZegoEffectsEyeshadowParam* param = [[ZegoEffectsEyeshadowParam alloc] init];
   param.intensity = 100;
   [self.effects setEyeshadowParam:param];

2. 移除眼影。

   如果需要移除眼影，可将 nil 传入 setEyeshadow 接口。

   // 移除眼影功能
   [self.effects setEyeshadow:nil];

3.3 眼睫毛

1. 开启眼睫毛。

   调用 setEyelashes 接口开启/关闭眼睫毛功能，传入对应的眼睫毛绝对路径。调用 setEyelashesParam 接口设置眼睫毛强度。

   ZegoEffectsEyelashesParam 对象的眼睫毛强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启眼睫毛功能
   // 1. 开启眼睫毛功能，并且传入对应的眼睫毛绝对路径
   [self.effects setEyelashes:@"/xxx/xxx/eyelashesdir/eyelashesdir_bushy.bundle"];
   
   // 设置眼睫毛强度，范围 [0, 100]
   ZegoEffectsEyelashesParam* param = [[ZegoEffectsEyelashesParam alloc] init];
   param.intensity = 100;
   [self.effects setEyelashesParam:param];

2. 移除眼睫毛。

   如果需要移除眼睫毛，可将 nil 传入 setEyelashes 接口。

   // 移除眼睫毛功能
   [self.effects setEyelashes:nil];

3.4 腮红

1. 开启腮红。

   调用 setBlusher 接口开启/关闭腮红功能，传入对应的腮红绝对路径。调用 setBlusherParam 接口设置腮红强度。

   ZegoEffectsBlusherParam 对象的腮红强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启腮红功能
   // 1. 开启腮红功能，并且传入对应的腮红绝对路径
   [self.effects setBlusher:@"/xxx/xxx/blusherdir/blusherdir_apricot_pink.bundle"];
   
   // 设置腮红强度，范围 [0, 100]
   ZegoEffectsBlusherParam* param = [[ZegoEffectsBlusherParam alloc] init];
   param.intensity = 100;
   [self.effects setBlusherParam:param];

2. 移除腮红。

   如果需要移除腮红，可将 nil 传入 setBlusher 接口。

   // 移除腮红功能
   [self.effects setBlusher:nil];

3.5 口红

1. 开启口红。

   调用 setLipStick 接口开启/关闭口红功能，传入对应的口红绝对路径。调用 setLipStickParam 接口设置口红强度。

   ZegoEffectsLipstickParam 对象的口红强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启口红功能
   // 1. 开启口红功能，并且传入对应的口红绝对路径
   [self.effects setLipStick:@"/xxx/xxx/lipstickdir/lipstickdir_bean_paste_pink.bundle"];
   
   // 设置口红强度，范围 [0, 100]
   ZegoEffectsLipstickParam* param = [[ZegoEffectsLipstickParam alloc] init];
   param.intensity = 100;
   [self.effects setLipstickParam:param];

2. 移除口红。

   如果需要移除口红，可将 nil 传入 setLipStick 接口。

   // 移除口红功能
   [self.effects setLipStick:nil];

3.6 美瞳

1. 开启美瞳。

   调用 setColoredcontacts 接口开启/关闭美瞳功能，传入对应的美瞳绝对路径。调用 setColoredcontactsParam 接口设置美瞳强度。

   ZegoEffectsColoredcontactsParam 对象的美瞳强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启美瞳功能
   // 1. 开启美瞳功能，并且传入对应的美瞳绝对路径
   [self.effects setColoredcontacts:@"/xxx/xxx/coloredcontactsdir/coloredcontactsdir_chocolate_brown.bundle"];
   
   // 设置美瞳强度，范围 [0, 100]
   ZegoEffectsColoredcontactsParam* param = [[ZegoEffectsColoredcontactsParam alloc] init];
   param.intensity = 100;
   [self.effects setColoredcontactsParam:param];

2. 移除美瞳。

   如果需要移除美瞳，可将 nil 传入 setColoredcontacts 接口。

   // 移除美瞳功能
   [self.effects setColoredcontacts:nil];

3.7 风格妆

1. 开启风格妆。

   调用 setMakeup 接口开启/关闭风格妆功能，传入对应的风格妆绝对路径。调用 setMakeupParam 接口设置风格妆强度。

   ZegoEffectsMakeupParam 对象的风格妆强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。

   // 开启风格妆功能
   // 1. 开启风格妆功能，并且传入对应的风格妆绝对路径
   [self.effects setMakeup:@"/xxx/xxx/makeupdir/makeupdir_cutie_and_cool.bundle"];
   
   // 设置风格妆强度，范围 [0, 100]
   ZegoEffectsMakeupParam* param = [[ZegoEffectsMakeupParam alloc] init];
   param.intensity = 100;
   [self.effects setMakeupParam:param];

2. 移除风格妆。

   如果需要移除风格妆，可将 nil 传入 setMakeup 接口。

   // 移除风格妆功能
   [self.effects setMakeup:nil];