在调用 ARSDK.createSession
、 session.start
、session.loadEffect
等方法时可能由于「授权失效」、「网络不稳定」、「特效包地址有误」、「用户未授予相机权限」等问题出现错误。Web AR SDK 会在出现错误的时候抛出异常。你可以通过使用 try
、catch
来捕获异常给予用户适当的提示。
try { await session.start(); } catch (error) { alert(error); }
常见的错误类型:(通过 error.name 区分)
WebARAuthorizationError:授权问题,请检查所使用的「授权证书文件」和「授权服务地址」是否正确,以及当前页面所使用的域名是否是申请授权时提供的域名。
WebARCompatibilityError:兼容性问题,具体原因可以参考 error.message
。
NotAllowedError:设备权限问题,用户拒绝授予相机设备权限。
ConstraintError:摄像头无法满足 SDK 的要求(分辨率过低或帧率过低)。
TypeError:网络请求出错。