腾讯特效 SDK iOS(素材集成指引)

这篇说明腾讯云美颜特效SDK中滤镜、动效贴纸及美妆/背景分割的集成方法,分别针对使用TEBeautyKit面板库与直接集成SDK两种场景,给出资源添加、路径配置及调用步骤。 滤镜:将png图片放入lut.bundle目录,配置lut.json的icon与resourceUri字段。 动效贴纸:将动效文件夹放入对应bundle目录,配置motions.json的icon与resourceUri字段。 美妆与背景分割:用。

相关产品
腾讯特效 SDK 产品页,含版本规格、价格与购买入口。

一、滤镜

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

赞 (0)
上一篇 4天前
下一篇 4天前