1.7 Release Notes

This document provides an overview of new features, improvements, and fixes included in the latest version of the Oculus Mobile SDK.


Overview of Major Changes

Mobile SDK 1.7.0 provides a new VrApi interface method for obtaining predicted tracking information, build system improvements, and native debugging support with externalNativeBuild.

For details on migrating to Mobile SDK 1.7.0 from previous versions, see Migrating to Mobile SDK 1.7.0.

New Features

  • The build tools versions have changed to:
    • Android NDK r14b
    • Gradle 3.3
    • Android Plugin for Gradle 2.3.3
    • Android SDK Build-Tools 25.0.1
  • Added the system status enumeration VRAPI_SYS_STATUS_SYSTEM_UX_ACTIVE to detect if the either the long press timer or recenter timer system layers are active.
  • vrapi_Initialize now returns an error code if the system driver is not found on the device instead of terminating the app with an exit(0).

API Changes

  • Added a new entry point, vrapi_GetPredictedTracking2, for querying the predicted tracking information along with corresponding view and projection matrices for each eye.
  • A default head model is now automatically applied in both vrapi_GetPredictedTracking() and vrapi_GetPredictedTracking2() for apps targeting SDK 1.7.0 and later. Because these tracking methods no longer explicitly apply the head model or manage head model parameters, we’ve removed the following methods from the VrAppFramework library:
    • const ovrHeadModelParms & GetHeadModelParms() const;
    • void SetHeadModelParms( const ovrHeadModelParms & parms );
  • The predicted tracking methods now return the head pose Y translation as height above the floor. Previously, the Y translation was relative to the head position in its canonical pose, that is, it generally hovered around 0.0m. Apps that previously applied a bias to place the view in the virtual world space must be adjusted if targeting SDK 1.7.0 or later.
  • The vrapi_GetCenterEye() helper functions have been removed and replaced with vrapi_GetFromPose()* helper functions to remove the notion of a ‘center eye’.
  • VRAPI_FRAME_LAYER_FLAG_WRITE_ALPHA from ovrFrameFlags has been deprecated.
  • DST_ALPHA from ovrLayerType has been deprecated.
  • VrApi_LocalPrefs.h has been removed. Applications can use Android system properties for any development debug needs.
  • ovr_GetLocalPreferenceValueForKey and ovr_SetLocalPreferenceValueForKey are no longer provided on the interface. Applications that need similar development testing functionality should instead use Android system properties directly.