Legacy Documentation: Version 5.4
VR devices
OpenVR

Oculus

Getting started (Windows)

See the detailed documentation on the Oculus Developer website. In particular, follow the instructions for using Unity with Oculus, and see the recommended specs for Oculus development.

Getting started (Gear VR)

You do not need to install anything extra on your machine to deploy to Gear VR. Follow the instructions at the Samsung Developers’ Website.

Make sure that you can deploy a Unity app to your Galaxy Note 5, S6 Edge+, S6, or S6 Edge (see Getting Started with Android Development):

  1. Connect your Android device to your PC/Mac using a micro USB cable.
  2. Create a new empty project (menu: File > New Project).
  3. Switch your build platform to Android (menu: File > Build Settings).
  4. Open the Player Settings (menu: Edit > Project Settings > Player). Select Other Settings and check the Virtual Reality Supported checkbox.
  5. Add Oculus to the Virtual Reality SDK’s list.
  6. Create the folder Plugins/Android/assets under your project’s Assets folder (note: This folder name is case-sensitive).
  7. Include an Oculus signature file in your project in the Plugins/Android/assets folder.
  8. Build and run. Insert the device into your headset and see the skybox with head tracking.

Getting started (OpenVR)

Steam is required to run OpenVR applications, so install Steam and SteamVR. Once SteamVR is working properly with your headset, add OpenVR to the list of supported SDKs. If you require additional functionality beyond Unity’s built-in support, see the SteamVR asset store package.

Upgrading your project from Unity 5.3

  • Re-enable virtual reality support. Open the Player Settings. (menu: Edit > Project Settings > Player), select Other Settings and check the Virtual Reality Supported checkbox. Use the Virtual Reality SDK list displayed below the checkbox to add and remove Virtual Reality Devices for each build target.

  • Remove the Oculus Spatializer Audio Plugin from your project through the Audio Settings Window (menu: Edit > Project Settings > Audio), using the Spatializer Plugin dropdown. It may conflict with the native spatializer and prevent building.

Upgrading your project from Oculus Unity Integration Plugin

  • Remove the OVR folder and any Oculus plugins from your project.
  • Remove or disable the Camera Rig. Replace with a standard Unity Camera.
  • Enable virtual reality support. Open the Player Settings. (menu: Edit > Project Settings > Player), select Other Settings and check the Virtual Reality Supported checkbox. Use the Virtual Reality SDK list displayed below the checkbox to add and remove Virtual Reality Devices for each build target.
  • Enter Play Mode in the Editor to test the build.
VR devices
OpenVR