美妆
功能简介
ZegoEffects SDK 提供美妆功能,包含眼线,眼影,眼睫毛,腮红,口红,美瞳,风格妆等,进行局部上妆,打造出自然精致的妆容,可广泛应用于短视频,直播等场景。
前提条件
在使用 ZegoEffects SDK 美妆功能前,请确保:
- 已在项目中集成 ZegoEffects SDK,实现基本的图像处理功能,详情请参考 快速开始 - 集成 SDK。
- 已导入美妆功能资源 “MakeupResources” 文件,详情请参考 快速开始 - 导入资源和模型。
使用步骤
美妆提供了以下功能:眼线、眼影、眼睫毛、腮红、口红、美瞳、风格妆。
各个功能包含的风格有:
- 眼线:自然(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 将采用默认参数值实现美妆功能。
眼线
-
开启眼线。
调用 setEyeliner 接口开启/关闭眼线功能,传入对应的眼线绝对路径。调用 setEyelinerParam 接口设置眼线强度。
ZegoEffectsEyelinerParam 对象的眼线强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启眼线功能 // 1. 开启眼线功能,并且传入对应的眼线绝对路径 mEffects.setEyeliner("/xxx/xxx/eyelinerdir/eyelinerdir_natural.bundle"); // 设置眼线强度,范围 [0, 100] ZegoEffectsEyelinerParam param = new ZegoEffectsEyelinerParam(); param.intensity = 100; mEffects.setEyelinerParam(param);
1 -
移除眼线。
如果需要移除眼线,可将 null 传入 setEyeliner 接口。
Untitled// 移除眼线功能 mEffects.setEyeliner(null);
1
眼影
-
开启眼影。
调用 setEyeshadow 接口开启/关闭眼影功能,传入对应的眼影绝对路径。调用 setEyeshadowParam 接口设置眼影强度。
ZegoEffectsEyeshadowParam 对象的眼影强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启眼影功能 // 1. 开启眼影功能,并且传入对应的眼影绝对路径 mEffects.setEyeshadow("/xxx/xxx/eyeshadowdir/eyeshadowdir_mist_pink.bundle"); // 设置眼影强度,范围 [0, 100] ZegoEffectsEyeshadowParam param = new ZegoEffectsEyeshadowParam(); param.intensity = 100; mEffects.setEyeshadowParam(param);
1 -
移除眼影。
如果需要移除眼影,可将 null 传入 setEyeshadow 接口。
Untitled// 移除眼影功能 mEffects.setEyeshadow(null);
1
眼睫毛
-
开启眼睫毛。
调用 setEyelashes 接口开启/关闭眼睫毛功能,传入对应的眼睫毛绝对路径。调用 setEyelashesParam 接口设置眼睫毛强度。
ZegoEffectsEyelashesParam 对象的眼睫毛强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启眼睫毛功能 // 1. 开启眼睫毛功能,并且传入对应的眼睫毛绝对路径 mEffects.setEyelashes("/xxx/xxx/eyelashesdir/eyelashesdir_bushy.bundle"); // 设置眼睫毛强度,范围 [0, 100] ZegoEffectsEyelashesParam param = new ZegoEffectsEyelashesParam(); param.intensity = 100; mEffects.setEyelashesParam(param);
1 -
移除眼睫毛。
如果需要移除眼睫毛,可将 null 传入 setEyelashes 接口。
Untitled// 移除眼睫毛功能 mEffects.setEyelashes(null);
1
腮红
-
开启腮红。
调用 setBlusher 接口开启/关闭腮红功能,传入对应的腮红绝对路径。调用 setBlusherParam 接口设置腮红强度。
ZegoEffectsBlusherParam 对象的腮红强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启腮红功能 // 1. 开启腮红功能,并且传入对应的腮红绝对路径 mEffects.setBlusher("/xxx/xxx/blusherdir/blusherdir_apricot_pink.bundle"); // 设置腮红强度,范围 [0, 100] ZegoEffectsBlusherParam param = new ZegoEffectsBlusherParam(); param.intensity = 100; mEffects.setBlusherParam(param);
1 -
移除腮红。
如果需要移除腮红,可将 null 传入 setBlusher 接口。
Untitled// 移除腮红功能 mEffects.setBlusher(null);
1
口红
-
开启口红。
调用 setLipStick 接口开启/关闭口红功能,传入对应的口红绝对路径。调用 setLipStickParam 接口设置口红强度。
ZegoEffectsLipstickParam 对象的口红强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启口红功能 // 1. 开启口红功能,并且传入对应的口红绝对路径 mEffects.setLipStick("/xxx/xxx/lipstickdir/lipstickdir_bean_paste_pink.bundle"); // 设置口红强度,范围 [0, 100] ZegoEffectsLipstickParam param = new ZegoEffectsLipstickParam(); param.intensity = 100; mEffects.setLipstickParam(param);
1 -
移除口红。
如果需要移除口红,可将 null 传入 setLipStick 接口。
Untitled// 移除口红功能 mEffects.setLipStick(null);
1
美瞳
-
开启美瞳。
调用 setColoredcontacts 接口开启/关闭美瞳功能,传入对应的美瞳绝对路径。调用 setColoredcontactsParam 接口设置美瞳强度。
ZegoEffectsColoredcontactsParam 对象的美瞳强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启美瞳功能 // 1. 开启美瞳功能,并且传入对应的美瞳绝对路径 mEffects.setColoredcontacts("/xxx/xxx/coloredcontactsdir/coloredcontactsdir_chocolate_brown.bundle"); // 设置美瞳强度,范围 [0, 100] ZegoEffectsColoredcontactsParam param = new ZegoEffectsColoredcontactsParam(); param.intensity = 100; mEffects.setColoredcontactsParam(param);
1 -
移除美瞳。
如果需要移除美瞳,可将 null 传入 setColoredcontacts 接口。
Untitled// 移除美瞳功能 mEffects.setColoredcontacts(null);
1
风格妆
对于 2.0.0 之前的版本,风格妆效果不能与挂件功能叠加使用,开启风格妆功能,会关闭挂件效果。
-
开启风格妆。
调用 setMakeup 接口开启/关闭风格妆功能,传入对应的风格妆绝对路径。调用 setMakeupParam 接口设置风格妆强度。
ZegoEffectsMakeupParam 对象的风格妆强度参数 “intensity” 的取值范围为 [0, 100]。取值越大,效果呈现的程度越大,开发者可以根据需求自定义取值。
Untitled// 开启风格妆功能 // 1. 开启风格妆功能,并且传入对应的风格妆绝对路径 mEffects.setMakeup("/xxx/xxx/makeupdir/makeupdir_cutie_and_cool.bundle"); // 设置风格妆强度,范围 [0, 100] ZegoEffectsMakeupParam param = new ZegoEffectsMakeupParam(); param.intensity = 100; mEffects.setMakeupParam(param);
1 -
移除风格妆。
如果需要移除风格妆,可将 null 传入 setMakeup 接口。
Untitled// 移除风格妆功能 mEffects.setMakeup(null);
1