常见问题

开发:黑屏

请先获取技术信息,根据日志、屏幕显示等自行分析问题。

很多情况错误信息都是自说明的。如果屏幕信息或日志已经说明了出错原因,那可以根据具体原因去解决。如果错误原因是不支持等,那就是不支持,这种时候不需要继续查看,除非你认为不支持本身是错误的。

如果无法解决,请反馈技术信息(包括日志、截图、详细的设备信息等)。请勿直接反馈黑屏两个字。

开发:定位不到

首先,请查看定位返回的具体信息,Unity开发可以查看 MegaTrackerFrameFilter.LocalizationResponse.Status (一般sample都会显示在屏幕上)

常见情况

  • 定位返回出现异常(状态是Found和NotFound以外的值)

  • 定位服务还在启动过程中(状态持续是NotFound)

  • 定位服务中的Block与现实场景不同(状态持续是NotFound)

  • 关闭了 MegaTrackerFrameFilter.FallbackOptions.AllowNonEifRemote ,但却不在现场运行(状态持续是NotFound)

开发:定位返回出现异常

如果使用EasyAR Sense开发,会遇到这些异常情况

  • RequestTimeout:请求超时

  • RequestIntervalTooLow:请求间隔过短

  • UnknownError

UnknownError常见有两种情况

  • 连接或传输失败

  • 服务返回异常

对于UnknownError,可以通过 MegaTrackerFrameFilter.LocalizationResponse.ErrorMessage 获取详细信息

服务返回异常可以看到错误码,一些情况下也有详细的错误原因输出,有如下几种情况

HTTP STATUS

Status code

原因

200

21

QPS超出限制

401

-

认证失败,见具体消息描述

200

1040x

参数、库或者地图数据不正确,见具体消息描述

200

4000x

算法级别报错,见具体消息描述

50x

-

服务器程序报错

异常的解决方法

  • 请求超时:查看并修复网络情况,如有必要可以调高请求超时时间 MegaTrackerFrameFilter.TimeParameters.Timeout ,但网络情况不好也会对跟踪效果产生影响,因此需要尽量解决网络问题

  • 请求间隔过短:降低请求间隔

  • 连接或传输失败:查看并修复网络情况

  • 服务返回异常 - QPS超出限制:

  • 服务返回异常 - 认证失败:根据具体消息描述解决,常见问题有设备时间与标准时间偏差过大、API Key没有CLS权限等。

  • 服务返回异常 - 其它情况:请反馈给EasyAR工作人员解决

开发:Invalid Key

常见有这些情况

  • Invalid Key: No matched Bundle ID:Bundle ID与license key不匹配,请修改其中的任意一个

  • Invalid Key: No matched Package Name:Bundle ID与license key不匹配,请修改其中的任意一个

  • Invalid Key: License does not apply to current variant:使用了企业包的SDK但非企业版的license key,或使用了非企业包的SDk但使用了企业包的license key

  • Invalid Key: License for an old version does not apply:license版本太老,应重新创建新的license

  • Invalid Key: Invalid format:license格式错误,比如没有复制全

  • Invalid Key: Server verification failed:license已删除

开发:Running Failed: License for Custom Camera timeout for current process

在使用个人版EasyAR Sense的时候,如果你在使用Nreal设备、AR Foundation、Huawei AR EngineUnity插件,或其它利用Custom Camera的功能情形,在运行超过100秒后在日志中会看到这个错误,并且整个AR功能完全停止工作。重启应用之后可以恢复。

这是个人版EasyAR Sense的限制,使用付费版本的EasyAR Sense可以解决这个问题。

开发(Unity):EasyAR License for ** will timeout for current process within ** seconds. (Personal Edition Only)

在运行Nreal或AR Foundation的sample的时候,会看到sample显示这个文字。

在使用个人版EasyAR Sense的时候,如果你在使用Nreal设备、AR Foundation、Huawei AR EngineUnity插件,或其它利用Custom Camera的功能情形,在运行超过100秒后在日志中会看到这个错误,并且整个AR功能完全停止工作。重启应用之后可以恢复。

这是个人版EasyAR Sense的限制,使用付费版本的EasyAR Sense可以解决这个问题。

如果你已经在使用付费版的EasyAR Sense,可以忽略或直接从sample中删除相关文字。