文档中心
AI_Vision AI 美颜
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 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 眼线

  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];
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈