Oculus Mobile SDK

1.15.0 | Published 2018-07-10
I have read and agree to the terms of the EULA, Terms of Use and Privacy Policy

Oculus Mobile SDK 1.15.0

The Mobile SDK includes libraries, tools, and resources for native C/C++ development for Oculus Go and Samsung 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.15 from previous versions, see Mobile SDK Migration Guide.

New Features

The following new features can be found in 1.15:

  • Support for the Samsung Galaxy A8 Star smartphone.

  • Android Build Tools have been upgraded to the March 2018 release.

API Changes

  • Added Samsung Galaxy A8 Star Device Type to the API.

  • Added a new entry point, vrapi_SetTextureSwapChain3, for creating a texture SwapChain by passing a platform specific texture format instead of the ovrTextureFormat type. The available formats may be queried by passing VRAPI_SYS_PROP_SUPPORTED_SWAPCHAIN_FORMATS to vrapi_GetSystemPropertyInt64Array.

  • vrapi_SetTextureSwapChainHandle has been marked deprecated and should no longer be used.

  • Deprecated ovrFrameLayerFlags flag, VRAPI_FRAME_LAYER_FLAG_WRITE_ALPHA, and corresponding ovrFrameLayerBlend blend modes, VRAPI_FRAME_LAYER_BLEND_DST_ALPHA and VRAPI_FRAME_LAYER_BLEND_ONE_MINUS_DST_ALPHA, have been removed from the API.

  • Added new entry points for creating and obtaining a cross-process friendly Android Surface SwapChain, vrapi_CreateAndroidSurfaceSwapChain and vrapi_GetTextureSwapChainAndroidSurface.

  • ovrTextureType VRAPI_TEXTURE_TYPE_2D_EXTERNAL and corresponding ovrLayerHeader2 SurfaceTextureObject are marked deprecated and should no longer be used. Instead, the application should use the new cross-process friendly Android Surface texture SwapChain creation method, vrapi_CreateAndroidSurfaceSwapChain.

  • ovrSystemProperty VRAPI_SYS_PROP_BACK_BUTTON_SHORTPRESS_TIME has been removed as it should no longer be necessary when using the Input API.

  • Emulation of the remote controllers as a headset now defaults to false for applications built with 1.15.0 and higher, as applications are expected to use the Input API for querying remote and headset input. To maintain the old behavior, pass false to vrapi_SetRemoteEmulation.

  • Remote controllers will no longer send Java input events when headset emulation is off. This behavior can be changed by setting the ovrProperty VRAPI_BLOCK_REMOTE_BUTTONS_WHEN_NOT_EMULATING_HMT to true.

  • When a back button press is detected, the Input API now reports the back button as down for an entire frame instead of only for the next input query. This behavior can be changed by setting the ovrProperty VRAPI_LATCH_BACK_BUTTON_ENTIRE_FRAME to false.

Bug Fixes

  • For Oculus Go, trackpad size now correctly returns the size in millimeters instead of tenths of millimeters for applications built with 1.15 and above.

  • Gear VR devices that have a screen size other than 2560x1440 now report the trackpad location based on the actual screen size.

Known Issues

  • There are no known issues in this release.