Oculus Unity Getting Started Guide

Important

All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.

This guide describes initial setup of the Oculus Unity Integration and building Oculus apps using Unity’s first-party support.

Free and Professional versions of Unity Editor support both PC and Android development. VR support is enabled by simply checking a checkbox in Player Settings.

See the recommended versions of the Unity Editor on the Compatibility and Version Requirements page.

Oculus Integration for Unity

To supplement Unity’s built-in VR support, Oculus offers the Oculus Integration for Unity 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.

Activate Quest Support

You’ll need to use an instance of OVRManager in your project to get your application running on Oculus Quest with 6-DOF mode. After switching the Platform to “Android”, you will see a “Target Devices” section on the top of the inspector of the OVRManager component. Switch the only element from “Gear Vr Or Go” to “Quest” to mark your app compatible with Oculus Quest. Information about OVRManager is found in the Oculus Utilities for Unity guide.

After that, click “Oculus/Tools/Remove AndroidManifest.xml” and “Oculus/Tools/Create store-compatible AndroidManifest.xml”. It will generate/refresh the AndroidManifest.xml under Assets/Plugins/Android. You will find this line in the manifest:

<uses-feature android:name="android.hardware.vr.headtracking" android:version="1" android:required="true" />

You can also add this line to your AndroidManifest.xml manually to make your project compatible with Quest. Additional information about the Oculus Quest Android manifest can be found on the Android Manifest Settings page.

Samples

The 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. Read more about the Sample Framework.

Getting Started

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

This 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 development with Unity’s first-party support, the Oculus Unity Integration, and the Sample Framework. Unity maintains documentation of Oculus features in their Editor in the Virtual Reality section of the Unity Manual.

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

Getting Help

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