Skip to main content
Linux 平台使用的 C++ SDK 接口与 Windows 平台完全相同,请参阅: 👉 Windows C++ API 参考 以下仅列出 Linux 平台特有的注意事项。

Linux 特有注意事项

动态库加载

Linux 上 SDK 以共享库 libfacebetter.so 形式发布。运行时需确保系统可以找到该库:

CMake 链接配置

CMakeLists.txt 中链接 SDK:

OpenGL 环境

Linux 上使用 SDK 需要有效的 OpenGL 上下文。请确保已安装必要的图形库:
如在无头(headless)服务器环境运行,可使用 Mesa 的离屏渲染:

external_context 字段

在 Linux 上,如果应用程序已经管理了 OpenGL 上下文(例如使用 GLFW),请设置:
设置为 true 时,SDK 不会创建内部 GL 上下文,所有 GPU 调用将在当前线程的已激活上下文中执行。

SetRenderView 不适用

该方法仅在 iOS / macOS 平台有效,Linux 上请勿调用。

DISPLAY 环境变量

使用 GLFW 显示窗口时需要 X11 或 Wayland 显示服务器,确保环境变量已设置:
若在 SSH 会话中运行,需开启 X11 转发:

完整 API 文档

所有方法、枚举、结构体的完整说明,请参阅 Windows C++ API 参考,该文档同样适用于 Linux 平台。