AI 美颜如何实现挂件功能？

产品 / 插件：AI 美颜

平台 / 框架：iOS / Android / macOS / Windows

更新时间：2025-01-08 17:13

从 2.0.0 版本之后的 AI 美颜 SDK 不再支持挂件。

1 功能简介

ZegoEffects SDK 提供人脸特效挂件，基于人脸关键点检测与跟踪算法，提供人脸特效，SDK 可直接将二维挂件素材准确贴合人脸，通过脸部动作触发挂件特效，让直播变得更有趣。

在使用 ZegoEffects SDK 挂件功能前，请确保完成以下操作：

以下链接以 iOS 为例，如接入其他平台，请自行切换

挂件贴纸包括：三只动物（Animal）、小丑（Clown）、小鹿（Deer）、潜水镜（Dive）、炫酷脸膜（Facefilm）、美少女战士（Girl）、猫头（Cat）、西瓜（Watermelon）等效果，开发者在调用接口时，可以根据需要，选择对应的滤镜资源使用。

iOS-Objective-C 平台 Android-Java 平台 macOS-Objective-C 平台 macOS-C 平台 Windows-C 平台

调用 setPendant 接口，将挂件路径设置到 SDK。如果需要移除挂件，可将 nil 传入 setPendant 接口。

// 设置挂件
[effects setPendant:@"/xxx/xxx/pendantBaby.bundle"];
// 移除挂件
[effects setPendant:nil];

调用 setPendant 接口，将挂件路径设置到 SDK。如果需要移除挂件，可将 null 传入 setPendant 接口。

// 设置挂件
mEffects.setPendant("/xxx/xxx/pendantBaby.bundle");
// 移除挂件
mEffects.setPendant(null);

调用 setPendant 接口，将挂件路径设置到 SDK。如果需要移除挂件，可将 nil 传入 setPendant 接口。

// 设置挂件
[effects setPendant:@"/xxx/xxx/pendantBaby.bundle"];

// 移除挂件
[effects setPendant:nil];

调用 zego_effects_set_pendant 接口，将挂件路径设置到 SDK。如果需要移除挂件，可将挂件路径设置为空，传入 zego_effects_set_pendant 接口。

// 设置挂件
zego_effects_set_pendant(handle, "/xxx/xxx/pendantBaby.bundle");

// 移除挂件
zego_effects_set_pendant(handle, "");

调用 zego_effects_set_pendant 接口，将挂件路径设置到 SDK。如果需要移除挂件，可将挂件路径设置为空，传入 zego_effects_set_pendant 接口。

// 设置挂件
zego_effects_set_pendant(handle, "/xxx/xxx/pendantBaby.bundle");

// 移除挂件
zego_effects_set_pendant(handle, "");