Supported Unreal Engine Versions

• • 4.20 or later

Platforms

• • Win64

  • Android (Quest)

Oculus Platform SDK

• • 1.24 to v34

Additional Notes

• • It is highly recommended to update the Oculus Platform SDK to access all features and bug fixes.

  • This plugin attempts to handle whichever Oculus Platform SDK is installed. Though 1.24 or later is required.

  • Please check the Version Compatibility Reference to determine which version of the Oculus Platform SDK is included with your engine version.

  • The installed SDK version is also indicated in the Plugin Settings.

  • Features added after Oculus Platform SDK v28 have not yet been implemented.

This plugin fails to compile for unmodified installations of the Oculus fork of UE4.25 or 4.26.

1. • • Oculus updated the include files for the Oculus Platform SDK, but the Win64 libraries are outdated. This tricks the plugin into thinking certain classes are available which are not. To solve this, please manually update the Oculus Platform SDK using the steps outlined above.

     • This issue was resolved in 4.27. It might even be resolved entirely, but I haven't looked into it.

My app fails to load on Oculus Quest with this plugin enabled.

1. • • Most likely, this is due to a configuration issue. Please check your configuration settings in 'Project Settings->OVRPlatformBP'. Additionally, please follow the Oculus documentation carefully. The most commonly missed step is to add the config file 'Android/AndroidEngine.ini'.

     • OVR Platform BP will create this file for you, if it does not already exist. Configuring 'DefaultPlatformService' via the Plugin Settings will update that value in both required config files.

My app fails the entitlement check but some platform features work.

1. • • I don't recommend placing the 'Verify Entitlement' node in your Game Instance blueprint. The game instance can sometimes fire 'Event Init' prior to 'OnlineSubsystemOculus' loading. This would cause the check to always fail.

     • Instead, I recommend executing the entitlement check on 'Begin Play' in a blueprint actor.

My app passes the entitlement check but some platform features do not work.

1. • • In this case, please check that you have completed all requisite setup steps.

     • Note that a build must be uploaded to a release channel (the app doesn't need to function properly, it just has to exist).

       • When testing, you don't need to upload each build! You can safely sideload after uploading an initial build.

     • Then, you must add your Oculus email address to the authorized users of that release channel.

     • You will also need to complete the Data Use Checkup on the Oculus Developers site, for each feature used in your app.

In-App Purchases are returning error messages about user permissions.

1. • • Currently, App Lab titles are only permitted to offer free IAP. This is not an issue with the plugin, but a limitation set by Oculus.

     • Similarly, Subscriptions are not available for App Lab projects at this time.

     • If your app has been approved for the Oculus Store and you still have this issue, please contact me.

How can I access the UE4 logs for my Quest project?

1. • • By default, UE4 does not generate logs in shipping configuration. In order to access logs (which are extremely helpful in isolating these issues), please build your app in development configuration while testing.

     • Alternatively, you can follow the steps outlined in this post to enable logs in shipping configuration. Please note that you should not include the line 'bUseChecksInShipping' as it will cause issues uploading your build to an Oculus release channel.

     • Run the app to generate logs, then pull the logs with the following adb command:

       • adb pull /storage/emulated/0/Android/data/com.[your_company].[your_project]/files/UE4Game/[your_project]/[your_project]/Saved/Logs.

Can my App Lab project share Leaderboards or other features with Rift store titles?

1. • • No, this feature is not currently available to App Lab projects.

     • If your app has been accepted as an official Oculus Store app, then you can do this with App Groupings.

Can the same UE4 project be used to create builds for both Rift and Quest?

1. • • Yes, it can! When configuring your app, it is recommended to set 'RiftAppID' and 'MobileAppID' instead of only 'OculusAppID'. This will allow you to create builds for the Rift store and SideQuest without adjusting your config file for each build.

     • 'OculusAppID' is not necessary, but has been included in the plugin settings for legacy apps. It is currently only used as a fallback if the other values are not provided.

Do I have to update the Oculus Platform SDK?

1. • • Short answer? No, not unless you require features which are more recent additions to the SDK.

     • This plugin attempts to handle whichever Oculus Platform SDK is installed. v1.24 or later is required. Please consult the Unreal Compatibility Matrix to determine which version of the Platform SDK is included with your version of Unreal Engine 4.

     • The currently installed Oculus Platform SDK version is noted in the Plugin Settings.