Table of Contents

Mini program running effect

When your project is not yet completed or you need to verify the positioning effect before formal development, you can quickly preview the positioning effect in real scenarios through Mega Toolbox (WeChat Mini Program). This helps you check the positioning accuracy and stability, ensuring that the positioning service meets the project requirements.

Steps to view the effect

Before viewing the actual running effect, please ensure that your WeChat device is ready, you have access to the WeChat Mini Program, and the location service is properly configured.

Scan the Toolbox WeChat Mini Program QR Code

Before performing the effect verification, you need to scan the Mini Program QR code via WeChat to enter the Mega Toolbox application.

Mega Toolbox WeChat Mini Program

Log in to EasyAR account

The first step to view the real running effect is to log in to your EasyAR account in the mini program.

Toolbox login

Select positioning library and annotation data

After completing the account login, you need to select the corresponding positioning service and annotation data resources, which are key steps to achieve precise positioning. Note: Annotation data must be selected to preview the real running effect. If the current project has no annotation data, please create annotation data first.

Follow these steps to select the corresponding services and data:

  1. Select Cloud positioning service group, click and choose from the dropdown.
  2. Select the corresponding Cloud positioning library, click and choose from the dropdown.
  3. Select the corresponding Annotation data, click and choose from the dropdown. (If there is no annotation data, please refer to: Create annotation data)
  4. Click Start.

Select positioning library and annotation data

To use the localization feature normally, you need to authorize the camera and location permissions before you can use it properly.

Authorize related permissions Authorize related permissions

View the on-site effect

Video demo:

Note

For a better visual experience, you can turn off debug information to view the positioning visual effect of the annotation content more intuitively.

Status judgment instructions:

You can judge the current positioning status through the following three key indicators:

  • Annotation cube status: Displays a white MEGA texture when positioning is normal, and gray when positioning fails.
  • Parameters in the debug information return box:
    • status value: Displays the current positioning status.
    • Sequence parameter: N means not loaded, F means positioning failed, S means positioning succeeded.
    • Status button: Green indicates successful positioning, white indicates positioning failure.

The mini-program will display the status based on the service's return information to help you understand the operation of the positioning service:

  • Positioning success status: If you are at the on-site location, the positioning debug information displays the status: Found text prompt, the Status button turns green, the Sequence parameter displays S, and the annotated cube displays the white MEGA texture normally, indicating that the positioning service has successfully located the target.

    View the positioning success effect

  • Concurrency warning: If the positioning debug information displays the status: QpsLimitExceeded text prompt, the Status button turns white, and the Sequence parameter displays F, it means the positioning service is running normally, but the current QPS exceeds the limit. To resolve this issue, please refer to Positioning service capacity exceeded and expansion.

    Concurrency warning

  • Target not found status: If you are not at the on-site location or there is no matching scene in the positioning library, the positioning debug information will display status: Not Found, the Status button turns white, the Sequence parameter displays F, indicating that the positioning service is running normally but failed to locate the target.

    View the target not found effect

  • Positioning service abnormal: The positioning debug information displays the UnKnownError text prompt, indicating that the positioning service is running abnormally. Please enable record logs and record data, record the error information, and contact EasyAR customer service.