Release notes
This release is backward compatible with WLT v1.3.5. It is recommended that you uninstall/delete your previous WLT installation before installing this release.
Release v1.4.0 of World Locking Tools for Unity (WLT) includes optional support for leveraging Azure Spatial Anchors (ASA) for persisting the global coordinate space across sessions, and sharing the global coordinate space across devices. See the documentation for details on the integration, and instructions on getting started.
Use of ASA remains optional. If ASA is not installed, all dependent scripts will still compile, but will not perform their intended function (mostly just throwing a not implemented exception). ASA must be installed separately, as explained in the setup instructions.
The WLT+ASA combination is supported on HoloLens, HoloLens2, Android, and iOS. See the ASA documentation for the most up to date information. WLT+ASA has been tested on ASA v2.9.0 and v2.10.0-preview1.
While the ASA integration is the most exciting feature of this release, it is by no means the only significant step.
Highlights include:
- Support for AR Foundation setups.
- A configuration menu item, including links to documentation.
- Update WLT Samples to use MRTK v2.7.2.
- Extensive documentation improvements.
- Improved compatibility with MR Feature Tool.
Getting started
Installation is supported either from .unitypackage files (see links below), or via the Mixed Reality Feature Tool.
.unitypackage
Minimal installation is just the CoreEngine package. Each package depends on all preceding packages, in the following order:
- CoreEngine
- Tools
- Examples_wMRTK
- ASA_wExamples
When installing the ASA_wExamples .unitypackage, deselect the WorldLocking.ASA.Examples entry (and all of its children) if you only want to import the functionality, and not the example assets. Note that if the ASA.Examples are not imported, then Examples_wMRTK is no longer required.
MR Feature Tool
Dependencies are handled automatically. If not using ASA, just install the WLT Core for basic functionality, or WLT Samples (which will also bring in WLT Core) for sample scenes. If installing the samples, pay attention to the note on installing samples using MR Feature Tool.
If using ASA, select the WLT-ASA or WLT-ASA Samples package. The same notes about installing samples using the MR Feature Tool apply. Additionally, the WLT Samples must not only be installed via the MR Feature Tool, but must also be imported in the Unity Package Manager.
NOTE: If installing via MR Feature Tool, please see this note on path length limit!