iOS

Filters

Each filter is an image in png format. When using it, you need to pass the image path to the SDK.

Scenario 1: Using TEBeautyKit

TEBeautyKit is a UI panel library for Tencent Effect. It is designed for users to use and manage beauty features quickly and conveniently. See below for the operation steps.
2. Adding Filter Materials
Place the newly added filter image in your project's lut.bundle directory. Then, modify the panel configuration file TEBeautyKit/Assets/json/lut.json, adding a new item based on the existing content in json.
3. Configuring Filter Icons
The icon field in lut.json represents the icon of the filter. Place the icon in the TEBeautyKit/Assets/BeautyRes directory. The value of the icon field can also be the URL of the icon, starting with http or https, and TEBeautyKit will fetch the icon from the internet.
4. Configuring Filter Resources
The resourceUri field in lut.json is the path where the filter image is saved in the app's private directory. Configure the resources based on the existing items in json and change the suffix of resourceUri from "xxx.png" to the file name of the newly added filter, avoiding conflicts with existing filters in lut.json. The resourceUri field can also be the URL of the filter image, starting with http or https. When the URL is clicked, the filter image will be downloaded from the internet and saved in the downloadPath directory configured in lut.json.

Scenario 2: Integrating the Tencent Effect SDK Directly

1. Place the newly added filter image in your project's lut.bundle directory. If using a dynamic download approach, download the filter image to the sandbox and record the path of the filter image.
2. When using a filter, call the SDK's setEffect method and pass the path of the filter image to the SDK. For the method of operation, refer to Beauty Parameter Description.

Animation Stickers

Each animation is a folder. When using it, you need to pass the path of this folder to the SDK. See below for the operation steps.

Scenario 1: Using TEBeautyKit

TEBeautyKit is a UI panel library for Tencent Effect. It is designed for users to use and manage the beauty features quickly and conveniently.
2. Adding Animation Resources
Place the newly added animation folder in the corresponding resource bundle directory of your project: in 2dMotionRes.bundle for 2D animations, in 3dMotionRes.bundle for 3D animations, in ganMotionRes.bundle for fun animations, or in handMotionRes.bundle for gesture animations. Then, modify the panel configuration file TEBeautyKit/Assets/json/motions.json, adding a new item based on the existing content.
3. Configuring Animation Icons
The icon field in motions.json represents the icon of the animation. Place the icon in the TEBeautyKit/Assets/BeautyRes directory. The value of the icon field can also be the URL of the icon, starting with http or https, and TEBeautyKit will fetch the icon from the internet.
4. Configuring Animation Resources
The resourceUri field in motions.json is the path where the animation is saved in the app's private directory. Configure the resources based on the existing items, avoiding conflicts with existing animations in motions.json. The resourceUri field can also be the URL of the animation zip file, starting with http or https. When the URL is clicked, the zip file will be downloaded from the internet and saved in the downloadPath directory configured in motions.json. The animation zip file needs to be unzipped before use.

Scenario 2: Integrating the Tencent Effect SDK Directly

Place the newly added animation folder in the corresponding resource bundle directory of your project: in 2dMotionRes.bundle for 2D animations, in 3dMotionRes.bundle for 3D animations, in ganMotionRes.bundle for fun animations, or in handMotionRes.bundle for gesture animations. In Tencent Effect SDK of version 3.6.0 or earlier, if the animation file is encrypted, you need to copy it to the sandbox and record its path. If using a dynamic download approach, download the animation file to the sandbox and unzip it, and then record the path of the unzipped animation folder. When using the animation, call the SDK's setEffect method and pass the path to the SDK. Refer to Beauty Parameter Table.

Beauty Makeup and Background Segmentation

Their usage is the same as the Animation Sticker described above, with the corresponding json files being makeup.json and segmentation.json, respectively.