跳转到主要内容
SDK 2.0.0。鉴权见 授权与许可。

返回值

大多数 setter 返回 int: BeautyEffectEngine::Create() 返回 std::shared_ptr,失败为 nullptr。ProcessImage 失败也可能返回空指针。

引擎事件

Create 之后注册 on_engine_event: 失败时 message 含详细说明。

常见失败

1. Create 返回 nullptr

常见原因:
  • resource_path 是目录、路径错误,或不是 resource.fbd 文件
  • app_id + app_key 无效,或 license_token 错误
  • facebetter.dll 缺失或与 facebetter.lib 不匹配
  • 无法访问 /facebetter/v2/auth
务必在 Create 之前打开日志:

2. 找不到 facebetter.dll

DLL 不在加载路径时,Windows 会弹窗。
或重新构建,让 CMake 复制到可执行文件旁。

3. ProcessImage 返回 nullptr

检查输入帧、引擎指针和日志(setter 上的 -7 处理失败 / -8 内存不足)。

4. 效果看起来没变化

2.0 没有 SetBeautyTypeEnabled。强度为 0 即关闭。美型 / 美妆还需要检测到人脸。

5. OpenGL / 显示

驱动过旧、虚拟机或无 GPU 的远程桌面会导致 GLFW / gladLoadGLLoader 失败。
若应用已持有 GL 上下文,设置 EngineConfig::external_context = true,并在该线程调用 ProcessImage。

调试日志

未使用绝对路径时,日志文件相对当前工作目录写入。