Introduction to Liminal Development - LiminalVR/DeveloperWiki GitHub Wiki
Liminal is a platform allowing users to try a variety of virtual reality experiences created by developers from around the world. The platform consists of four main parts:
- Liminal App - The app that users install on their VR devices. The app helps users find and run Experiences
- Experiences - Self contained experiences that users can launch from within the Liminal App
- Liminal SDK - A Unity Plugin containing some core functionality and tools to help developers to build Experiences
- Liminal API - The back end for the platform. Developers can upload their Experiences to the API. Users of the Liminal App can then find and download them from within the Liminal App
Liminal supports multiple VR platforms. We currently support GearVR (including Oculus Go) and Google Daydream, and intend to announce support for new platforms in the future. The Liminal SDK allows Developers to easily build a single Experience that will work across all of these platforms, without having to worry about differences between input controllers and camera setup.
Experiences are created using the Unity game engine. Development of an Experience is very similar to a standalone Unity application, most art assets and scripts will work just fine with the Liminal SDK, though there are a few restrictions. During development, you can edit and run your scene in the Unity Editor in the normal way. When you are ready to share your Experience with other users, the tools in the Liminal SDK allow you to package your scene into a .limapp file that can be uploaded to the Liminal API.
At the heart of the Liminal SDK is VRAvatar
. This GameObject
represents the user of your Experience and contains child objects representing cameras, limbs and input devices for use in your Experience. The main camera is attached to VRAvatar > Head > CenterEye
.
The Liminal SDK provides an API for interacting with these objects. Further details can be found in the Liminal SDK API Documentation.
Additional tools needed to setup, work with and deploy your Experience are included in the SDK. These can be found within the Liminal menu in Unity Editor.
Instructions for getting started with your first Experience project can be found in this Quickstart Guide.