Oculus Unity Getting Started Guide

This guide describes initial setup, importing the optional Utilities for Unity package, and building Oculus apps using Unity’s first-party support.

Free and Professional versions of Unity Editor 5.1 or later support Rift and Gear VR development out of the box. VR support is enabled by simply checking a checkbox in Player Settings.

Utilities for Unity

To supplement Unity’s built-in support, Oculus offers an optional Utilities for Unity package which includes scripts, prefabs, and other resources. The package includes an interface for controlling VR camera behavior, a first-person control prefab, a unified input API for controllers, advanced rendering features, object-grabbing and haptics scripts for Touch, debugging tools, and more.

Samples

The Oculus Unity Sample Framework includes sample scenes and scripts illustrating common VR features such as locomotion, in-app media players, crosshairs, UI, interaction with Game Objects with Oculus Touch, and more.

Getting Started

If you are just getting started as a Unity developer, we recommend spending time learning the basics with Unity’s excellent Documentation and Tutorials.

Our Oculus Unity Getting Started Guide runs through environment setup, orientation, frequently asked questions, and basic steps necessary for creating Oculus applications in Unity.

Run through our simple Tutorial: Build Your First VR App for a quick hands-on run-through.

What this Guide Covers

This guide covers Rift and Gear VR development with Unity’s first-party support, the Utilities for Unity, and the Unity Sample Framework. Unity maintains documentation of Oculus features in their Editor in the Virtual Reality section of the Unity Manual.

Most information in this guide applies equally to Rift and Mobile development. Exceptions are clearly indicated where they occur. Unless otherwise noted, all instructions assume a Windows development environment.

For a complete reference for the C# scripts included in Oculus Utilities for Unity, see Unity Scripting Reference.

Additional Resources

Oculus offers additional tools to assist Unity development, including a mobile performance analysis client, Oculus Platform support for security and social features, an audio spatialization plugin, and more.

Oculus Integration on the Unity Asset Store

The Oculus Integration, available from the Unity Asset Store here, provides several unityPackages in a single download, including our Utilities for Unity, Oculus Platform SDK Unity plugin, Oculus Avatar SDK Unity Plugin, and the Oculus Native Spatializer Plugin. The Unity Sample Framework is also available from the Asset Store here.

Getting Help

Visit our developer support forums at https://developer.oculus.com.