Release Notes

Use the Platform SDK to create social VR applications. Add Matchmaking, DLC, Commerce (In-App Purchases), Cloud Storage, Voice Chat, Achievements, and more to your experience using the individual components of the SDK. The SDK download includes sample apps that demonstrate how to implement many of the SDK features in fully-functional games and applications.

The Platform SDK is compatible with all Oculus supported development environments and platforms. Information about the SDK features and how to get started can be found in the Oculus Platform SDK documentation.

Oculus Platform SDK 1.43 (Latest)

This release contains bug fixes and general performance improvements.

Older Versions

Following is a list of older versions.

Oculus Platform SDK 1.42

This release contains bug fixes and general performance improvements.

Oculus Platform SDK 1.41

This release contains bug fixes and general performance improvements.

Oculus Platform SDK 1.40

New Feature

You can now query for a cached list of durable IAP items a user has purchased.

The following APIs have been added to support this feature:

Native - ovr_IAP_GetViewerPurchasesDurableCache()

Unity - Platform.IAP.GetViewerPurchasesDurableCache()

For more information, see Add Purchases to Your Oculus App.

Oculus Platform SDK 1.39

New Features

  • Cloud Storage 2, which provides easy-to-use cloud storage across platforms. For more information, see Cloud Storage 2 in the documentation.

API Changes

  • ovr_CloudStorage2_GetUserDirectoryPath() used with the Cloud Storage 2 feature to get the cloud storage directory for a device.

Oculus Platform SDK 1.36

This release contains bug fixes and general performance improvements.

Oculus Platform SDK 1.32

New Features

  • You can create custom items that users can display in their Oculus Home and associate them with achievements. See Custom Items.
  • Support for ARM64 mobile devices when using the platform SDK with Unity

API Changes

  • There are no breaking changes.

Oculus Platform SDK 1.31

New Features

API Changes

  • There are no breaking changes to version 1.31.

Oculus Platform SDK 1.28

The Oculus Platform SDK 1.28 release includes the following new features.

New Features

  • Send Friend Requests from Apps - Initiating the friend request process from within apps is now supported in mobile apps. Please see the Sending Friend Requests from Apps page for more information.
  • New VoIP Options Available - The options to enable discontinuous transmission (DTX) and set the bit rate on new VoIP connections can now be configured. See “Setting VoIP Options – DTX and Bit Rate” in the Voice Chat (VoIP) page for more information.

API Changes

  • There are no breaking changes to version 1.28.

Oculus Platform SDK 1.24

The Oculus Platform SDK 1.24 release includes the following new features.

Oculus recommends that all Unity developers who have previously used Standalone Mode upgrade to Platform 1.24. This version fixes an issue where developer credentials may be stored locally in an insecure manner. Once you have upgraded to 1.24, add your developer credentials as described in the Use the SDK in Standalone Mode section in Unity Development Getting Started.**

New Features

  • Unreal Sample - Platform SDK 1.24 contains an updated Unreal sample that demonstrates the use of many of the Platform features. See the Sample Apps page for more information.

Bug Fixes

  • Fixes an issue where a developer’s credentials may be insecurely stored in the Unity Editor.

API Changes

  • There are no breaking changes to version 1.24.

Oculus Platform SDK 1.20

The Oculus Platform SDK 1.20 release includes the following new features.

New Features

  • Added App Deeplinking to the Platform SDK. App Deeplinking allows you to launch users directly into an app event or gameplay mode from another app. See the App Deeplinking page for more information.

API Changes

  • There are no breaking changes to version 1.20.

Oculus Platform SDK 1.19

The Oculus Platform SDK 1.19 release includes the following new features.

New Features

  • Photo Sharing is available for Gear VR. Photo Sharing allows users to post screen captures they take in VR to their Facebook network. See Sharing for more information about Photo Sharing.
  • The Matchmaking and Room Debugger tool is now available to help developers identify the connections and interactions made by a user or room. See the Matchmaking Testing and Tuning page for more information.

API Changes

  • There are no breaking changes to version 1.19.

Oculus Platform SDK 1.18

The Oculus Platform SDK 1.18 release includes the following new features.

New Features

  • Profile Card API - On Gear VR you can use ovr_User_LaunchProfile to launch a profile that displays the Oculus name, ID, online status, recent interactions, and mutual friends for a specified user. The profile also allows a friend request to be sent. Please see the Users, Friends, and Relationships page for additional information.
  • Recently Met API - Use ovr_User_GetLoggedInUserRecentlyMetUsersAndRooms to retrieve a list of users who the logged-in user recently interacted with in your app. Interesting users, users who interact frequently or for a long duration, will be returned first. Oculus tracks the number of times users meet in VR, their most recent encounter, and the amount of time they spend together. Please see the Users, Friends, and Relationships page for additional information.
  • Room Notifications - You’ll now receive a room update notification if the user is removed from a room by Oculus. Please see the Rooms guide for information about handling room updates.

Platform Reference

  • Platform SDK Reference - The Platform SDK reference has changed. Starting with 1.18 the reference materials will be hosted in a manner similar to the other Oculus SDKs. You’ll always be able to find a link to the latest version on the Reference Content page.

API Changes

  • There are no breaking changes to version 1.18.

Oculus Platform SDK 1.17

The Oculus Platform SDK 1.17 release includes the following new features.

New Feature

  • Standalone Initialization - Standalone initialization is now available for Unity. Read about initializing the SDK in standalone mode in Native Development Getting Started or Unity Development Getting Started.
  • Rooms Invites Push Notifications - The Platform SDK will now send notifications to the message queue when a user has been invited to join a room. Information about room invite notifications can be found in the Rooms guide.
  • Rift Parties - Rift now supports Parties. Parties allow users to chat wherever they are in VR, including your app. Please review the Parties guide for information about how to handle potential conflicts with VoIP streams.

API Changes

  • There are no breaking changes to version 1.17.

Oculus Platform SDK 1.16

The Oculus Platform SDK 1.16 release includes the following new features.

New Feature

  • User and Friends - When retrieving a list of a user’s friends, the Oculus Platform will now order the friends list by online presence. Friends active within your app will be returned first.
  • VoIP - Improvements to the VoIP service to minimize network bandwidth used by the Platform VoIP service.

API Changes

  • There are no breaking changes to version 1.16.

Oculus Platform SDK 1.15

The Oculus Platform SDK 1.15 release includes the following new feature and bug fix.

New Feature

  • Two new Discoverability features are now available for Gear VR apps. Use targeted Announcements and In-App Content stories to bring users into your app. Review the Discoverability documentation for more information.

API Changes

  • There are no breaking changes to version 1.15.

Bug Fix

  • Fixed a Matchmaking deadlock issue that caused users to not be matched by the service.
  • General Platform SDK performance improvements and bug fixes.

Oculus Platform SDK 1.14

The Oculus Platform SDK 1.14 release includes the following new feature and bug fix.

New Feature

  • Added ovr_Platform_InitializeStandaloneOculus that allows you to initialize the Platform SDK in standalone mode for local testing. See Getting Started Guide for information about the SDK initialization methods.

Bug Fix

  • Multiple back-end changes to RoomsManager that improve handling of out-of-order updates. Resolves an issue where users received room updates from rooms they had previously created and joined.

Oculus Platform SDK 1.13

The Oculus Platform SDK 1.13 release includes the following new features.

New Features

  • Asynchronous initialization API - ovr_PlatformInitializeWindowsAsynchronous (Native Rift), ovr_PlatformInitializeAndriodAsynchronous (Native Gear VR), and Platform.Core.AsyncInitialize (Unity). Use the asynchronous API to initialize the SDK with an intermediate state that allows your app to run other processes and make requests to the Platform SDK while initializing. Requests made to the Platform SDK while initializing will be queued to run after SDK initialization has completed. See Getting Started Guide for more information.
  • Livestream testing - New feature to test how apps will perform while a user is Livestreaming. See Sharing for more information.

Oculus Platform SDK 1.12.1

The Oculus Platform SDK 1.12 release includes the following minor improvements and bug fixes.

Version 1.12.1 fixes an issue introduced by 1.12.

API Changes

  • Matchmaking - Change that allows developers to change enqueue options without first having to call ovr_Matchmaking_Cancel2.

Oculus Platform SDK 1.11

The Oculus Platform SDK 1.11 release includes minor improvements, bug fixes, and updates. These include:

New Features

  • Turn host migration on / off when configuring Advanced Quickmatch rooms.

API Changes

  • Matchmaking - Room_KickUser now allows a room owner to kick other users from a matchmaking room.
  • User
    • User_GetLoggedInUserFriends now returns results in improved sort order based on online status and app status.
    • Added User_GetLoggedInUserFriendsAndRooms. New API to retrieve a list of a user’s logged in friends and the rooms they are in.
  • Rooms
    • Room_Join2 now allows a user to update the room metadata if they become the room owner.
    • Room_GetInvitableUsers2 now returns results in improved sort order based on online status and app status.

Bug Fixes

  • Fixed bug where matchmaking room notifications may be received out of order.

Oculus Platform SDK 1.10

The Oculus Platform SDK 1.10 release includes minor improvements, bug fixes, and updates. These include:

  • Updated two Unity sample apps that cover matchmaking, P2P, VoIP, and rooms (Gear and Rift).
  • Added VoIP support to UE4.
  • Added UE4 browse mode.
  • Added some private room matchmaking features to public rooms.
  • Improved leaderboard support in the Dashboard (paging, reset/clear leaderboards).

Oculus Platform SDK 1.9

The Oculus Platform SDK 1.9 release includes minor improvements, bug fixes, and updates.

  • Simplified how to specify matchmaking queries and query variables. Additionally, introduced a new matchmaking argument request structure to make it easier to modify future versions without breaking backwards compatibility. For more information, see Matchmaking.
  • Updated room invites documentation. For more information, see Rooms.

Oculus Platform SDK 1.8

The Oculus Platform SDK 1.8 release includes minor improvements, bug fixes, and updates.

  • Added a new Quickmatch matchmaking mode. For more information, see Matchmaking.
  • You can now subscribe to updates to observer room joins and leaves. For more information, see Matchmaking.
  • Updated matchmaking queries. For more information, see Matchmaking.

Oculus Platform SDK 1.7

The Oculus Platform SDK 1.7 release includes minor improvements, bug fixes, and updates.

  • VoIP Filters: You can now add voice effects to VoIP communications. For more information, see Voice Chat (VoIP).
  • Developer and Admin Entitlements: Developers and admins automatically get entitlements to all apps within that organization.

Oculus Platform SDK 1.6

The Oculus Platform SDK 1.6 release includes improvements to storing user game data in the cloud, achievements, and auto-updates for Gear VR apps.

  • Cloud Storage update: You can now delete stored data. For example, you can let your users decide to delete saved games.
  • Achievements update: You can now design a specific cosmetic appearance for your achievements using our API.
  • Matchmaking update: Matchmaking now supports multiple players in all modes.
  • Separable API update: Only the libovrplatformloader.so is required for auto-updates for native Gear VR apps.

Oculus Platform SDK 1.5

The Oculus Platform SDK 1.5 release includes new functionality, including more options for room invites, an end-to-end VoIP API for multi-player voice communication, and the option to store user game data in the cloud.

  • Room Invites: Room invites are the best way to allow the users of your app to initiate a shared game. Use the Oculus System UI, or build your own UI if you wish.
  • VoIP: Use VoIP to permit direct voice communication among users of your app.
  • Cloud Storage Store user data, like game-save data, in the cloud so users can access their games from any computer.
  • Separable API: For Gear VR apps, the new Oculus platform SDK files libovrplatformloader.so and svcloader.jar will silently auto-update in the background from now on, just as currently happens with Platform SDK .dll files for Rift apps.

Oculus Platform SDK 1.2.x

The 1.2.0 release adds Unreal Engine support, as well as improvements to Unity friend requests, P2P API, error messages, and matchmaking debugging.

  • Initial release of UE4 plugin, for apps made with Unreal Engine, with:

    • OnlineSubsystemOculus
      • Entitlement and user’s Oculus username — UE4 OnlineIdentityInterface
      • User’s friends list — UE4 OnlineFriendsInterface
      • Achievements — UE4 OnlineAchievementsInterface
      • Rooms and Matchmaking — UE4 OnlineSessionInterface
    • OculusNetDriver
      • UE4 Networking with Oculus usernames
  • Unity support for friend requests:
    • Ability to mark notifications as read, as well as retrieve RoomInvites from the server — ovr_Notification_GetRoomInvites
    • Unity callback — RoomInviteNotification
  • P2P API improvements:
    • Check for open connections to a given peer — ovr_Net_IsConnected()
    • Broadcast a single packet to all members of a room — ovr_Net_SendPacketToCurrentRoom()
    • Enforce automatic acceptance of connection attempts from room members — ovr_Net_AcceptForCurrentRoom()
    • Change state when a peer explicitly closes their end of the connection, or when a previously-open connection breaks — ovrPeerState_Closed added to ovrPeerConnectionState
  • Improved error messaging: call the function ovr_Error_GetDisplayableMessage to show a customized error message for Oculus Platform SDK calls
  • Matchmaking debug enhancement: matchmaking_pool_for_admin graph API node is now available for debugging

Oculus Platform SDK 1.1.0

The 1.1.0 release focuses on performance improvements and minor bug fixes.

  • Removed exports that prevent linking with UE4 in some cases.
  • Fixed message parsing resulting from ovr_Matchmaking_JoinRoom.

Oculus Platform SDK 1.0.0

Release 1.0.0 is a maintenance release leading up to Rift launch.

  • A number of new Leaderboard management web APIs were added to the REST API documentation.
  • When joining a room once a match has been found, please switch from using ovr_Room_Join to ovr_Matchmaking_JoinRoom. ovr_Room_Join will soon be deprecated for matchmaking rooms, but will continue to work for released games and joining non-matchmaking rooms.
  • When canceling an enqueuement, switch from using ovr_Matchmaking_Cancel to ovr_Matchmaking_Cancel2. You no longer need to pass in the request hash. With the new changes, you no longer need to care about request hashes at all.