TUICallKit 提供了美颜特效方案:采用腾讯特效 SDK,提供了更加丰富和专业的美颜效果,例如 V 脸、眼距、瘦鼻、3D 贴纸等。
效果图:
高级美颜面板

高级美颜效果展示
V 脸 | 眼距 | 瘦鼻 | 3D 贴纸 |
![]() | ![]() | ![]() | ![]() |
前提条件
组件接入
注意:
步骤 1:集成 te_beauty_kit 适配模块
1. 下载并解压 TUIKit_Android,把 TUIkit_Android/tebeautykit 文件夹拷贝到自己的工程中,和 app 同级目录。

2. 编辑您自己工程的
settings.gradle 文件,添加下面的代码:include ':tebeautykit'
步骤2: 鉴权和设置美颜资源
1. 申请授权,得到
LicenseUrl 和 LicenseKey,请参见 License 指引。2. 在您的业务初始化的地方(默认可在登录的相同位置),添加如下鉴权代码,并替换您申请的
美颜套餐编号、LicenseUrl 和 LicenseKey:TUIBeautyKit.instance.init(context,"LicenseUrl", // 请替换 LicenseUrl"LicenseKey", // 请替换 LicenseKeyBeautyLevel.S1_07 // // 将S1_07替换为您购买的美颜套餐编号)
更换美颜套餐或者自定义美颜面板
您如果需要根据购买的美颜套餐编号更换套餐或者自定义美颜面板,可以按下面的步骤完成。
1. 首先您需要在 步骤2:鉴权和设置美颜资源 传入参数为您购买的美颜套餐编号。目前支持的美颜套餐编号如下:
enum class BeautyLevel {A1_00, A1_01, A1_02, A1_03, A1_04, A1_05, A1_06,S1_00, S1_01, S1_02, S1_03, S1_04, S1_07}
其中
美颜套餐编号与 panel JSON 对照表
:套餐 ( BeautyLevel) | 需要导入的 panel JSON(全集) |
A1_00 | beauty_template, beauty, lut |
A1_01 | beauty_template, beauty, beauty_image, beauty_base_shape, lut |
A1_02 | beauty_template, beauty, beauty_image, beauty_base_shape, lut, motion_2d |
A1_03 | beauty_template, beauty, beauty_image, beauty_general_shape, lut, motion_2d |
A1_04 | beauty_template, beauty, beauty_image, beauty_general_shape, lut |
A1_05 | beauty_template, beauty, beauty_image, beauty_general_shape, lut, motion_2d, segmentation |
A1_06 | beauty_template, beauty, beauty_image, beauty_general_shape, lut, motion_2d, makeup |
S1_00 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut |
S1_01 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, motion_2d, motion_3d, makeup, light_makeup |
S1_02 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, motion_2d, motion_3d, motion_gesture, makeup, light_makeup |
S1_03 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, motion_2d, motion_3d, makeup, light_makeup, segmentation |
S1_04 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, motion_2d, motion_3d, motion_gesture, makeup, light_makeup, segmentation |
S1_05 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, beauty_body, motion_2d, motion_3d, makeup, light_makeup, segmentation |
S1_06 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, beauty_body, motion_2d, motion_3d, motion_gesture, makeup, light_makeup, segmentation |
S1_07 | beauty_template, beauty, beauty_image, beauty_shape, beauty_makeup, lut, beauty_body, motion_2d, motion_3d, motion_gesture, makeup, light_makeup, segmentation |
2. 自定义高级美颜 UI 面板。
2.1 高级美颜 UI 面板都是通过 json 配置展示的,目前 默认配置资源就在 tebeautykit 模块的 assets 目录下。其中配置资源包含两种。
面板配置素材:面板配置 JSON,相关图片等,用于展示美颜特效功能项。
资源 | 用途 |
assets/beauty_panel/*.json | 面板 UI 配置(分组、按钮、滑杆)。 |
assets/beauty_panel/panel_icon/ | 面板按钮图标 PNG。 |
美颜特效素材:滤镜 LUT、2D/3D 动效贴纸等具体特效的素材。
资源 | 用途 | 对应面板能力 |
lut/ | 滤镜调色查找表。 | 滤镜 Tab |
MotionRes/2dMotionRes/ | 2D 动态贴纸 / 大头特效。 | 贴纸 Tab |
MotionRes/3dMotionRes/ | 3D 模型贴纸。 | 贴纸 Tab |
MotionRes/handMotionRes/ | 手势触发贴纸。 | 手势 Tab |
MotionRes/makeupRes/ | 整妆套装(口红 + 眼影 + 腮红 等)。 | 美妆 Tab |
MotionRes/light_makeup/ | 轻美妆素材。 | 轻美妆 Tab |
MotionRes/segmentMotionRes/ | 人像分割(绿幕 / 抠图 / 背景虚化)。 | 分割 Tab |
2.2 您可以通过配置下面面板配置素材中的 json 文件而动态控制美颜面板的 UI 。

常见问题
License 鉴权失败怎么办?
请检查
LicenseUrl / LicenseKey 是否与套餐绑定、所选 BeautyLevel 是否与 License 匹配,并确认应用的 BundleIdentifier 与 License 申请时绑定的 applicationId 一致。如何动态切换套餐?
重新调用
TUIBeautyKit.instance.init( this, LICENSE_URL, LICENSE_KEY) 即可。如果 License 不生效,偶现退出页面的时候会内存泄露。
你需要在使用美颜页面结束时,调用下面方法销毁美颜资源:
TUICore.callService("TEBeautyExtension", "destroyBeautyKit", null)。


