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

iOS

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

滤镜

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

场景一:如果您使用了 TEBeautyKit

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

场景二:直接集成腾讯特效 SDK

1. 请将新增加的滤镜图片放到您工程的 lut.bundle 目录。如果采用动态下载的方案,把滤镜图片下载到沙盒中,记录滤镜图片的路径。
2. 使用滤镜时,调用 SDK 的 setEffect 方法,将滤镜图片路径传给 SDK。操作方法参见 美颜参数说明

动效贴纸

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

场景一:如果您使用了TEBeautyKit

TEBeautyKit 是腾讯特效的 UI 面板库,用于客户快速方便的使用和管理美颜功能。
1. 参见文档 接入 TEBeautyKit
2. 添加动效资源
请将新增加的动效文件夹放到您工程对应的resource bundle 目录:2dMotionRes.bundle中是2D动效,3dMotionRes.bundle中是3D动效,ganMotionRes.bundle中是趣味动效,handMotionRes.bundle中是手势动效, 然后,修改面板配置文件 TEBeautyKit/Assets/json/motions.json,参考已有的内容新增加一项。
3. 配置动效icon
motions.jsonicon字段是该动效的图标,请把图标放在 TEBeautyKit/Assets/BeautyRes 目录。icon字段的值也可以是图标的URL,以http或https开头,TEBeautyKit会从网络拉取这个图标。
4. 配置动效资源
motions.jsonresourceUri字段是动效在app私有目录的保存路径,请参考已有的项目进行配置,并确保不会跟motions.json里的已有的动效冲突。resourceUri字段也可以是动效压缩包的URL,以http或https开头,点击后会联网下载,并保存在motions.json里配置的downloadPath目录,动效压缩包需要解压以后才能使用。

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

请将新增加的动效文件夹放到您工程对应的resource bundle 目录:2dMotionRes.bundle中是2D动效,3dMotionRes.bundle中是3D动效,ganMotionRes.bundle中是趣味动效,handMotionRes.bundle中是手势动效,在腾讯特效SDK version 3.6.0及以前的版本,如果是加密的动效文件,需要把动效文件拷贝到沙箱,记录这个动效文件的路径。如果采用动态下载的方案,把动效文件下载到沙盒中并解压,记录解压后的动效文件夹的路径。使用动效时,调用SDK的setEffect方法,将该路径传给SDK,详见: 美颜参数表

美妆、背景分割动效

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

帮助和支持

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

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

文档反馈