Table of Contents

Acquiring simulation run data

During the development and debugging of Mega applications, repeated testing in real environments is not only time-consuming but also constrained by location, equipment, and network conditions. To address this, EasyAR provides a powerful simulation mechanism centered around EIF data files.

This guide will walk you through acquiring and playing back EIF data to achieve efficient feature validation, issue troubleshooting, and effect previewing.

Core concept: what is EIF data?

Before starting, it's highly recommended to read Introduction to EIF to understand:

  • EIF file content: It's a data container that includes not only camera video streams but also synchronously recorded sensor data, device poses, camera parameters, etc.
  • Recording and playback mechanism: By recording an EIF file once in a real environment, you can replay it infinitely in development environments, perfectly reproducing the original scenario.

Understanding EIF as a "digital replica" enabling "record once, play anywhere" will significantly boost your development efficiency.

Acquiring EIF data: methods and process

Capturing high-quality EIF data is the first step to successful simulation. Follow the basic principles in Acquiring EIF data to ensure data validity.

Based on your target device, EIF acquisition methods are as follows:

  • Smartphones
    Tool: Use the Mega Toolbox App. This auxiliary application designed for mobile simplifies the recording process.
    Reference: Detailed steps are available in Recording EIF files on mobile devices.
  • XR headset devices
    Tool: Use the Sample program. The sample project for headsets integrates EIF recording functionality.
    Reference: Detailed steps are available in Recording EIF files on headsets.

Playing back EIF data: verification and debugging

After acquiring EIF files, you can play them back in development environments without connecting physical devices or being on-site.

Based on your development environment, EIF playback methods are as follows:

  • Unity development
    Tool: Use the session verification tool. Integrated into the Mega ARSession, this tool directly loads EIF files and simulates Mega localization sessions.
    Reference: Specific usage instructions are in Simulating runs using the session verification tool.
  • WeChat Mini Program development
    Tool: Utilize the Unity editor. Due to limitations in the WeChat Mini Program development environment, replaying EIF data in the Unity editor is recommended for content and logic validation.
    Reference: Specific usage instructions are in Simulating runs in the Unity editor.

In summary, mastering EIF data acquisition and playback is essential for efficiently developing EasyAR Mega applications. It transforms the development workflow from "on-site debugging" to "offline analysis," significantly shortening development cycles and simplifying team collaboration and issue reproduction.