Table of Contents

Mega localization service

Mega Block Cloud Localization Service provides online, real-time spatial positioning capabilities for device-side applications. When running your AR application on the device, after initializing the session, you need to obtain the initial camera pose through the cloud localization service. Subsequently, by combining the local device's motion tracking capabilities and coordinating with the cloud localization results, the device continuously updates real-time pose information to meet the application's requirements for higher robustness and more realistic AR experiences.

The cloud localization capability relies on real-time server-side computation. During the operation of the AR application, the device must maintain a network connection to obtain cloud-based positioning and pose calculation results. By default, the cloud localization computing center is deployed in Shanghai, China. If you have higher requirements for network latency or stability, or if your AR product operates in overseas markets, we support deploying server nodes through dedicated line acceleration or deploying cloud localization resources in nearby computing centers to further optimize overall performance and user experience.

Block data flow

The preparation work for Block cloud localization is divided into three steps:

  • Collect and upload data to complete Block mapping

  • Generate a Block storage repository

  • Add the required Blocks to the cloud localization database

flowchart LR  

A[Block mapping] --> B>Block storage] --> C[Add to cloud localization database]

After mapping is completed, the generated Block will be automatically stored in the bound Block storage repository. For detailed steps of each operation, please refer to the following documents:

Cloud localization data flow

  • The device uploads device motion tracking data and image data to the cloud localization service, which returns the localized camera pose results to the device.

  • The device performs real-time fusion and optimization of the camera pose to drive real-time rendering and interaction.

  • If annotation data is uploaded to the cloud localization library, the annotation data package will be downloaded to the device in the form of an EMA annotation file, enabling real-time rendering of 3D content at the annotated positions.

flowchart TB  

C[Cloud localization library] --> D[Device]  

D[Device] --> C[Cloud localization library]

Preparation before starting

  • Mega Block mapping has been completed
  • At least one available Mega Block repository
  • Ensure the target Mega Block is in this repository and in normal status
  • Prepare an APIKey with permissions for Mega Block
  • The device requires a Sense license or a WeChat Mini Program license (free trial available)
Note

To use the EasyAR Sense license on head-mounted devices, select the XR License Sense type

Quick start cloud localization

The configuration steps for the cloud localization service are as follows:

  • Purchase and create a cloud localization service group
  • Associate the service group with the mapping project
  • Create a cloud localization database in the service group
  • Add Mega Blocks to the cloud localization database

Reference topics:

Cloud positioning service group creation and purchase

This is a resource package required for cloud positioning. The default package includes:

Standard package item name Standard Trial
Projects for mapping tasks 1 1
Cloud positioning libraries 5 2
Request concurrency QPS 10 3
Note
  • As long as the request carries the AppId of the cloud positioning library, it will be counted in the concurrent QPS (regardless of whether the positioning is successful).
  • Cloud positioning libraries within the same cloud service group share QPS.

Standard package additional supplements

The standard package supports further purchases to expand beyond the specified usage limits:

  • Purchase additional cloud positioning databases
  • Increase task association quotas
  • Scale up request concurrency QPS
Note

For paid users, Mega Block map files will be retained for 3 months after expiration; if the files in the storage are still available, you can recreate the cloud positioning database and add maps for use.

Reference topics:

Quickly verify localization service

Mega supports quick verification after completing the cloud localization service configuration to ensure the service runs normally and the localization effect is as expected.

The following figure shows a relatively quick and simple verification example: using a prepared scene test photo in front of the computer, you can quickly verify the localization service by performing non-on-site localization on the photo. As shown in the figure, the green color of the Localize button indicates successful localization.

app-outsite-verift

  • Quick verification

    Mega Toolbox verifies the completion of the localization service configuration. It supports native apps, WeChat Mini Programs, or simulated verification in Unity, which can be divided into the following methods:

    • Quick verification based on Mega Toolbox (non-on-site)
    • Quick verification based on Mega Toolbox (on-site)
    • Quick verification based on Mega Studio simulation

  • Verify localization effect

    • First, annotate the Mega Block data in Mega Studio
    • Verify the localization effect on-site using Mega Toolbox

Quick verification reference topics: