滤镜
每个滤镜都是一张 png 格式的图片,使用时,您需要将图片路径传给 SDK。具体做法如下:
场景一:如果您使用了 TEBeautyKit
TEBeautyKit 是腾讯特效的 UI 面板库,用于客户快速方便的使用和管理美颜功能。
操作步骤见下:
1. 参见文档 接入 TEBeautyKit。
2. 添加滤镜资源
将新增加的滤镜图片放到您工程的
assets/lut
目录,然后,修改面板配置文件assets/beauty_panel/lut.json
,参见json中已有的内容新增加一项。APP 运行时,调用TEBeautyKit
的copyRes
方法,会把滤镜图片从 assets 目录 copy 到lut.json
里配置的 downloadPath 目录。3. 配置滤镜图标
lut.json
的 icon 字段是该滤镜的图标,请把图标放在assets/beauty_panel/panel_icon/lut_icon
目录。icon 字段的值也可以是图标的 URL,以http
或https
开头,TEBeautyKit 会从网络拉取这个图标。4. 配置滤镜资源
lut.json
的 resourceUri 字段是滤镜图片在 app 私有目录的保存路径,请参见json中已有的项目进行配置并把 resourceUri 的后缀"xxx.png"改为新增加的这个滤镜文件名,确保不会跟lut.json
里的已有的滤镜冲突。resourceUri 字段也可以是滤镜图片的 URL,以http
或https
开头,点击后会联网下载,并保存在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 运行时,调用TEBeautyKit
的copyRes
方法,会把动效文件夹从 assets 目录 copy 到motions.json
里配置的 downloadPath 目录。3. 配置动效图标
motions.json
的 icon 字段是该动效的图标,请把图标放在assets/beauty_panel/panel_icon/motions_icon
目录。icon 字段的值也可以是图标的 URL,以http
或https
开头,TEBeautyKit 会从网络拉取这个图标。4. 配置动效素材
motions.json
的 resourceUri 字段是动效在 app 私有目录的保存路径,请参见已有的项目进行配置,并确保不会跟motions.json
里的已有的动效冲突。resourceUri 字段也可以是动效压缩包的 URL,以http
或https
开头,点击后会联网下载,并保存在motions.json
里配置的 downloadPath 目录。场景二:如果您未使用 TEBeautyKit,而是直接集成腾讯特效 SDK
请将新增加的动效文件夹放到您工程的 assets 的任意目录,然后在 APP 初始化时,将它 copy 到 app 私有目录或 SD 卡,得到动效的路径,记为
/path/to/your/motion
。使用动效时,调用 SDK 的 setEffect 方法,将该路径传给 SDK。美妆、背景分割动效
与上文中的动效贴纸用法是一样的,二者对应的 json 文件分别是
makeup.json
和segmentation.json
。