录制 EIF 数据：复现 AR 问题的高保真依据
在增强现实（AR）应用中，某些复杂的空间定位问题（如跟踪抖动、虚实错位、内容飘移等）往往难以仅通过录屏或日志完整还原。为此，我们提供了EIF数据录制功能———一种专有的高保真数据转储格式，可同步记录以下关键信息：
- 设备基本信息（型号、系统、SDK 版本等）
- 包含时间戳的摄像头图像帧
- 设备的相机内参矩阵、外参矩阵
- IMU 传感器数据
- 外部辅助输入的额外数据（如 GNSS）
为什么录制EIF数据至关重要？
重要事项
能够复现问题的 EIF 数据是无价的。
EIF 数据能够完整重现问题发生时的详细上下文，使开发团队在离线环境中精确复现用户所遇场景，极大提升问题定位效率。相比录屏或日志，EIF 具备以下优势：
- 精准复现：开发人员可在调试工具中直接回放EIF数据，重现您遇到的 Bug。
- 底层诊断：通过全面的分析各类数据（图像、传感器、外部输入等），开发人员可以判断问题出在技术的哪个环节。
- 节省时间：避免了漫长的沟通循环，大幅缩短从报告问题到解决问题的周期。
如何录制 EIF 数据
EasyAR 提供了两种 EIF 数据录制的方式。
- 直接使用 SDK 提供的 API 接口，在您的应用中实现 EIF 数据录制的功能。
- 使用官方提供的 Mega Toolbox App。通常适用于进行 EasyAR Mega 的开发和问题反馈。
具体操作步骤请参考我们的技术文档，获取针对您的使用方式以及设备的操作指南。
提示
访问以下链接查看调用 API 接口实现应用内录制 EIF 的功能：输入帧录制和模拟运行。
访问以下链接查看使用 Mega Toolbox App 的操作指南：使用 Toolbox 录制手机 EIF 文件。
简要录制流程概览（以 Mega Toolbox App 为例）：
- 打开 Mega Toolbox App，点击
现场验证与诊断工具。 - 登录您的账号，选择您的定位库，并开始测试。
- 尝试复现您的问题。找到一个可以稳定复现问题的操作模式（如设备朝向、浏览方式、拍摄点位等）。
- 一切准备就绪后，点击红色“录制”按钮开始录制。
- 问题出现后，点击红色“停止并保存”按钮。
- 系统将自动生成一个 EIF 文件，将设备连接电脑导出至本地存储后提交。
注意
EIF 文件可能较大（数百 MB 至数 GB），建议仅录制包含问题的核心片段（通常 10–30 秒足够）。
最佳实践建议
为确保您的反馈能被高效处理，请在提交时同时包含以下四类信息：
| 信息类型 | 说明 |
|---|---|
| EIF 数据文件 | 核心诊断依据，务必包含问题复现过程 |
| 主观现象描述 | 清晰说明您观察到的行为（如“导航箭头在向左转弯时突然跳到天花板”） |
| 录屏或截图 | 辅助可视化问题，直观地展示“用户最终看到的画面是怎样的” |
| 辅助上下文信息 | 包括： • 您的设备型号与操作系统版本 • 您的应用所使用的 EasyAR SDK 的版本号 • 问题产生的环境描述（室内/室外、光照、空间大小） • Mega 类应用需要额外提供定位库信息，可在 Unity 工具中导出 • CRS 云识别类应用需要额外提供云识别库的信息 |
提示
示例：“在 Apple Vision Pro（visionOS 26）上使用 EasyAR Sense Unity Plugin 4000.0.1，在室内商场进行导航，在某个位置导航路径突然发生错误。已录制 EIF 文件：avp_wrong_path_20251218.mkveif，附录屏、环境照片及定位库信息：MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json。”
通过提供上述完整信息包，您将显著加速问题分析与修复进程。感谢您的配合！