Documentation

0.6 Unity Legacy Integration Release Notes

This document provides an overview of new features, improvements, and fixes included in the Oculus Unity Integration version 0.6.

Unity 4.x Legacy Integration 0.6.2.0

Overview of Major Changes

0.6.2.0 pulls in the 0.7.0 Desktop plugins.

The source for the Unity SDKExample MediaSurface Plugin is now provided. The Media Surface Plugin provides a native library which is used with the Android MediaPlayer for hardware decoding of a single video to a texture. Note that the SDKExample MediaSurface Plugin is not intended to be production quality, and is provided for reference purposes. We have made the source available in case you would like to modify it for your use. The source and build files are located at the following SDK path: VrAppSupport/MediaSurfacePlugin.

This version adds an alpha release of OVRInput, which provides a unified input API for accessing Oculus Touch and Microsoft Xbox controllers.

New Features

  • Added alpha OVRInput script to expose API for Oculus Touch and XInput-based controllers.
  • Now dynamically loads OpenGL ES symbols instead of hard-linking to libGLESv3.so. (Mobile)

API Changes

  • Now requires the new Android Plugin Java library OculusUtilities.jar (found in Assets/Plugins/Android).

Bug Fixes

  • Fixed Editor error message in Unity Free due to unsigned OVRPlugin.dll.
  • Fixed thread affinity failing to be set for the TimeWarp and DeviceManager threads. (Mobile)
  • Fixed device reset when repeatedly plugging and unplugging the Travel Adapter on the Galaxy SAMSUNG S6. (Mobile)
  • Fixed app crash occurring when using Oculus Runtime for OS X earlier than 0.5.0.1.

Unity 4.x Legacy Integration 0.6.1.0

Overview of Major Changes

Legacy Integration 0.6.1.0 expands upon the changes in Unity 4.x PC Integration 0.6.0.2. It is fully compatible with both our Mobile and PC SDKs.

For more information on important changes and updates relevant to this version, see the Release Notes for Integration 0.6.0.2 below.

PC Developers

This release of the Unity Legacy Integration is compatible with the Oculus Runtime 0.6 and 0.7. All Unity projects built with Unity 4 must update to this release, or they will not work on PCs using Runtime 0.7.

OS X Developers

Mac developers using Legacy Integration 0.6.1.0 must update to the Oculus Runtime for OS X 0.5.0.1. Before updating your runtime, be sure to run uninstall.app (found in /Applications/Oculus/) to remove your previous installation.

Mobile Developers

The MediaSurface functionality has been split from the main Unity Integration and provided as a separate plugin, libOculusMediaSurface.so included with the Unity integration package.

New Features

  • SDKExamples
    • MoviePlayer_Sample now looks for media files in the folder Streaming Assets instead of following a hard-coded path on the internal SD card (default mp4 provided).
    • MoviePlayer_Sample defaults to using Unity MovieTexture functionality on the PC (media file expected as Ogg Theora).

API Changes

  • No longer required to issue ResetVrModeParms to dynamically adjust CPU and GPU clock levels.

Bug Fixes

  • Added back one frame of latency to Unity apps to avoid object motion judder by giving Unity apps one frame of additional GPU time (0.5.1 performance parity).

Unity 4.x PC Integration 0.6.0.2

Overview of Major Changes

This release of the Unity Legacy Integration is compatible with the Oculus Runtime 0.6 and 0.7. All Unity projects built with Unity 4 must update to this release, or they will not work on PCs using Runtime 0.7.

In most cases, migrating to this version of the legacy integration will be easy - simply open your project in Unity, import the custom Integration unityPackage, and rebuild.

If you have previously used our C API wrappers in OvrCapi.cs, note that they have been removed and you will need to write your own native plugins or replacement wrappers to access functionality from LibOVRRT. This change is also required to use CAPI with our Unity 5 Utilities, so writing your own plugins or wrappers now will help prepare for your migration to Unity 5.

A single executable file is now produced for PC builds, which will work in both Extended and Direct Display modes.

This version removes support for D3D 9 and Windows GL.

Mac developers using Legacy Integration 0.6.0.2 must update to the Oculus Runtime for OS X 0.5.0.1. Before updating your runtime, be sure to run uninstall.app (found in /Applications/Oculus/) to remove your previous installation.

New Features

  • Compatible with Oculus Runtime versions 0.6 and 0.7.
  • PC builds now produce a single executable file for use in both Extended and Direct Display modes.
  • Oculus runtime log messages now visible in the Unity console.
  • Unity Editor Game View displays undistorted monoscopic preview.
  • No longer necessary to rotate Mac monitor for DK2 in System Preferences->Displays.

API Changes

  • Removed all C API wrappers from OvrCapi.cs.
  • Removed D3D9, Windows GL, and Linux support.

Bug Fixes

  • Fixed C# script problem that caused D3D11 Exclusive Mode errors.
  • Fixed several Editor Game View issues:
    • Now works for all aspect ratio settings.
    • Fixed bug that blacked out Game Views when more than one were created.
    • Fixed Game View positioning bug.

Known Issues

  • Mac tearing: Editor Game View and standalone players do not vsync properly, resulting in a vertical tear and/or judder on DK2. Android players are unaffected, even if built on a Mac.
  • No VR support for in-editor preview on Windows until Unity 4.6.7p4.
  • Slight increase in latency for trivial scenes (i.e., scenes that take < 3 ms to render).

Mobile Unity Integration 0.6.0.1

New Features

  • Allow Unity MediaSurface dimensions to be modified via plugin interface.

Bug Fixes

  • Fixed not being able to enable chromatic aberration correction in the Unity plugin.
  • Fixed adjusting clock levels from Unity during load.

Mobile Unity Integration 0.6.0

Overview of Major Changes

  • Oculus Runtime is no longer required for mobile development.
  • Synced with the Oculus PC SDK 0.6.0.0 beta.
  • Allows clients to re-map plugin event IDs.

For both the PC and Mobile SDKs we recommend the following Unity versions or higher: Unity Pro 4.6.3, Unity Professional 5.0.2.p2, Unity Free 4.6, or Unity Personal 5.0.2.p2. For mobile development, compatibility issues are known to exist with Unity 5 and OpenGL ES 3.0 – please check back for updates. Earlier versions of Unity 5 should not be used with the Mobile SDK.

New Features

  • VrAPI: improved frame prediction, in particular for Unity.

Bug Fixes

  • Fixed prediction glitch every 64 frames.
  • Use correct prediction for OVR_GetCameraPositionOrientation.
  • Fixed location of the PlatformMenu Gaze Cursor Timer

PC Unity Integration 0.6.0.0

New Features

  • Disabled eye texture anti-aliasing when using deferred rendering. This fixes the black screen issue.
  • Eliminated the need for the DirectToRift.exe in Unity 4.6.3p2 and later.
  • Removed the hard dependency from the Oculus runtime. Apps now render in mono without tracking when VR isn't present.
Loading…