Meta Developers

Oculus Mobile SDK
Download
Updated: Aug 10, 2017|
Version
Select your version
Get access to the libraries, tools, and resources you need for native C/C++ development of Android apps for the Quest and Quest 2.
Version 1.7.0 Release Notes
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.
Known Issues
ovr_ReadFileFromOtherApplicationPackage  attempts to use  delete  to clear a buffer allocated with  malloc. For the workaround, see  Unix diff file for PackageFiles.cpp.