Skip to main content

Custom Location Connected Lens

Location Based Experience brings together Custom Location and the Spectacles Sync Kit to enable persistent, shared AR experiences tied to real-world environments. By pre-scanning a location, creators can deliver seamless multiplayer interactions without the need to restart the mapping flow each time the Lens is launched. New features like Guided Mode and Same Session Setup further simplify the experience, making development faster and more efficient.

Creating a Custom Location​

A detailed workflow for setting up a Custom Location can be found in the Custom Location documentation.

Currently this feature only supports one location. Custom Location Group is not supported.

Setting up Colocated World​

Once a Custom Location has been created in Lens Studio, go to Colocated World Scene Object and place Location asset into Located At component.

Creating a Location Mesh Visualization for Content Placement​

When using a Custom Location for a Connected Lens, the origin point (0, 0, 0) does not align with the device's position upon completing the mapping process. Instead, the origin is determined by the location where the map was originally generated in Spectacles. Including the Location Mesh in Lens Studio helps accurately visualize and position content within the scene.

  1. To create a Location Mesh and Location Material, click the “+” button in Lens Studio and select Location Mesh and Location Material from the options.

  1. In the Location Mesh asset, assign the Location asset to the Location input field.

  1. Create a Scene Object with a RenderMeshVisual component, then assign the Location Mesh and Location Material to their respective input fields.

  1. The Scene View should display the Location Mesh with Material applied.

The transform of the Location Mesh Scene Object should remain at its default position (0, 0, 0). Modifying the transform will result in misalignment within the Lens.

Was this page helpful?
Yes
No