iOS

滤镜

每个滤镜都是一张 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