Previous Platform SDK Version Release Notes

Overview of Oculus Platform SDK Version 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 Initializing and Checking Entitlements for more information.
• Livestream testing - New feature to test how apps will perform while a user is Livestreaming. See Sharing for more information.

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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).

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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

Overview of Oculus Platform SDK Version 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.

Overview of Oculus Platform SDK Version 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.