本文档对应 SDK 2.0.0。授权见 授权认证。
错误码(FBErrorCode)
设置类接口返回 int,0 表示成功。createEngineWithConfig: 与 processImage: 返回对象,失败为 nil。
检查返回值
引擎事件
FBEngineCallbacks.onEngineEvent 异步上报授权与初始化。创建引擎后立刻设置回调。
图像处理
校验帧、设置type,将 nil 视为处理失败(FBErrorCode_Process)。macOS 可处理更大静图,但仍应拒绝零尺寸缓冲。
toFile:(返回 FBErrorCode):
createWithNSImage: 在 NSImage 没有位图表示时返回 nil。
日志
在创建引擎之前打开日志。写文件时先创建目录。沙盒 Mac 应用应写到容器内(例如 Application Support),不要写任意路径。macOS 特有失败
- App Sandbox:在线
appId/appKey需要出站网络。用户选择的文件需要 security-scoped bookmark(startAccessingSecurityScopedResource)。 -5I/O:.fbd/ 背景图在沙盒外,或未 start bookmark。- 命令行工具:没有 Bundle ID 时,请在控制台绑定进程名。
- 外部 GL:
externalContext = YES时必须在同一 OpenGL 线程创建并处理。
常见原因
-1参数无效:空.fbd路径、NSData为 nil、强度越界、配置为 nil。-2未初始化:createEngineWithConfig:失败后实例为nil。-3授权:凭证错误、未绑定 Bundle ID、token 过期,或沙盒拦住授权请求。见 授权认证。

