文档中心
AI 美颜
基础功能
美妆

美妆

更新时间：2024-01-12 15:33

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 眼线

开启眼线。

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

zego_effects_set_eyeliner_param 对象的眼线强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启眼线功能
// 1. 开启眼线功能，并且传入对应的眼线绝对路径
zego_effects_set_eyeliner(handle,"/xxx/xxx/eyelinerdir/eyelinerdir_natural.bundle");

// 设置眼线强度，范围 [0, 100]
zego_effects_eyeliner_param param;
param.intensity = 100;
zego_effects_set_eyeliner_param(handle,param);
```
移除眼线。

如果需要移除眼线，可将资源路径设置为空，传入 zego_effects_set_eyeliner 接口。
```
// 移除眼线功能
zego_effects_set_eyeliner(handle,"");
```

3.2 眼影

开启眼影。

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

zego_effects_set_eyeshadow_param 对象的眼影强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启眼影功能
// 1. 开启眼影功能，并且传入对应的眼影绝对路径
zego_effects_set_eyeshadow(handle,"/xxx/xxx/eyeshadowdir/eyeshadowdir_mist_pink.bundle");

// 设置眼影强度，范围 [0, 100]
zego_effects_eyeshadow_param param;
param.intensity = 100;
zego_effects_set_eyeshadow_param(handle,param);
```
移除眼影。

如果需要移除眼影，可将资源路径设置为空，传入 zego_effects_set_eyeshadow 接口。
```
// 移除眼影功能
zego_effects_set_eyeshadow(handle,"");  
```

3.3 眼睫毛

开启眼睫毛。

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

zego_effects_set_eyelashes_param 对象的眼睫毛强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启眼睫毛功能
// 1. 开启眼睫毛功能，并且传入对应的眼睫毛绝对路径
zego_effects_set_eyelashes(handle,"/xxx/xxx/eyelashesdir/eyelashesdir_bushy.bundle");

// 设置眼睫毛强度，范围 [0, 100]
zego_effects_eyelashes_param  param;
param.intensity = 100;
zego_effects_set_eyelashes_param(handle,param);
```
移除眼睫毛。

如果需要移除眼睫毛，可将资源路径设置为空，传入 zego_effects_set_eyelashes 接口。
```
// 移除眼睫毛功能        
zego_effects_set_eyelashes(handle,"");  
```

3.4 腮红

开启腮红。

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

zego_effects_set_blusher_param 对象的腮红强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启腮红功能
// 1. 开启腮红功能，并且传入对应的腮红绝对路径
zego_effects_set_blusher(handle,"/xxx/xxx/eyelashesdir/eyelashesdir_bushy.bundle");

// 设置腮红强度，范围 [0, 100]
zego_effects_blusher_param param;
param.intensity = 100;
zego_effects_set_blusher_param(param);
```
移除腮红。

如果需要移除腮红，可将资源路径设置为空，传入 zego_effects_set_blusher 接口。
```
// 移除腮红功能
zego_effects_set_blusher(handle,""); 
```

3.5 口红

开启口红。

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

zego_effects_lipstick_param 对象的口红强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启口红功能
// 1. 开启口红功能，并且传入对应的口红绝对路径
zego_effects_set_lipstick(handle,"/xxx/xxx/lipstickdir/lipstickdir_bean_paste_pink.bundle");

// 设置口红强度，范围 [0, 100]
zego_effects_lipstick_param param;
param.intensity = 100;
zego_effects_set_lipstick_param(param);
```
移除口红。

如果需要移除口红，可将资源路径设置为空，传入 zego_effects_set_lipstick 接口。
```
// 移除口红功能
zego_effects_set_lipstick(handle,"");  
```

3.6 美瞳

开启美瞳。

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

zego_effects_coloredcontacts_param 对象的美瞳强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启美瞳功能
// 1. 开启美瞳功能，并且传入对应的美瞳绝对路径
zego_effects_set_coloredcontacts(handle,"/xxx/xxx/lipstickdir/lipstickdir_bean_paste_pink.bundle");    

// 设置美瞳强度，范围 [0, 100]
zego_effects_coloredcontacts_param param;
param.intensity = 100;
zego_effects_set_coloredcontacts_param(param);
```
移除美瞳。

如果需要移除美瞳，可将资源路径设置为空，传入 zego_effects_set_coloredcontacts 接口。
```
// 移除美瞳功能
zego_effects_set_coloredcontacts(handle,"");        
```

3.7 风格妆

风格妆效果不能与挂件功能叠加使用，开启风格妆功能，会关闭挂件效果。

开启风格妆。

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

zego_effects_makeup_param 对象的风格妆强度参数 “intensity” 的取值范围为 [0, 100]。取值越大，效果呈现的程度越大，开发者可以根据需求自定义取值。
```
// 开启风格妆功能
// 1. 开启风格妆功能，并且传入对应的风格妆绝对路径
zego_effects_set_makeup(handle,"/xxx/xxx/makeupdir/makeupdir_cutie_and_cool.bundle");  

// 设置风格妆强度，范围 [0, 100]
zego_effects_makeup_param param;
param.intensity = 100;
zego_effects_set_makeup_param(param);    
```
移除风格妆。

如果需要移除风格妆，可将资源路径设置为空，传入 zego_effects_set_makeup 接口。
```
// 移除风格妆功能    
zego_effects_set_makeup(handle,"");    
```