Compatibility and Version Requirements

System and Hardware Requirements

To verify that you are using supported hardware, please review the relevant PC or mobile setup documentation:

1.16-beta

This beta release adds support for mixed reality capture, which allows live video footage of a Rift user to be composited with the output from a game to create combined video that showed the player in a virtual scene. Unity 5.4 is not supported by 1.16-beta, and it introduces known issues regarding VR Compositor Layers - see below for more details.

There is a known blackscreen issue with Android, and we recommend that you do not use this version for mobile development.

We recommend only updating to this release if you need mixed reality capture support or cylinder VR Compositor Layer support for Rift.

The Oculus integration includes preliminary support for Unity 2017 Beta. If you have any problems or questions, please let us know in our Unity Developer Forum.

Recommended Unity Versions

All Unity versions 5.1 and later ship with a bundled version of the Oculus OVRPlugin that provides built-in Rift and Gear VR support.

The Utilities package also includes the latest version of OVRPlugin. When you import Utilities for Unity into a Unity project, if the OVRPlugin version included with the Utilities is later than the version built into your editor, a pop-up dialog will give you the option to update it. We always recommend using the latest available OVRPlugin version.

For more information, see OVRPlugin.

Legacy support is available for Unity 4 - see our Unity 4.x Legacy Integration Developer Guide for more information.

Unity 5.1 or later provide built-in support for Rift and Gear VR development. The optional Oculus Utilities for Unity package offers additional developer resources.

Unity VersionRecommended Release

Unity 5.5

Unity 5.5.3p2 and later

Unity 5.6

Unity 5.6.0p3 and later

Unity 4

Unity 4.7.0f1 (legacy support only)

For complete details Oculus SDK or Integration version compatibility with Unity, see Unity-SDK Version Compatibility.

OS Compatibility

  • Windows: Windows 7, 8, 10
  • Mac: OS X Yosemite, El Capitan, Sierra

OS X development requires the Oculus Rift Runtime for OS X, available from our Downloads page. Note that runtime support for OS X is legacy only. It does not support consumer versions of Rift.

Unity Personal and Professional Licenses

The Unity Personal and Professional licenses both provide built-in Rift support. Mobile developers using the Unity Free license receive basic Android support automatically. Mobile developers using a Professional license require an Android Pro Unity license.

For more information, see License Comparisons in Unity’s documentation.

Controllers

You may wish to have a controller for development or to use with the supplied demo applications. Available controllers include the Oculus Touch or Xbox 360 controller for Rift, and the Gear VR Controller for mobile development.