常见问题¶
开发：黑屏¶
请先获取技术信息，根据日志、屏幕显示等自行分析问题。
很多情况错误信息都是自说明的。如果屏幕信息或日志已经说明了出错原因，那可以根据具体原因去解决。如果错误原因是不支持等，那就是不支持，这种时候不需要继续查看，除非你认为不支持本身是错误的。
如果无法解决，请反馈技术信息（包括日志、截图、详细的设备信息等）。请勿直接反馈黑屏两个字。
开发：定位不到¶
首先，请查看定位返回的具体信息，Unity开发可以查看 MegaBlockLocalizationResponse.Status （一般都会显示在屏幕上，看不到的时候注意打开诊断信息）
常见情况
定位返回出现异常（状态是Found和NotFound以外的值）
定位服务还在启动过程中（状态持续是NotFound）
定位服务中的Block与现实场景不同（状态持续是NotFound）
MegaBlockTrackerFrameFilter.LocationInputMode 设置为了
Onsite，但却不在现场运行（状态持续是NotFound）
开发：定位返回出现异常¶
如果使用EasyAR Sense开发，会遇到这些异常情况
RequestTimeout：请求超时
RequestIntervalTooLow：请求间隔过短
UnknownError
UnknownError常见有两种情况
连接或传输失败
服务返回异常
对于UnknownError，可以通过 MegaBlockLocalizationResponse.ErrorMessage 获取详细信息
服务返回异常可以看到错误码，一些情况下也有详细的错误原因输出，有如下几种情况
HTTP STATUS |
Status code |
原因 |
|---|---|---|
200 |
21 |
QPS超出限制 |
401 |
- |
认证失败，见具体消息描述 |
200 |
1040x |
参数、库或者地图数据不正确，见具体消息描述 |
200 |
4000x |
算法级别报错，见具体消息描述 |
50x |
- |
服务器程序报错 |
404 |
- |
URL中的路径输入不正确 |
异常的解决方法
请求超时：查看并修复网络情况，如有必要可以调高请求超时时间 MegaRequestTimeParameters.Timeout ，但网络情况不好也会对跟踪效果产生影响，因此需要尽量解决网络问题
请求间隔过短：降低请求间隔
连接或传输失败：查看并修复网络情况
服务返回异常 - QPS超出限制：
服务返回异常 - 认证失败：根据具体消息描述解决，常见问题有设备时间与标准时间偏差过大、API Key没有CLS权限等。
服务返回异常 - 其它情况：请反馈给EasyAR工作人员解决
开发（Unity及原生App）：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已删除
开发（Unity及原生App）：Running Failed: License for Custom Camera timeout for current process¶
在使用个人版EasyAR Sense的时候，如果你在使用Nreal或其它眼镜设备、AR Foundation、AREngine，或其它利用Custom Camera的功能情形，在运行超过100秒后在日志中会看到这个错误，并且整个AR功能完全停止工作。重启应用之后可以恢复。
这是个人版EasyAR Sense的限制，使用付费版本的EasyAR Sense可以解决这个问题。
开发（Unity）：EasyAR License for ** will timeout for current process within ** seconds. (Personal Edition Only)¶
在运行AR Foundation或Nreal或其它AR眼镜的sample的时候，会看到sample显示这个文字。
在使用个人版EasyAR Sense的时候，如果你在使用Nreal或其它眼镜设备、AR Foundation、AREngine，或其它利用Custom Camera的功能情形，在运行超过100秒后在日志中会看到这个错误，并且整个AR功能完全停止工作。重启应用之后可以恢复。
这是个人版EasyAR Sense的限制，使用付费版本的EasyAR Sense可以解决这个问题。
如果你已经在使用付费版的EasyAR Sense，可以忽略或直接从sample中删除相关文字。
开发（微信小程序）：申请插件使用失败¶
受微信本身限制，小程序插件不支持在微信开发者工具的“游客模式”下使用，也不支持在主体为个人的小程序上使用。请使用企业主体的微信小程序appid进行申请。
开发（微信小程序）：授权未通过¶
请从开发中心获取Mega小程序插件许可证，并检查你使用的AppId是否与许可证中的相同
开发（微信小程序）：哪些手机可以使用¶
Mega需要运动跟踪的能力，在微信小程序里面，这个能力由微信的VisionKit提供，系统要求和手机支持列表请参考 微信 VisionKit 内文档 的说明。 一般来说，需要支持V2平面AR接口的手机才能较好的支持Mega，只支持V1的手机效果会有大幅影响。
开发（微信小程序）：Cannot read property 'PhysSystem' of undefined¶
在微信开发者工具控制台下可能会看到提示“Cannot read property 'PhysSystem' of undefined”，这是因为微信的xr-frame不支持在IDE中运行。