HarmonyOS API 参考

HarmonyOS 平台推荐使用 C++ 接口（通过 Native SDK），与 Windows/Linux 平台保持一致。

BeautyEffectEngine

美颜效果引擎的核心类。

滤镜与贴纸管理

SetFilter

virtual int SetFilter(const std::string& filter_id) = 0;

功能：设置当前滤镜
参数：filter_id：滤镜唯一标识符，传入空字符串可清除滤镜

SetFilterIntensity

virtual int SetFilterIntensity(float intensity) = 0;

功能：设置滤镜强度（0.0 - 1.0）

SetSticker

virtual int SetSticker(const std::string& sticker_id) = 0;

功能：设置当前贴纸，传入空字符串可清除贴纸

RegisterFilter

virtual int RegisterFilter(const std::string& filter_id, const std::string& fbd_file_path) = 0;
virtual int RegisterFilter(const std::string& filter_id, const std::vector<uint8_t>& fbd_data) = 0;

功能：注册滤镜资源（文件路径或内存数据）

RegisterSticker

virtual int RegisterSticker(const std::string& sticker_id, const std::string& fbd_file_path) = 0;
virtual int RegisterSticker(const std::string& sticker_id, const std::vector<uint8_t>& fbd_data) = 0;

功能：注册贴纸资源

UnregisterFilter / UnregisterSticker

virtual int UnregisterFilter(const std::string& filter_id) = 0;
virtual int UnregisterSticker(const std::string& sticker_id) = 0;

功能：卸载资源

GetRegisteredFilters / GetRegisteredStickers

virtual std::vector<std::string> GetRegisteredFilters() const = 0;
virtual std::vector<std::string> GetRegisteredStickers() const = 0;

功能：获取已注册资源列表