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.json
的 resourceUri
字段是滤镜图片在 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.json
的icon
字段是该动效的图标,请把图标放在 TEBeautyKit/Assets/BeautyRes
目录。icon字段的值也可以是图标的URL,以http或https
开头,TEBeautyKit
会从网络拉取这个图标。4. 配置动效资源
motions.json
的resourceUri
字段是动效在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.json
和 segmentation.json
。