跳转到主要内容
本文对应 SDK 2.0.0。Windows 使用 C++ API（facebetter 命名空间，头文件 facebetter/*.h）。
本文说明如何在 Windows 上构建 Facebetter C++ 桌面 Demo。Demo 使用 GLFW + Dear ImGui + OpenGL 3：左侧实时预览，右侧调节美颜参数。

​
环境要求

也可以使用 MinGW-w64，但推荐 MSVC。

​
第一步：克隆仓库

​
第二步：放置 SDK 文件

将 Windows SDK 解压后放入 demo/cpp/sdk/：
桌面端 EngineConfig::resource_path 必须指向 resource.fbd 文件本身，不能填目录。例如：demo/cpp/sdk/resource/resource.fbd。
SDK 包见 下载页 或 控制台。

​
第三步：配置授权

运行前设置 app_id / app_key（在线 v2 鉴权），或设置 license_token。license_token 非空时优先（许可证 token、{token} JSON，或离线 .lic 内容）。详见 授权与许可。

​
第四步：构建

打开 Developer Command Prompt for VS（或已加载 MSVC 环境的 PowerShell）：
构建完成后 CMake 通常会：
  • 将 facebetter.dll 复制到 build/ 可执行文件旁
  • 将 resource/resource.fbd 复制到 build/resource/resource.fbd
  • 若存在 demo.png，复制到 build/resource/demo.png

​
第五步：准备预览图（可选）

将人脸照片命名为 demo.png，放到 demo/cpp/：

​
第六步：运行

窗口包含：
  • 左侧 — 实时美颜预览
  • 右侧 — 控制面板：基础美颜、26 项美型（范围 [-1.0, 1.0]）、7 项美体（范围 [0.0, 1.0]，需 resource_body.fbd）、美妆、滤镜 / 贴纸 / 虚拟背景
点击 Reset All 可将强度归零。

​
常见问题

Q：启动提示找不到 facebetter.dll
A：确认 demo/cpp/sdk/lib/facebetter.dll 存在，再执行 cmake --build build 让 CMake 复制到可执行文件旁。 Q：Create 返回空指针 / 授权失败
A：resource_path 必须指向 resource.fbd，并配置 license_token 或有效的 app_id + app_key。见 授权与许可。 Q：CMake 找不到 Ninja
A：执行 winget install Ninja-build.Ninja，或改用 -G "Visual Studio 17 2022" 并配合 --config Release。

​
下一步

实现美颜

创建引擎、设置效果并处理帧。

API 参考

Windows 的 C++ API。