Skip to main content

How to Manage Test Scans

A test scan is a private location that contains a single mesh for developing and testing VPS experiences. Any test scans you create are only available to your developer account. Test scans are useful for developing and testing VPS experiences while a Public Location is not yet activated. Due to performance issues, they are not supported for use in published projects.

Test scans are created using the Niantic Wayfarer app. Ensure you’re logged in to Wayfarer using your Lightship credentials. For more information about using the Wayfarer app, see How to Install and Use Niantic Wayfarer.

Scanning a Mesh

  1. In the Wayfarer app, select Scan and take a scan of the area. Test scans should be 60 seconds or less; a new mesh is generated every 60 seconds, so scanning for 120 seconds will result in 2 test scans. All test scans are unaligned.

  2. Once processed, you can preview the mesh and add it to your project from the Geospatial Browser Test Scans tab (located in the Locations section at the bottom).

    List of test scans
  3. If your test scan fails processing, you may need to rescan. Reach out to support@lightship.dev for more information.

Downloading Meshes

You can download a mesh for your Private VPS Location that you can use for development purposes in your Unity project.

Meshes are only available for successfully Processed Private VPS Locations. To download a mesh, select the location and click the Download Mesh button.

Mesh download button

When you download a mesh, you will receive a zip file that contains mesh data in FBX format and a .json file that contains the origin anchor for the mesh. You can use this file for previewing anchored content in Unity and it can be used with the VPS Authoring Assistant. See Adding a Real-World Location to Unity for more information.

tip

Instead of unzipping the file, use the VPS Authoring Assistant in Unity and drag the file directly into your Unity project.

note

The origin anchor is generated each time you download the private mesh zipfile, however previously downloaded anchors for the same mesh are still valid and can still be used as long as the test scan is still valid.

When placing your virtual content in Unity, you can import the zip file to help you position it relative to the mesh. When running on your device, localize to your Private VPS Location, restore the origin anchor, then position your virtual content relative to the origin anchor.