Skip to main content
SDK 2.0.0。与 Windows 同一套 C++ API(facebetter 命名空间)。枚举见 参数枚举。鉴权见 许可证与鉴权
Linux 使用 libfacebetter.sofacebetter/*.h。流程参考 C++ 桌面 Demodemo/cpp)。编译 SDK 本身可用 ./scripts/build_linux.sh,或在 build/linux 下用 CMake。

引入头文件

CMake 链接

运行时设置 LD_LIBRARY_PATH、把 libfacebetter.so 放到可执行文件旁,或用 ldconfig 安装。

集成流程

没有「启用美颜类型」步骤。强度为 0 即关闭该效果。

1. 配置日志(可选)

Create 之前调用。

2. 创建引擎

桌面端 必须resource_path 设为 resource.fbd 文件路径。 鉴权优先级: 非空 license_token(token / {token} JSON / .lic)优先;否则 app_id + app_key 在线 v2。
resource_path 必须是 resource.fbd 文件,不能是目录。生产环境建议用绝对路径。

3. 设置美颜参数

皮肤 / 美妆 [0.0, 1.0]。美型 [-1.0, 1.0]。完整枚举见 参数枚举
眼影、眼线、眉毛、睫毛、美瞳同理。

4. 滤镜、贴纸与虚拟背景

传入 路径字节

5. 回调与统计


6. 处理图像

设置 ImageFrame::type
照片:
输出格式尽量与输入一致。可用 output->Convert(Format::BGRA) 转换。

OpenGL 预览

若应用已有当前 GL 上下文,设置 cfg.external_context = true,并在该线程调用 ProcessImage

7. 最小示例

engine.reset() 释放。引擎 不是单例。

相关文档

API 参考

C++ 方法与 Linux 说明

错误处理

返回码与 .so / DISPLAY

最佳实践

性能与 rpath

常见问题

FAQ