Mega 常见问题
在开发过程中遇到问题是在所难免的。本篇旨在帮助您快速定位并解决常见的问题。我们首先从一个常见问题列表（FAQ）开始，如果您在这里找不到答案，请参考后续章节或向我们提交问题报告。
常见问题解答 (FAQ)
以下是一些开发者在集成和使用 EasyAR Mega 时最常遇到的问题及其解决方案。
Q：为什么我的应用提示 Invalid Key？
A：这通常由以下几个原因导致：
- License 无效或过期
- License 与 Bundle ID / Package Name 不匹配
- 头显设备需要单独的 XR License
- 自定义相机功能需要正式版 License
Q：为什么我的应用上有水印？
A：这说明您使用的 License 是试用版而非正式版。
Q：为什么我的应用上有一行倒计时提示（timeout within * seconds）？
A：这是试用产品期间的限制，使用正式版本的 EasyAR Sense 授权和正式版 EasyAR Mega 服务可以解决这个问题。
Q：为什么我的应用打开是黑屏？
A：这种情况通常会在屏幕信息或日志中打出错误原因，您可根据系统打印出的具体原因进行解决。如果无法解决，请反馈技术信息（包括日志、截图、详细的设备信息等）。
Q：为什么我的应用无法定位，返回状态一直是 NotFound？
A：这通常由以下几个原因导致：
- 定位服务还在启动过程中：
此时定位服务尚未完全加载完毕所有 Mega 地图，因此无法保证在某个区域能定位成功。 - 不在地图覆盖范围内：
确保您当前所处的物理位置，位于您所加载的 Mega 地图的覆盖区域内。 - 模拟测试配置错误：
不在现场运行，但MegaLocationInputMode错误设置为了Onsite。 - 环境条件不佳：
极端的光线（过暗或过亮）、大面积的纯色墙面或地面（如白墙、抛光地板）都会影响视觉定位。
Q：为什么我的应用无法定位，返回状态异常？
A：这通常由以下几个原因导致：
- 请求超时：
此时系统会返回RequestTimeout。 - 请求间隔过短：
此时系统会返回RequestIntervalTooLow。 - 其他异常错误：
此时系统会返回UnknownError。一般情况此类异常对应了连接或传输过程中的失败，或 Mega 服务本身出现了错误。可以通过MegaBlockLocalizationResponse.ErrorMessage接口获取详细信息。
Q：为什么我的小程序申请插件使用失败？
A：这是由于小程序插件不支持在微信开发者工具的“游客模式”下使用，也不支持在主体为个人的小程序上使用。请使用企业主体的微信小程序 AppId 进行申请。
Q：为什么我的小程序授权未通过？
A：您需要从开发中心获取 Mega 小程序插件许可证，并确保您使用的 AppId 与许可证中的相同。
Q：为什么我的小程序在 XX 手机上无法使用？
A：在小程序上集成 Mega 依赖微信的 VisionKit 组件，其系统要求以及设备支持列表参考 微信文档。
Q：定位成功了，但虚拟内容的位置看起来有偏差或飘移？
A：涉及定位效果的问题其原因往往比较复杂，可能的原因如下：
- 建图精度问题：
该区域的 Mega 地图本身可能存在精度误差。这通常发生在地图采集或重建阶段，请联系商务确认。 - 初始化时的跳动：
在定位刚开始的几秒钟，位置可能会有轻微跳动。这是由于设备的 SLAM 系统尚未完成初始化导致，在微信小程序中这个过程尤其明显（部分设备甚至会时间比较长）。 - 环境动态变化：
如果物理环境发生了显著变化（如移动了大型布置、增加了临时展板），可能会导致地图与现实不匹配。这种情况需要更新地图。 - 设备系统误差：
大多数设备设备在长时间连续运行后，其 SLAM 系统的累积误差会导致飘移。 - 定位误差问题：
视觉定位本身存在精度误差，通常这种误差不影响虚拟内容的视觉体验。如果误差大到有明显偏差或飘移，则需要详细的数据才能进行分析和解决。参考 问题诊断和报告 中介绍的方法进行数据收集和反馈。
Q：如何采集和使用 EIF 数据进行调试？
A：EIF 数据是强大的调试工具。请参考以下章节：
- 如何采集：阅读 采集模拟运行数据，了解如何在手机或头显上录制 EIF 文件。
- 如何回放：根据您的开发环境（Unity 或微信小程序），参考该章节中对应的回放指南。
寻找更具体的帮助
如果以上 FAQ 未能解决您的问题，您可以访问以下专题页面，获取更深入的解决方案：
- 内容不显示 - 专注于内容渲染的疑难杂症。
- 内容跳动和飘移 - 深入分析内容的跳动和飘移。
- 微信小程序集成已知问题 - 针对小程序平台的特殊问题汇总。
报告一个新问题
如果您遇到了以上未涵盖的、疑似 SDK 或平台本身的问题，请帮助我们改进产品。详细的操作步骤或指引，可参考阅读：问题报告。
在提交报告前，确保您已准备好以下信息，这将极大地帮助我们解决问题：
- 问题描述：清晰地描述您遇到的问题现象、发生频率和操作步骤。
- 设备信息：设备型号、操作系统版本、EasyAR SDK 版本。
- EIF 数据：请务必提供能够复现问题的 EIF 录制文件。这是最重要的诊断依据。
- 日志文件：应用的完整日志（Logcat 或 Console 输出）。
- 录屏或截图：问题发生时的屏幕录像或截图。
请将以上信息通过 论坛、邮箱或商务 提交给我们。感谢您的反馈！