跳转到主要内容
SDK 2.0.0。鉴权失败见 授权与许可。
调用失败会抛 FacebetterError。数值型 code 见下表。加载 / 鉴权失败时部分错误使用字符串 code。

数值错误码

JavaScript 层码(字符串)

出现在 init() / 加载 / 鉴权阶段:

初始化排查

  1. 配置合法:非空 licenseToken。
  2. SDK 能下载到运行时文件(facebetter-core 包,或与 UMD 脚本同目录的文件)。
  3. 页面处于安全上下文。
  4. 生产环境控制台绑定的域名与页面 origin 一致。
  5. 生产前端包里没有嵌入 appKey。

参数与处理错误

美颜强度必须在 [0.0, 1.0],美型必须在 [-1.0, 1.0]。越界会在进入原生之前抛 FacebetterError。 引擎未初始化、缓冲分配失败或原生处理返回非 0 时,processImage 会抛错。调用前确认视频 readyState,以及 videoWidth / videoHeight 非 0。 滤镜 / 贴纸 / 背景的路径不能为空;关闭请用 clearFilter()、clearSticker()、clearVirtualBackground()。

引擎事件与异常

init() 已经成功返回后,鉴权 / 初始化结果仍可能通过 onEngineEvent 到达(EngineEventCode 的 0 / 1 / 100 / 101)。即使 init() 没抛错,也要监听 LicenseValidationFailed 和 InitializationFailed。

相关文档