Simulate running AR projects using Mega capabilities with the session validation tool
This article aims to guide developers on how to use the session validation tool in the Unity editor to load recorded EIF data and simulate running AR projects that utilize Mega capabilities.
Before you begin
- Complete the Quickstart to learn how to run a Unity application with Mega features.
- Understand what EIF is.
- Learn how to collect simulation run data.
Why using the session validation tool for simulation is a good approach
Remote development: No need to work on-site under scorching sun or freezing cold. With EIF data, you can develop large-scale geospatial AR applications right from your office.
Cross-platform debugging: Avoid frequently connecting various mobile devices. Simulate the positioning and tracking effects of different terminals like smartphones and headsets on a Windows PC.
The "gold standard" for issue reporting: An EIF file that can reproduce anomalies is the key evidence for the EasyAR team to resolve your positioning and tracking issues.
Note
Although EIF data is recorded with high precision, there may still be differences between the simulation and actual usage effects.
Additionally, simulation data has limited coverage of real-world conditions, so field testing is essential before final release.
Operation steps
Simulate the run using the session validation tool through the following steps.
Prepare the on-site recorded EIF file
Depending on the selected recording format, the recorded EIF data should be a .mkveif file (or both .eif and .eif.json files, which are indispensable).
.eif and .eif.json:
.mkveif:
Place some 3D content against the block dense model or panoramic placement
Enable the session verification tool
Click on AR Session (EasyAR) in the scene > confirm that the Frame Player in its Inspector panel is enabled.
Run
Click the toolbar button or the run button on the Session Validation Tool to start running this project in the Unity editor.
A pop-up will appear after running, this is normal, it just indicates that the Frame Player is currently being used.
Click the button on the tool to open the EIF file.
After opening normally, it will automatically play. You can use the toolbar to pause/resume, etc. Some newer EIF formats also support progress bar skipping.
Running effect:
If the Block dense model is loaded in the tool EasyAR.Mega.BlockViewer (Dev), the Block dense model will also remain displayed. This is useful when comparing positions or checking the positioning effect in areas where the model is not placed.
Generally, you can close the tool EasyAR.Mega.BlockViewer (Dev) (set active to false or delete the scene node), and then what you see when running is the effect of virtual objects superimposed on the real scene.
Important
When using it, you will definitely notice the diagnostic information text displayed on the screen or in front of your eyes during runtime. Carefully read UI message output, and carefully consider what configuration should be adopted during the development stage, testing stage, and after the application is launched, as well as what control switches should be retained. Communication with EasyAR often requires providing this information. It is recommended to make good use of it rather than immediately turning it off.
By default, after startup, before the first Block is located, the active of the entire MegaBlocks and its child nodes is false, and the content will not be displayed.
After locating, the active of the above nodes will become true, and the content will be displayed and continuously updated in position.
If you want to change the related behavior or have more flexible control over the active behavior, you can refer to BlockRootController component reference and BlockController component reference.