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 政策
隐私协议
数据处理和安全协议
联系我们

Android

PDF
聚焦模式
字号
最后更新时间: 2024-07-05 14:30:35

滤镜

每个滤镜都是一张 png 格式的图片,使用时,您需要将图片路径传给 SDK。具体做法如下:

场景一:如果您使用了 TEBeautyKit

TEBeautyKit 是腾讯特效的 UI 面板库,用于客户快速方便的使用和管理美颜功能。
操作步骤见下:
1. 参见文档 接入 TEBeautyKit
2. 添加滤镜资源
将新增加的滤镜图片放到您工程的assets/lut目录,然后,修改面板配置文件assets/beauty_panel/lut.json,参见json中已有的内容新增加一项。APP 运行时,调用TEBeautyKitcopyRes方法,会把滤镜图片从 assets 目录 copy 到lut.json里配置的 downloadPath 目录。
3. 配置滤镜图标
lut.json的 icon 字段是该滤镜的图标,请把图标放在assets/beauty_panel/panel_icon/lut_icon目录。icon 字段的值也可以是图标的 URL,以httphttps开头,TEBeautyKit 会从网络拉取这个图标。
4. 配置滤镜资源
lut.json的 resourceUri 字段是滤镜图片在 app 私有目录的保存路径,请参见json中已有的项目进行配置并把 resourceUri 的后缀"xxx.png"改为新增加的这个滤镜文件名,确保不会跟lut.json里的已有的滤镜冲突。resourceUri 字段也可以是滤镜图片的 URL,以httphttps开头,点击后会联网下载,并保存在lut.json里配置的 downloadPath 目录。

场景二:如果您未使用 TEBeautyKit,而是直接集成腾讯特效 SDK

1. 请将新增加的滤镜图片放到您工程的 assets 的任意目录,然后在 APP 初始化时,将它 copy 到 app 私有目录或 SD 卡,得到图片的路径,记为 /path/to/your/lut_xxx.png。为简化操作,建议您把图片放到 assets/lut 目录,然后从 demo 工程中把 TEBeautyKit 的 copyRes 代码 copy 过来使用。
2. 使用滤镜时,调用 SDK 的 setEffect 方法,将滤镜图片路径传给 SDK。

动效贴纸

每个动效都是一个文件夹,使用时,您需要将该文件夹的路径传给 SDK。具体做法如下:

场景一:如果您使用了 TEBeautyKit

TEBeautyKit 是腾讯特效的 UI 面板库,用于客户快速方便的使用和管理美颜功能。
操作步骤见下:
1. 参见文档 接入 TEBeautyKit
2. 添加动效素材
将新增加的动效文件夹放到您工程的assets/MotionRes目录,然后,修改面板配置文件assets/beauty_panel/motions.json,参见已有的内容新增加一项。APP 运行时,调用TEBeautyKitcopyRes方法,会把动效文件夹从 assets 目录 copy 到motions.json里配置的 downloadPath 目录。
3. 配置动效图标
motions.json的 icon 字段是该动效的图标,请把图标放在assets/beauty_panel/panel_icon/motions_icon目录。icon 字段的值也可以是图标的 URL,以httphttps开头,TEBeautyKit 会从网络拉取这个图标。
4. 配置动效素材
motions.json的 resourceUri 字段是动效在 app 私有目录的保存路径,请参见已有的项目进行配置,并确保不会跟motions.json里的已有的动效冲突。resourceUri 字段也可以是动效压缩包的 URL,以httphttps开头,点击后会联网下载,并保存在motions.json里配置的 downloadPath 目录。

场景二:如果您未使用 TEBeautyKit,而是直接集成腾讯特效 SDK

请将新增加的动效文件夹放到您工程的 assets 的任意目录,然后在 APP 初始化时,将它 copy 到 app 私有目录或 SD 卡,得到动效的路径,记为 /path/to/your/motion。使用动效时,调用 SDK 的 setEffect 方法,将该路径传给 SDK。

美妆、背景分割动效

与上文中的动效贴纸用法是一样的,二者对应的 json 文件分别是makeup.jsonsegmentation.json

帮助和支持

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

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

文档反馈