云服务器特惠 99/年起
  1. 腾讯云优惠网首页
  2. 腾讯云产品

腾讯特效 SDK Android & iOS

• 腾讯云产品

当你使用 setEffect 函数更新美颜效果时，可参考如下参数表。参数表中的 effectName 常量定义在 Android 中位于 XmagicConstant.java 文件，iOS 位于 XmagicConstant.h 文件。

相关产品
腾讯特效 SDK 产品页，含版本规格、价格与购买入口。

注意：如果你使用的 SDK 版本是V3.3.0及之前版本，请参见 Android 旧版美颜参数表，iOS 旧版美颜参数表。

一、美颜、美体

  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 无
 磨皮-柔焦 (V4.3.0) BEAUTY_SMOOTH5 smooth.smooth5 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_SHARPEN 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 无
 祛颈纹(V4.3.0) BEAUTY_REMOVE_NECK_WRINKLE beauty.removeNeckWrinkle 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 无
 瘦胳膊 BODY_SLIM_ARM_STRENGTH body.slimArmStrength -100 ~ 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。

相关内容：

  1. 腾讯特效 SDK 素材叠加指引 这篇说说腾讯云动效素材叠加功能，即多个动效可同时生效，并说明配置方法及注意事项，强调需自行管理素材兼容性，避免冲突叠加。 叠加规则：简单素材可叠加，动作触发等复杂素材需放在前面，简单素材后叠加。 配置方法：V3.5.0及以上通过setEffect或updateProperty设置mergeWithCurrentMotion为true。...
  2. 腾讯特效 SDK Android 这篇档详细记录了腾讯云美颜特效 SDK 的版本更新日志，涵盖从 Version 2.4.2 到 Version 4.1.0.13 的多项功能新增、优化与问题修复。主要内容包括美颜、美妆、美体、分割、素材、性能优化等能力的迭代升级，以及接口变更、兼容性调整和已知问题修复。Version 4.1.0.13：新增蓝幕分割能力，优化美体识别准确性，升级 libpag 库至 4.4.35-noffavc。Version 4.0。...
  3. 腾讯特效 SDK Android（素材集成指引） 每个滤镜都是一张 png 格式的图片，使用时，需要将图片路径传给 SDK。具体做法如下。...
  4. 腾讯特效 SDK Android（快速跑通 Demo） 腾讯礼物动画特效提供了适用于不同开发平台的 Demo。这篇将主要介绍如何快速跑通礼物动画特效 SDK 的 Android 端 Demo。...
  5. 腾讯特效 SDK Skills 腾讯特效 SDK Skills 是面向腾讯特效 SDK 集成场景的结构化指引资源包，覆盖美颜、滤镜、动效贴纸、人像分割、3D 特效等核心能力。它将 SDK 领域知识直接注入 AI 编程助手的上下面，将自然语言需求转化为可执行的标准化步骤，帮助开发者高效完成 Android、iOS、Flutter 三平台的 SDK 集成。...
  6. 腾讯特效 SDK Avatar 虚拟人集成指引 TEBeautyKit 是美颜特效美颜模块的 UI 面板库，用于客户快速方便的使用和管理美颜功能，效果如下图，可参考 Demo 工程。...
  7. 腾讯特效 SDK 使用美颜特效处理图片 本教程指导如何使用美颜特效 SDK 在浏览器中对图片进行美化、应用特效、下载处理完的图片等操作。...
  8. 边缘安全加速平台 EO EdgeOne 实现 Android APK 的动态打包 通过 EdgeOne 边缘函数，我们可以动态地将渠道信息写入到 APK 包内。用户只需访问与边缘函数绑定的域名并进行触发配置，就可以触发该边缘函数，从而实现 APK 的动态打包和加速分发。...
赞 (0)
上一篇 4天前
下一篇 4天前