Skip to main content
本文档对应 SDK 2.0.0。授权见 授权认证

错误码(FBErrorCode

设置类接口返回 int0 表示成功。createEngineWithConfig:processImage: 返回对象,失败为 nil

检查返回值

统一映射错误码:

引擎事件

FBEngineCallbacks.onEngineEvent 异步上报授权与初始化。创建引擎后立刻设置回调。
createEngineWithConfig: 返回非 nil 并不等于授权已成功。在线授权仍可能随后失败,请监听事件 1 / 101

图像处理

校验帧、设置 type,将 nil 视为处理失败(FBErrorCode_Process)。macOS 可处理更大静图,但仍应拒绝零尺寸缓冲。
保存使用 toFile:(返回 FBErrorCode):
createWithNSImage:NSImage 没有位图表示时返回 nil

日志

创建引擎之前打开日志。写文件时先创建目录。沙盒 Mac 应用应写到容器内(例如 Application Support),不要写任意路径。

macOS 特有失败

  • App Sandbox:在线 appId / appKey 需要出站网络。用户选择的文件需要 security-scoped bookmark(startAccessingSecurityScopedResource)。
  • -5 I/O.fbd / 背景图在沙盒外,或未 start bookmark。
  • 命令行工具:没有 Bundle ID 时,请在控制台绑定进程名。
  • 外部 GLexternalContext = YES 时必须在同一 OpenGL 线程创建并处理。

常见原因

  • -1 参数无效:空 .fbd 路径、NSData 为 nil、强度越界、配置为 nil。
  • -2 未初始化createEngineWithConfig: 失败后实例为 nil
  • -3 授权:凭证错误、未绑定 Bundle ID、token 过期,或沙盒拦住授权请求。见 授权认证