tencent cloud

文档反馈

最后更新时间: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
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持