HoloPlay Unity Plugin
(updated March 11 2021, v1.4.0)
The HoloPlay Unity Plugin helps you build 3D experiences for your Looking Glass. If you're just getting started, please consult the setup guide.
Note that our Unity plugin currently does not support URP or HDRP.
The best way to learn about all of the Plugin's features is to consult the example scenes. The eight example scenes cover the following functionality:
- Displaying 3D Unity content in the Looking Glass
- Placing text within the Looking Glass, and how it blurs when moved from the primary focal plance
- The importance of post-processing in creating a pleasant visual scene and in blurring artifacts
- Working with the 3D cursor
- Using buttons on non-Portrait Looking Glass devices
- Rendering to multiple connected Looking Glasses (Unity 2018 and 2019 only)
- Multi-monitor application implementation
- Recording content from the Unity editor or a build
Running Linux Builds
Beginning with version 1.3.0 of the Unity plugin, we have supported Linux!
However, due to some complications around Unity's window management system, when running builds on Linux it's necessary to launch them from the command line with the "-adapter" parameter set to the index of your Looking Glass display, as in the following example:
YourApp.x86_64 -adapter 2
The above sets your app to run on your second display, which, typically, is the index of your Looking Glass.
Additionally, in version 1.4.0 of the plugin, there is no support for video recording with Linux. There is a missing dependency to enable this, FFmpeg, which we are aiming to include for Linux users in the future.
In Unity, it's typical for plugins to come with prefabs to accelerate development. The HoloPlay Unity Plugin follows this model and offers a handful of prefabs in Assets/Holoplay/Prefabs. To understand how these work, consult the prefab docs.
More advanced developers may want to know more about how the scripts work. The following pages document the public fields and functions of all the important scripts in the Plugin.
Adding a Leap Motion
Lastly, if you'd like to develop on the Looking Glass with a Leap Motion, you can consult our Leap Motion integration guide.
Building experiences for the Looking Glass can be challenging because it's such a new medium. To make sure your demos really pop, take a look at our Design Guidelines.
If you are experiencing any issues, please let us know on our Github issues page.