Unity Integration

| Published 2021-02-19

Oculus Integration for Unity - v25

Unity provides built-in VR support for Oculus devices. The Oculus Integration package adds scripts, prefabs, samples, and other resources to supplement Unity’s built-in support. The package includes an interface for controlling VR camera behavior, a first-person control prefab, a unified input API for controllers, rendering features, debugging tools, and more.

For more information about setting the development environment, go to Get Started with Oculus in Unity.

Download Oculus Integration Package

The Oculus Integration package, OculusIntegration.unitypackage, is available for download from the Unity Asset Store and on the Unity Integration Archive page.

Before you import the package in unity, check the hardware, software, and Unity version requirements. The minimum supported Unity Editor version for Oculus development is 2018.4.

What's New

  • Added support to upload the debug symbols from Unity

  • Added animations for controller models

  • Color Space API now uses nativeColorGamut and colorGamut variables to manage color spaces

  • Added support for Fisheye Layer in OVROverlay

  • Made OVRPlugin.SetKeyboardOverlayUV() public to enable the positioning of the OS virtual keyboard overlay

  • Added eyeFovPremultipliedAlphaModeEnabled in OVRPlugin to allow enabling and disabling of premultiplied alpha on the Eye Fov layer

  • Added support for the following features in OpenXR:

    • Different color spaces

    • Color Scale/Bias

    • Is External Surface

    • Equirect Layer

    • Cubemap Layer

    • Underlays

    • Left/Right Textures

    • Headlocked Layer

    • Cylinder Layer

    • Quad Layer

What's Fixed

  • Null exception error when PollEvent fails

  • Memory leak coming from PollEvent

  • Color gamut settings not being serialized in OVRManager

  • Cylinder layers in Vrapi not applying overriden textyture rectangles properly

  • Layout error by moving OVR Quick Scene Preview work to Update()

Improvements

  • Improved stability when app is paused or resumed

  • Added new VR intent filter to OVRManifestPreprocessor in Unity

  • Color Gamut now defaults to Rift CV1

Integration Changes

  • Updated the Oculus Unity Integration to v25.0, including:

    • Updated OVRPlugin to 1.57

    • Updated the Audio Spatializer to 25.0

    • Updated the Platform integration to 25.0

    • Updated the Avatar integration to 20.0

    • Updated the LipSync integration to 20.0

Note: You may encounter issues when running ARM7 build on Oculus Go or Oculus Quest, if you are using Unity's XR Management system with the latest OVRPlugin and the Oculus XR Plugin is outdated. In such case, you can either switch to ARM64 build, or upgrade the Oculus XR Plugin to 1.4.0+ to fix the issue.

License Update

Legacy Unity Release Archive

Legacy versions of the Unity Integration can be found in the Unity Integration Archive.