You are currently viewing archived documentation. Use the left navigation to return to the latest.


Welcome to the Oculus Unity 3D Integration Guide.

This document describes the steps and procedures required to get a Oculus Rift configured and running in Unity. It also covers details within the integration, so you have a better understanding of what’s going on under the hood.


Please see the Requirements section in the Oculus SDK Overview documentation to ensure that your hardware and software meets or exceeds the minimum requirements.

Note: You must have Unity Pro 4.5 or later to build the Unity demo.

The included demo scene allows you to move around more easily using a compatible gamepad controller (XBox on Windows, HID-compliant on Mac), the recommended controller interface. However, there are also keyboard mappings available for equivalent movement control.

Before you begin, Oculus recommends that you download and read the Oculus SDK Overview documentation and are able to run the included SDK demos.

Direct Mode Display Driver

On Windows, Oculus recommends users install the Oculus Display Driver, which includes a feature known as Direct Display Mode.

In direct mode, the driver makes your Rift behave as an appliance instead of a standard Windows display. Applications target the rift by loading the driver and pointing rendering to it before initialization. This is the default behavior. For compatibility, the Rift can also still be used as a Windows monitor. This is known as Extended Display Mode. When extended mode is active, rendering works as usual with no Oculus intervention. You can choose the mode from the Oculus Configuration Utility’s Rift Display Mode screen.

Note: The direct mode driver is currently only available for Windows.

Direct Mode Display Driver

To get the best experience, always configure the Rift correctly.

In Windows 7 and Windows 8, you can change the display settings by doing the following:

  1. Right-click the desktop and select Screen resolution.
  2. To ensure each display uses the correct frequency, Oculus recommends extending the desktop instead of cloning it. You can clone the same image on all of your displays.

On Mac systems, open System Preferences and then navigate to Displays.

  1. Although you can mirror the same image on all of your displays. Oculus recommends against it. Click Arrangement and ensure Mirror Displays is not enabled.
  2. Some Unity applications will only run on the main display. In this Arrangement screen, drag the white bar onto the Rift’s blue box to make it the main display.
  3. Always use the Rift’s native resolution and frequency. Click Gather Windows. For DK2, the resolution should be Scaled to 1080p, the rotation should be 90°and the refresh rate should be 75 Hertz. For DK1, the resolution should be 1280x800, the rotation should be Standard, and the refresh rate should be 60 Hertz.