World Locking Tools for Unity - Samples
A collection of extended samples of the use of World Locking Tools for Unity. This release is limited to samples running on the HoloLens family of devices.
Release v1.0.1 updates to latest available versions of all dependencies:
World Locking Tools for Unity v1.0.0
FrozenWorld Engine v1.0.0
QR Lib v0.5.2102
NuGet for Unity v2.01
About World Locking Tools - Samples
This samples repo is distinct from the main World Locking Tools repo primarily for one reason: To allow individual sample projects to be in as close to the minimal state to build and run as possible.
For example, the QR Space Pins for HoloLens sample automatically places SpacePins on scanning QR codes in the physical environment. Naturally, it leverages the HoloLens QR Scanning library. By putting it in its own project, that library dependency can be explicitly contained in the downloaded project, without also injecting that dependency into other samples which don't use QR codes at all.
The end result is that samples in this repo are standalone independent, and ready to run once the bits are copied locally. (Generally switching the Platform appropriately in the Build Settings is also required.)
Further discussion of the philosophy and organization behind these samples can be found in the documentation.
Getting started
Because the project configurations is generally a significant part of the sample, it is best to download the entire project of interest. Therefore, no .unitypackages, for installation into an existing project, are provided. Downloading via a git clone versus from zip file is purely a matter of your preference. The branch corresponding to this release snapshot is release/v1.0.0.
Useful documentation links
- Home page for WLT-Samples documentation
- Introduction and organization
- Contributing
- World Locking Tools for Unity - main repo
Contributing
You are encouraged to contribute using the guidelines described here. All feedback, comments, and observations are gratefully received.
Compatibility
The samples included in this snapshot are built against the following:
Visual Studio 2019 v16.6.5
Unity 2019.4.2f1
MRTK v2.4.0
Note that MRTK is utilized heavily for UX for the sample applications, but World Locking Tools has no direct dependency on MRTK. The other dependencies are light, and any issues from a different version of VS or Unity (pre U2020) should be minor.