Table of Contents

Recording EIF data: High-fidelity evidence for reproducing AR issues

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

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

Why recording EIF data is critical

Important

Reproducible EIF data is invaluable.

EIF data can fully reconstruct the detailed context when an issue occurs, enabling the development team to precisely reproduce the user's scenario in an offline environment, significantly improving issue diagnosis 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 reproduce the bug you encountered.
  2. Deep diagnostics: By comprehensively analyzing various data types (images, sensors, external inputs, etc.), developers can pinpoint the problematic technical component.
  3. Time savings: Avoids lengthy communication cycles, drastically shortening 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 within your application.
  2. Use the official Mega Toolbox App. Typically suitable for EasyAR Mega development and issue reporting.

Refer to our technical documentation for specific step-by-step instructions tailored to your usage scenario and device.

Tip

Visit the following link to learn about implementing in-app EIF recording using API interfaces: Input frame recording and simulation.

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

Brief recording 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 map, and start testing.
  3. Attempt to reproduce your issue. Find a stable pattern to reproduce the problem (e.g., device orientation, browsing method, shooting points).
  4. Once 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 your feedback is processed efficiently, please include the following four types of information when submitting:

Information type Description
EIF data file Core diagnostic evidence. Must include the issue reproduction process.
Subjective phenomenon description Clearly describe the behavior you observed (e.g., "The navigation arrow suddenly jumped to the ceiling when turning left").
Screen recording or screenshot Aids in visualizing the issue, showing "what the user ultimately saw".
Auxiliary context information Includes:
• Your device model and OS version
• Version number of the EasyAR SDK used in your application
• Description of the environment where the issue occurred (indoor/outdoor, lighting, space size)
• For Mega-type applications, additionally provide localization map information (exportable via Unity tools)
• For CRS cloud recognition applications, additionally provide cloud recognition map information
Tip

Example: "Using EasyAR Sense Unity Plugin 4000.0.1 on Apple Vision Pro (visionOS 26) for indoor mall navigation. Navigation path suddenly became incorrect at a specific location. EIF file recorded: avp_wrong_path_20251218.mkveif. Attached screen recording, environment photos, and localization map info: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

By providing this complete information package, you will significantly accelerate the issue analysis and resolution process. Thank you for your cooperation!