Validation component

Version requirement: >= 2.10 (For older versions, please read Validation tool (deprecated version))

Overview of the interface when not running

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

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

And the validation tool window will display

Overview of the interface when running

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

If the validation tool is opened in a separate window, the validation tool window will adjust the display according to the 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 a separate window
4. Close the tool in the separate window
5. Select studio tool in the separate tool window

EIF playback area

1. Play/pause
2. Stop
3. Forward 5s (available for new format data, except for abnormal recording 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 for abnormal recording stops)
7. Open EIF file
8. Current time/total time
9. Current playback speed
10. Playback progress (draggable for new format data, except for abnormal recording stops)

Positioning control area

1. Positioning status indicator
2. Start/stop positioning (enabled by default)
3. Reset tracking status
4. Result stabilizer switch (when turned on, it shows normal operation. It should only be turned off when analyzing specific issues.)
5. Service address selection (can only be modified when the tool is not running)

Positioning status indicator color descriptions

• Green: Block is located and device VIO tracking is successful, displayed in green. If no new positioning result is received, it will fade to transparent within 5 seconds.
• Yellow: Block is located but device VIO tracking fails, displayed in yellow. If no new positioning result is received, it will fade to transparent within 5 seconds.
• White: Block cannot be located, displayed in white. If no new positioning result is received, it will fade to transparent within 5 seconds.
• Red: Positioning error, displayed in red. It remains displayed until the next positioning result is returned.

Display control area

1. Show/hide video background
2. Show/hide annotation data
3. Show/hide Block model (in URP, the model in the Scene window will also be hidden)
4. Show/hide button names
5. Control Block model transparency (not available in URP)

Block model transparency transformation effect is as follows

Status information area

1. Session status updated per frame
2. Positioning results returned by the server (related to tracking performance but not all tracking results)
3. Copy
4. Copy
5. Whether to display dump information in the Game View

Usage process

Preparing eif data

To validate the effect, EIF data is required. Please use the remote development simulation positioning EIF test data recording tool within Mega Toolbox to record the EIF file. Depending on the selected recording format, the recording results will save either a .mkveif file (or both a .eif file and a .eif.json file - both are indispensable).

Prepare package

Make sure com.easyar.sense has been imported. If not, you will see the following message,

At this time, you need to use the Unity Package Manager to import the required package: com.easyar.sense-**.tgz.

Fill in the EasyAR Sense License Key

Log in to the EasyAR Developer Center on the web to obtain the EasyAR Sense License Key.

Open EasyAR > Sense > Configuration in the Unity menu.

Then fill in the license key copied from the website in the opened Project Settings window.

Connect to Mega localization service After adding the tool, you need to select the localization service to be verified in the corresponding tool.

Prepare block data (optional)

For an intuitive view of the positioning effect, it is generally recommended to load the corresponding block model data. Please refer to the instructions of the block data component for loading.

Prepare annotation data (optional)

If you need to display annotation data during localization, you can use the annotation component to annotate or import annotations through the annotation data package component.

If both the Block and annotation data have been imported into the scene at this time, they will be displayed in the scene.

Prepare 3D content (optional)

You can create 3D objects through the mail menu. Note that 3D objects need to be placed under the Block node.

After creation, you can adjust the position, size, etc., as needed.

Of course, you can also import your own models.

Start the tool

First enable the tool, then click the run button to start,

You can also start it via the button on the Unity toolbar,

A prompt pop-up will appear after starting. If you are developing a Unity application, please read it carefully,

Open EIF

After opening the EIF, it will automatically start playing.

View the effect

You can control playback as needed, and the effect will usually look like this,

You can also completely hide the Block model, so the effect is consistent with what you see in the real scene,

Stop running and application recovery

Stop running via the tool button,

or you can also stop running via the button on the Unity toolbar,

If you need to develop your own application and want to run your program in the editor, don't forget to disable the validation tool (only effective in the editor, it does not affect the mobile phone effect),

Display effects and Unity usage suggestions

Adjust the Game window size

The window size is recommended to be consistent with the EIF video frame size. Generally, it is recommended to use a fixed size roughly equivalent to 1080P, such as 1080x1920 (landscape 1920x1080).

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

Adjust the scene lighting

For better observation of the rendering effect, 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.

Display the Scene window and Game window simultaneously

Sometimes it is necessary to view the contents of both the Scene window and the Game window at the same time. In this case, you can adjust the default Unity window layout and reposition the Scene window and Game window as needed.

Notes for Unity development

ARSession

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

Main Camera

During runtime, the tool will modify 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. Typically, the First Target center mode is recommended.