SDK 2.0.0。鉴权失败见 授权与许可。
FacebetterError。数值型 code 见下表。加载 / 鉴权失败时部分错误使用字符串 code。
数值错误码
JavaScript 层码(字符串)
出现在init() / 加载 / 鉴权阶段:
初始化排查
- 配置合法:非空
licenseToken。 - SDK 能下载到运行时文件(
facebetter-core包,或与 UMD 脚本同目录的文件)。 - 页面处于安全上下文。
- 生产环境控制台绑定的域名与页面 origin 一致。
- 生产前端包里没有嵌入
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。

