Table of Contents

Recording EIF data: High-Fidelity Evidence for Reproducing AR Issues

In augmented reality (AR) applications, certain complex spatial positioning issues (such as tracking jitter, virtual-real misalignment, content drift, etc.) are often difficult to fully reproduce using screen recordings or logs alone. To address this, we provide the EIF data recording feature—a proprietary high-fidelity data dump format that synchronously records the following key information:

  • Basic device information (model, OS, SDK version, etc.)
  • Timestamped camera image frames
  • The device's camera intrinsic and extrinsic matrices
  • IMU sensor data
  • Additional data from external auxiliary inputs (e.g., GNSS)

Why recording EIF data is crucial

Important

Reproducible EIF data is invaluable.

EIF data captures the complete context of an issue, enabling developers to precisely replicate the user's scenario in an offline environment, significantly improving problem-solving efficiency. Compared to screen recordings or logs, EIF offers the following advantages:

  1. Accurate reproduction: Developers can directly replay EIF data in debugging tools to recreate the bug you encountered.
  2. Deep diagnostics: By analyzing comprehensive data (e.g., images, sensors, external inputs), developers can pinpoint the root cause in the technical workflow.
  3. Time-saving: Eliminates lengthy communication loops, drastically reducing the time from issue reporting to resolution.

How to record EIF data

EasyAR provides two methods for recording EIF data.

  1. Directly use the API interfaces provided by the SDK to implement EIF data recording functionality within your application.
  2. Use the official Mega Toolbox App. This is typically suitable for EasyAR Mega development and issue feedback.

For specific operation steps, please refer to our technical documentation to obtain guidance tailored to your usage method and device.

Tip

Visit the following link to view how to implement in-app EIF recording using API interfaces: Input frame recording and simulation run.

Visit the following link to view the operation guide for using the Mega Toolbox App: Recording mobile EIF files using Toolbox.

Brief recording process overview (using Mega Toolbox App as an example):

  1. Open the Mega Toolbox App, click "On-site localization test & localization issue feedback data recording".
  2. Log in to your account, select your localization library, and start testing.
  3. Attempt to reproduce your issue. Find a stable pattern to reproduce the issue (such as device orientation, scanning method, shooting positions, etc.).
  4. Once everything is ready, click the red "Record" button to start recording.
  5. After the issue occurs, click the red "Stop and save" button.
  6. The system will automatically generate an EIF file. Connect the device to a computer, export it to local storage, and submit it.
Note

EIF files can be large (hundreds of MB to several GB). It is recommended to record only the core segment containing the issue (typically 10–30 seconds is sufficient).

Best practice recommendations

To ensure efficient processing of your feedback, include all four types of information simultaneously when submitting:

Information Type Description
EIF Data File Core diagnostic evidence. Must include reproduction steps.
Subjective Phenomenon Description Clearly describe observed behavior (e.g., "Navigation arrow suddenly jumped to the ceiling during left turn").
Screen Recording or Screenshot Visually demonstrate "what the end-user sees".
Auxiliary Context Information Includes:
• Device model & OS version
• EasyAR SDK version used by your app
• Environment details (indoor/outdoor, lighting, space size)
• Mega-type apps require additional positioning library info (exportable via Unity tool)
• CRS Cloud Recognition-type apps require cloud recognition library details
Tip

Example: "On Apple Vision Pro (visionOS 26) with EasyAR Sense Unity Plugin 4000.0.1, navigation path suddenly became incorrect at a specific location in an indoor mall. Recorded EIF: avp_wrong_path_20251218.mkveif. Attached screen recording, environment photos & positioning library info: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

Providing this complete information package significantly accelerates issue analysis and resolution. Thank you for your cooperation!