tencent cloud

腾讯特效 SDK

动态与公告
产品动态
关于腾讯特效 SDK V3.5 版本更新公告
关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告
产品简介
产品概述
产品功能
基本概念
产品优势
应用场景
购买指南
价格总览
购买流程
欠费退费说明
新手指引
Demo 体验
免费测试
License 指引
移动端 License 新增与续期
PC 端 License 新增与续期
Web端 License 新增与续期
常见问题
SDK 下载
功能说明
SDK 下载
版本历史
SDK 集成指引(无 UI)
通用集成腾讯特效
原子能力集成指引
SDK 集成指引(含 UI)
通用集成腾讯特效
直播 SDK 集成腾讯特效
TRTC SDK 集成腾讯特效
短视频 SDK 集成腾讯特效
Avatar 虚拟人集成指引
API 文档
iOS
Android
Flutter
Web
功能实践
SDK 包瘦身
SDK 集成问题排查
性能调优
效果调优
素材使用
美颜参数说明
美颜场景推荐参数
短视频企业版迁移指引
第三方推流接入美颜(Flutter)
小程序美颜特效实践
素材制作工具使用
Web 美颜特效
产品概述
快速上手
SDK 接入
API 文档
控制台指南
Demo 体验
内置素材总览
实践教程
常见问题
常见问题
通用类相关
技术类相关
License 相关
旧版文档
美颜场景推荐参数
美颜参数表
一分钟集成 TRTC
一分钟集成直播
TE SDK 政策
隐私协议
数据处理和安全协议
联系我们

轻美妆使用说明

PDF
聚焦模式
字号
最后更新时间: 2025-02-20 16:32:14

什么是轻美妆

轻美妆是腾讯特效 SDK 在V3.9.0版本推出的新功能。一套轻美妆里最多可包含这些美妆项目:滤镜、口红、腮红、立体、眼影、眼线、睫毛、眉毛、美瞳、双眼皮、卧蚕。轻美妆本质上跟SDK已有的“单点美妆”是同一个能力,可以理解为把多个单点美妆搭配组合在了一起。
与之前的“整妆特效”相比,轻美妆性能更好,且能跟其他特效很好地叠加
一套轻美妆素材包含若干张美妆图片和一个 json 配置文件,例如“light_baixi”这套轻美妆的配置如下:




如何使用轻美妆

请调用 SDK 的 setEffect接口使用轻美妆:
effectName 为EFFECT_LIGHT_MAKEUP。
effectValue 为妆容强度,取值0 ~ 100。
resourcePath 为轻美妆素材路径,即: path/to/your_light_makeup。
extraInfo 是可选的,如果您想只修改轻美妆里的滤镜强度而不修改妆容强度,则在 extraInfo 里添加一对 key-value,key 为"makeupLutStrength",value 为滤镜强度,取值为0 ~ 100,注意 value 也是字符串格式的。

注意事项

1、轻美妆与单点美妆的关系

轻美妆本质上是单点美妆的集合,因此后设置的会覆盖先设置的,具体如下:
场景1:如果先设置了若干单点美妆,再设置了一套轻美妆,则轻美妆效果会覆盖单点美妆的效果。
场景2:如果先设置了一套轻美妆(假设里面配置了口红、眼影、眉毛等),再设置单点美妆(例如口红),则最终效果是:新设置的这个口红 + 轻美妆里的眼影 + 轻美妆里的眉毛。
对于场景2,我们 Demo 中的处理方式是:设置单点美妆时,清空轻美妆。您可以根据您的产品实际情况选择是否清空轻美妆。

2、轻美妆与其他特效的叠加关系

轻美妆可以和其他任意特效叠加,包括:美颜、美型、美体、贴纸、虚拟背景、运镜特效等。

3、轻美妆与贴纸特效里的“风格整妆”的关系

在V3.9.0之前,我们的整妆都是“风格整妆”,它本质上是一种特效,无法跟其他特效叠加,或叠加后不符合预期。而轻美妆可以跟其他任意特效叠加,也可以与风格整妆叠加(但不建议这么做)。在V3.9.0及之后的 Demo 中,我们把“风格整妆”的体验入口与 2D 贴纸和 3D 贴纸的入口放在了一起。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈