Oculus Mobile SDK

1.7.0 | Published 2017-08-10
I have read and agree to the terms of the EULA, Terms of Use and Privacy Policy

Oculus Mobile SDK 1.7.0

The Mobile SDK includes libraries, tools, and resources for native C/C++ development for Gear VR. If you work primarily with Unity or Unreal Engine, in most cases it is not necessary to download the Mobile SDK.

For more information, see our Mobile SDK Developer Guide.

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

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.