Validation component

The validation component is used to simulate and verify Mega effects on PC.

Overview of interface when not running

If the validation tool is not opened in a separate window, the studio tool panel displays

If the validation tool is opened in a separate window, the studio tool panel displays

While the validation tool window displays

Overview of interface when running

If the validation tool is not opened in a separate window, the studio tool panel displays

If the validation tool is opened in a separate window, the validation tool window adjusts its display based on window size

Tool area description

1. Run control area
2. EIF playback area
3. Positioning control area
4. Display control area
5. Status information area

Run control area

1. Enable/disable validation tool
2. Start/stop validation tool
3. Open in separate window
4. Close tool in separate window
5. Select studio tool in separate tool window

EIF playback area

1. Play/pause
2. Stop
3. Forward 5s (available for new format data, except when recording abnormally stops)
4. Slow down playback (available for new format data)
5. Speed up playback (available for new format data)
6. Backward 5s (available for new format data, except when recording abnormally stops)
7. Open EIF file
8. Current time/total time
9. Current playback speed
10. Playback progress (draggable for new format data, except when recording abnormally stops)

Localization control panel

1. Localization status indicator
2. Start/stop localization (default enabled)
3. Reset tracking status
4. Service address selection (can only be modified when the tool is not running)

Localization status indicator color description

• Green: Positioned to Block and device VIO tracking successful displays green. If no new positioning result is received, it gradually fades to transparent within 5s;
• Yellow: Positioned to Block but device VIO tracking failed displays yellow. If no new positioning result is received, it gradually fades to transparent within 5s;
• White: Failed to locate Block displays white. If no new positioning result is received, it gradually fades to transparent within 5s;
• Red: Localization error displays red. Maintains display until the next positioning result returns;

Display control panel

1. Show/hide video background
2. Show/hide annotation data
3. Show/hide Block model (will simultaneously hide models in Scene window under URP)
4. Show/hide button labels
5. Control Block model transparency (unavailable under URP)

Block model transparency effect shown below

Status information panel

1. Per-frame updated session status
2. Localization results returned by server (related to tracking effect but not all tracking results)
3. Copy
4. Copy
5. Whether to display dump information in Game View

Usage process

Prepare EIF data

Validation requires EIF data. Please use the remote development simulation positioning EIF test data recording tool in Mega Toolbox to record EIF files. Depending on the selected recording format, the recording results will save .mkveif files (or .eif files and .eif.json files—both are essential).

Prepare package

Ensure com.easyar.sense is imported. If not imported, the following message will appear:

Use Unity Package Manager to import the required package: com.easyar.sense-**.tgz.

Fill in EasyAR Sense license key

Log in to the EasyAR development center website to obtain the EasyAR Sense License Key.

Open Unity menu: EasyAR > Sense > Configuration

In the Project Settings window, paste the license key copied from the website.

Connect to Mega localization service
After adding the tool, select the required localization service to validate in the corresponding tool.

Prepare Block data (optional)

To visually observe positioning effects, loading corresponding area’s Block model data is recommended. Refer to the Block data component documentation for loading instructions.

Prepare annotation data (optional)

To display annotations during positioning, use the annotation component for labeling or import annotations via the annotation data package component.

If both Block and annotation data are imported, they will appear in the scene.

Prepare 3D content (optional)

Create 3D objects via the context menu. Note: 3D objects must be placed under Block nodes.

After creation, adjust position, scale, etc., as needed.

You may also import custom models.

Launch the tool

First enable the tool, then click the play button to start.

Alternatively, launch via Unity toolbar buttons.

A prompt will appear upon launch. Read carefully if developing Unity applications.

Open EIF

EIF playback starts automatically after opening.

View effect

Control playback as needed. Typical results appear as follows:

You may hide Block models completely to mimic real-scene visuals:

Stop runtime and restore application

Stop runtime via tool buttons:

Or stop via Unity toolbar buttons:

When developing custom applications, disable the validation tool before running your program in the editor (editor-only; doesn’t affect mobile).

Display effect and Unity usage suggestions

Adjust Game window size

It is recommended to set the window size consistent with the EIF video frame size. Generally, a fixed size roughly equivalent to 1080P is suggested, such as 1080x1920 (1920x1080 in landscape orientation).

If the window size has a significant difference from the EIF video frame, the complete video image cannot be viewed, and the tool will also display a warning message.

Adjust scene lighting

To better observe rendering effects, you can add and adjust lighting as needed. If there are no special requirements for Unity lighting, you can let Unity automatically generate ambient light.

Simultaneously display Scene window and Game window

Sometimes it is necessary to view the contents of both the Scene window and the Game window simultaneously. In such cases, you can adjust the default Unity window layout and reposition the Scene window and Game window according to your needs.

Notes for Unity development

ARSession

When the tool starts, it automatically creates an ARSession and other necessary EasyAR components. If an ARSession already exists (active) in the scene, the tool will disable the original ARSession. However, dynamically created sessions will not be controlled and will cause errors if running.

Main Camera

During runtime, the tool modifies the main camera's Clear Flags and Background. Clear Flags will be changed to Solid Color. Background will be changed to black. These modifications will not be saved.

Center mode

All supported center modes can be used when the tool is running. First Target center mode is typically recommended.