跳转到主要内容
SDK 2.0.0。与 Windows 同一套 C++ API(facebetter 命名空间)。枚举见 参数枚举。鉴权见 授权与许可。
Linux 使用 libfacebetter.so 和 facebetter/*.h。流程参考 C++ 桌面 Demo(demo/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]。美体需要 resource_body.fbd。完整枚举见 参数枚举,资源包见 可选资源包。
眼影、眼线、眉毛、睫毛、美瞳同理。

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

传入 路径 或 字节。

5. 回调与统计


6. 处理图像

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

OpenGL 预览

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

7. 最小示例

用 engine.reset() 释放。引擎 不是单例。 接入 TRTC / 声网 / LiveKit:见 第三方对接。

相关文档

第三方对接

TRTC / 声网 / LiveKit

API 参考

C++ 方法与 Linux 说明

错误处理

返回码与 .so / DISPLAY

最佳实践

性能与 rpath