Android & iOS

当您使用setEffect函数更新美颜效果时,可参考如下参数表。参数表中的effectName常量定义在 Android 中位于XmagicConstant.java文件,iOS位于XmagicConstant.h文件。
注意:如果您使用的 SDK 版本是V3.3.0及之前版本,请参见 Android 旧版美颜参数表iOS 旧版美颜参数表

美颜、美体

类型

名称

effectName

effectValue

resourcePath

常量名

常量值

效果强度

资源路径

美颜
美白
BEAUTY_WHITEN
beauty.lutFoundationAlpha
0 ~ 100
美白2
BEAUTY_WHITEN2
beauty.lutFoundationAlpha2
0 ~ 100
美白3
BEAUTY_WHITEN3
beauty.lutFoundationAlpha3
0 ~ 100
美黑
(V3.7.0)
BEAUTY_BLACK_1
beauty.lutBlackAlpha1
0 ~ 100
小麦色
(V3.7.0)
BEAUTY_BLACK_2
beauty.lutBlackAlpha2
0 ~ 100
磨皮
BEAUTY_SMOOTH
smooth.smooth
0 ~ 100
红润
BEAUTY_ROSY
smooth.rosy
0 ~ 100
画面调整
对比度
BEAUTY_CONTRAST
beauty.imageContrastAlpha
-100 ~ 100
饱和度
BEAUTY_SATURATION
smooth.saturation
-100 ~ 100
清晰度
BEAUTY_CLEAR
beauty.lutClearAlpha
0 ~ 100
锐化
BEAUTY_SHAPE
smooth.sharpen
0 ~ 100
亮度
(V3.8.0)
BEAUTY_IMAGE_BRIGHTNESS
beauty.imageBrightness
-100 ~ 100
弱光降噪
(V3.6.0)
BEAUTY_IMAGE_DENOISE
postEffect.denoise
0 ~ 100
色温
BEAUTY_IMAGE_WARMTH
beauty.imageWarmth
-100 ~ 100
色调
BEAUTY_IMAGE_TINT
beauty.imageTint
-100 ~ 100
高级美型
大眼
BEAUTY_ENLARGE_EYE
basicV7.enlargeEye
0 ~ 100
亮眼
BEAUTY_EYE_LIGHTEN
beauty.eyeLighten
0 ~ 100
眼距
BEAUTY_EYE_DISTANCE
basicV7.eyeDistance
-100 ~ 100
眼角
BEAUTY_EYE_ANGLE
basicV7.eyeAngle
-100 ~ 100
眼宽
BEAUTY_EYE_WIDTH
basicV7.eyeWidth
-100 ~ 100
眼高
BEAUTY_EYE_HEIGHT
basicV7.eyeHeight
-100 ~ 100
眼睛位置
(V3.8.0)
BEAUTY_EYE_POSITION
basicV7.eyePosition
-100 ~ 100
祛眼袋
BEAUTY_FACE_REMOVE_EYE_BAGS
beauty.removeEyeBags
0 ~ 100
眉毛角度
BEAUTY_EYEBROW_ANGLE
basicV7.eyebrowAngle
-100 ~ 100
眉毛距离
BEAUTY_EYEBROW_DISTANCE
basicV7.eyebrowDistance
-100 ~ 100
眉毛高度
BEAUTY_EYEBROW_HEIGHT
basicV7.eyebrowHeight
-100 ~ 100
眉毛长度
BEAUTY_EYEBROW_LENGTH
basicV7.eyebrowLength
-100 ~ 100
眉毛粗细
BEAUTY_EYEBROW_THICKNESS
basicV7.eyebrowThickness
-100 ~ 100
眉峰
BEAUTY_EYEBROW_RIDGE
basicV7.eyebrowRidge
-100 ~ 100
瘦鼻
BEAUTY_NOSE_THIN
basicV7.thinNose
0 ~ 100
鼻翼
BEAUTY_NOSE_WING
basicV7.noseWing
-100 ~ 100
鼻子位置
BEAUTY_NOSE_HEIGHT
basicV7.noseHeight
-100 ~ 100
鼻梁
BEAUTY_NOSE_BRIDGE_WIDTH
basicV7.noseBridgeWidth
-100 ~ 100
山根
BEAUTY_NASION
basicV7.nasion
-100 ~ 100
白牙
BEAUTY_TOOTH_WHITEN
beauty.toothWhiten
0 ~ 100
嘴型
BEAUTY_MOUTH_SIZE
basicV7.mouthSize
-100 ~ 100
嘴唇厚度
BEAUTY_MOUTH_HEIGHT
basicV7.mouthHeight
-100 ~ 100
嘴唇宽度
BEAUTY_MOUTH_WIDTH
basicV7.mouthWidth
-100 ~ 100
嘴唇位置
BEAUTY_MOUTH_POSITION
basicV7.mouthPosition
-100 ~ 100
微笑唇
BEAUTY_SMILE_FACE
basicV7.smileFace
-100 ~ 100
窄脸
BEAUTY_FACE_THIN
basicV7.thinFace
0 ~ 100
瘦脸-自然
BEAUTY_FACE_NATURE
basicV7.natureFace
0 ~ 100
瘦脸-女神
BEAUTY_FACE_GODNESS
basicV7.godnessFace
0 ~ 100
瘦脸-英俊
BEAUTY_FACE_MALE_GOD
basicV7.maleGodFace
0 ~ 100
V脸
BEAUTY_FACE_V
basicV7.vFace
0 ~ 100
收下颌
BEAUTY_FACE_JAW
basicV7.faceJaw
0 ~ 100
短脸
BEAUTY_FACE_SHORT
basicV7.shortFace
0 ~ 100
脸型
BEAUTY_FACE_BASIC
liquefaction.basic3
0 ~ 100
下巴
BEAUTY_FACE_THIN_CHIN
basicV7.chin
-100 ~ 100
额头
BEAUTY_FACE_FOREHEAD
basicV7.forehead
-100 ~ 100
祛皱
BEAUTY_FACE_REMOVE_WRINKLE
beauty.removeWrinkle
0 ~ 100
祛法令纹
BEAUTY_FACE_REMOVE_LAW_LINE
beauty.removeLawLine
0 ~ 100
瘦颧骨
BEAUTY_FACE_THIN_CHEEKBONE
basicV7.cheekboneThin
0 ~ 100
单点美妆
口红
BEAUTY_MOUTH_LIPSTICK
beauty.faceFeatureLipsLut
0 ~ 100
口红图片在手机上的绝对路径 或者 相对于美颜模型文件目录的相对路径 示例: /images/beauty/lips_fuguhong.png
腮红
BEAUTY_FACE_RED_CHEEK
beauty.faceFeatureRedCheek
0 ~ 100
示例: /images/beauty/saihong_jianyue.png
立体
BEAUTY_FACE_SOFTLIGHT
beauty.faceFeatureSoftlight
0 ~ 100
示例: /images/beauty/liti_ziran.png
染发
(V3.7.0)
BEAUTY_HAIR_COLOR_LUT
beauty.hairColorLut
0 ~ 100
示例: /images/hair_color/red.png
眼影
BEAUTY_FACE_EYE_SHADOW
beauty.faceFeatureEyesMakeup.eyeShadow
0 ~ 100
示例: /images/beauty/eyes_makeup_eye_shadow_0-albatross.png
眼线
BEAUTY_FACE_EYE_LINER
beauty.faceFeatureEyesMakeup.eyeLiner
0 ~ 100
示例: /images/beauty/eyes_makeup_eye_liner_0.png
睫毛
BEAUTY_FACE_EYELASH
beauty.faceFeatureEyesMakeup.eyelash
0 ~ 100
示例: /images/beauty/eyes_makeup_eyelash_0.png
眉毛
BEAUTY_FACE_EYEBROW
beauty.faceFeatureEyesMakeup.eyebrow
0 ~ 100
示例: /images/beauty/eyes_makeup_eyebrow_0.png
美瞳
BEAUTY_FACE_EYEBALL
beauty.faceFeatureEyesMakeup.eyeball
0 ~ 100
示例: /images/beauty/eyes_makeup_eyeball_0.png
双眼皮
(V3.8.0)
BEAUTY_FACE_MAKEUP_EYELIDS
beauty.faceFeatureEyesMakeup.eyelids
0 ~ 100
示例: /images/beauty/eyes_makeup_eyelids_kaishan.png
卧蚕
(V3.8.0)
BEAUTY_FACE_MAKEUP_EYEWOCAN
beauty.faceFeatureEyesMakeup.eyewocan
0 ~ 100
示例: /images/beauty/eyes_makeup_eye_wocan_keai.png
美体
一键瘦身
BODY_AUTOTHIN_BODY_STRENGTH
body.autothinBodyStrength
0 ~ 100
长腿
BODY_LEG_STRETCH
body.legStretch
0 ~ 100
瘦腿
BODY_SLIM_LEG_STRENGTH
body.slimLegStrength
0 ~ 100
瘦腰
BODY_WAIST_STRENGTH
body.waistStrength
0 ~ 100
瘦肩
BODY_THIN_SHOULDER_STRENGTH
body.thinShoulderStrength
0 ~ 100
胸部调整
BODY_ENLARGE_CHEST_STRENGTH
body.enlargeChestStrength
-100 ~ 100
小头
BODY_SLIM_HEAD_STRENGTH
body.slimHeadStrength
0 ~ 100

滤镜、美妆、动效、分割

类型

effectName
effectValue
resourcePath
extraInfo
常量名
常量值
效果强度
资源路径
附加参数(键值对类型)
滤镜
EFFECT_LUT
lut
0 ~ 100
滤镜图片在手机上的绝对路径,示例: /data/user/0/xxxxxx/files/xmagic/light_material/lut/aiqing_lf.png 如果要取消滤镜,这里填null
美妆
EFFECT_MAKEUP
makeup
0 ~ 100
美妆素材在手机上的绝对路径。 如果要取消美妆,这里填null
[可选] makeupLutStrength:美妆素材中的滤镜强度,取值"0"到"100"
[可选] mergeWithCurrentMotion:"true"或"false",表示是否叠加在当前动效上。如果不填写此字段,则认为是 false
动效
EFFECT_MOTION
motion
动效素材在手机上的绝对路径,示例: /data/user/0/xxxxxx/files/xmagic/light_material/motion/video_keaituya 如果要取消动效,这里填null
[可选]mergeWithCurrentMotion:"true"或"false",表示是否叠加在当前动效上。如果不填写此字段,则认为是 false
背景分割
(普通)
EFFECT_SEGMENTATION
segmentation
背景分割素材在手机上的绝对路径 如果要取消分割,这里填null
[可选]mergeWithCurrentMotion:"true"或"false",表示是否叠加在当前动效上。如果不填写此字段,则认为是 false
背景分割
(绿幕)
EFFECT_SEGMENTATION
segmentation
背景分割素材在手机上的绝对路径 如果要取消分割,这里填null
[必要]segType:"green_background"
[必要]bgType:自定义背景类型,"0"表示图片或pag,"1"表示视频
[可选]bgPath:自定义背景图片或视频路径
[可选]keyColor:绿幕颜色RGB,格式如"#0x00ff00"
[可选]mergeWithCurrentMotion:"true"或"false",表示是否叠加在当前动效上。如果不填写此字段,则认为是 false
注:bgPathkeyColor 必须设置一项。
背景分割
(自定义)
EFFECT_SEGMENTATION
segmentation
背景分割素材在手机上的绝对路径 如果要取消分割,这里填null
[必要]segType:"custom_background"
[必要]bgType:自定义背景类型,"0"表示图片或者pag,"1"表示视频
[必要]bgPath:自定义背景图片或视频路径
[可选]mergeWithCurrentMotion:"true"或"false",表示是否叠加在当前动效上。如果不填写此字段,则认为是 false