产品动态
关于腾讯特效 SDK V3.5 版本更新公告
关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告
setEffect函数更新美颜效果时，可参考如下参数表。参数表中的effectName常量定义在 Android 中位于XmagicConstant.java文件，iOS位于XmagicConstant.h文件。类型 | 名称 | effectName | | effectValue | resourcePath |
| | 常量名 | 常量值 | 效果强度 | 资源路径 |
美颜 | 美白-靓白(V3.9.0) | BEAUTY_WHITEN0 | beauty.lutFoundationAlpha0 | 0 ~ 100 | V3.9.0以前：无 V3.9.0及之后：【可选】自定义美白滤镜路径 |
| 美白-自然 | BEAUTY_WHITEN | beauty.lutFoundationAlpha | 0 ~ 100 | V3.9.0以前：无 V3.9.0及之后：【可选】自定义美白滤镜路径 |
| 美白-粉白 | BEAUTY_WHITEN2 | beauty.lutFoundationAlpha2 | 0 ~ 100 | V3.9.0以前：无 V3.9.0及之后：【可选】自定义美白滤镜路径 |
| 美白-冷白 | BEAUTY_WHITEN3 | beauty.lutFoundationAlpha3 | 0 ~ 100 | V3.9.0以前：无 V3.9.0及之后：【可选】自定义美白滤镜路径 |
| 美黑 (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 | 无 |
| 磨皮-质感 (V3.9.3) | BEAUTY_SMOOTH2 | smooth.smooth2 | 0 ~ 100 | 无 |
| 磨皮-真实 (V3.9.3) | BEAUTY_SMOOTH3 | smooth.smooth3 | 0 ~ 100 | 无 |
| 磨皮-经典 (V3.9.3) | BEAUTY_SMOOTH4 | smooth.smooth4 | 0 ~ 100 | 无 |
| Gan 美肌 (AI美肌) (V3.9.3) | BEAUTY_FACE_SKIN_RETOUCH | beauty.skinRetouch | 0 ~ 100 | 无 |
| 皮肤高光 (V4.0.0) | BEAUTY_SKIN_HIGHLIGHT | beauty.skinHighlight | 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 | 无 |
| 外眼角 (V3.9.0) | BEAUTY_EYE_OUT_CORNER | basicV7.eyeOutCorner | -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 | 无 |
| 额头2 (V3.9.1) | BEAUTY_FACE_FOREHEAD2 | basicV7.forehead2 | -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 | 无 |
轻美妆（V3.9.0） | EFFECT_LIGHT_MAKEUP | light.makeup | 0~100 | 轻美妆素材在手机上的绝对路径。 如果要取消轻美妆，这里填null | [可选] makeupLutStrength：轻美妆素材中的滤镜强度，取值"0"到"100" |
美妆 |
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 |
背景分割 (绿幕1) |
EFFECT_SEGMENTATION
| segmentation | 无 | 背景分割绿幕素材1在手机上的绝对路径 如果要取消分割，这里填null | [必要] segType："green_background"[必要] bgType：自定义背景类型，"0"表示图片（支持的图片类型png、jpg、jpeg）或pag，"1"表示视频[必要] bgPath：自定义背景图片或视频路径[可选] keyColor：绿幕颜色RGB，格式如"#00ff00"[可选] tex_protect_rect：绿幕保护区域，也就是不被替换的区域。例如:"[0.0,0.0,0.3,0.3]"，画面左下角是（0,0）坐标，右上角是(1,1)坐标。[可选] mergeWithCurrentMotion："true"或"false"，表示是否叠加在当前动效上。如果不填写此字段，则认为是 false |
背景分割 (绿幕V2) （V3.9.2） | EFFECT_SEGMENTATION | segmentation | 无 | 背景分割绿幕素材2在手机上的绝对路径 如果要取消分割，这里填null | [必要] segType："green_background_v2"[必要] bgType：自定义背景类型，"0"表示图片（支持的图片类型png、jpg、jpeg）或 pag，"1"表示视频。[必要] bgPath：自定义背景图片或视频路径。[可选] mergeWithCurrentMotion："true"或"false"，表示是否叠加在当前动效上。如果不填写此字段，则认为是 false。[可选] green_params_v2：绿幕效果微调参数，例如"[30,20,1,30,1]", 参数详细说明[可选] tex_protect_rect：绿幕保护区域，也就是不被替换的区域。例如:"[0.0,0.0,0.3,0.3]"，画面左下角是（0,0）坐标，右上角是(1,1)坐标。 |
背景分割 (蓝幕) （V4.1.0） | EFFECT_SEGMENTATION | segmentation | 无 | 背景分割蓝幕素材在手机上的绝对路径。 如果要取消分割，这里填 null。 | [必要] segType："green_background_v2"[必要] bgType：自定义背景类型，"0"表示图片（支持的图片类型为 png、jpg、jpeg）或 pag，"1"表示视频。[必要] bgPath：自定义背景图片或视频路径。[可选] mergeWithCurrentMotion："true"或"false"，表示是否叠加在当前动效上。如果不填写此字段，则认为是 false。[可选] green_params_v2：绿幕效果微调参数，例如 "[35,8,1,10,1]", 参数详细说明[可选] tex_protect_rect：绿幕保护区域，也就是不被替换的区域。例如:"[0.0,0.0,0.3,0.3]"，画面左下角是（0,0）坐标，右上角是(1,1)坐标。 |
背景分割 (自定义) |
EFFECT_SEGMENTATION
| segmentation | 无 | 背景分割素材在手机上的绝对路径
如果要取消分割，这里填null | [必要] segType："custom_background"[必要] bgType：自定义背景类型，"0"表示图片（支持的图片类型png、jpg、jpeg）或者pag，"1"表示视频[必要] bgPath：自定义背景图片或视频路径[可选] mergeWithCurrentMotion："true"或"false"，表示是否叠加在当前动效上。如果不填写此字段，则认为是 false |
文档反馈