Troubleshooting and Known Issues

Important

All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.


We're no longer accepting submission of 32-bit Oculus Quest apps. Any new or updated Oculus Quest application needs to be 64-bit. Please contact Oculus if you are unable to comply with this policy. Oculus Go and Gear VR apps will not be affected by this change.

This section outlines some currently known issues with the Oculus Unity Integration and the Oculus Utilities for Unity. <!--

Rift

The app does not launch as a VR app.

Verify that you have installed the Oculus app and completed setup as described in Preparing for Rift Development.

Verify that you have selected Virtual Reality Supported in Player Settings.

are using a compatible runtime - see Compatibility and Requirements for more details.

Verify that the HMD is plugged in and working normally.

Verify that you have not selected D3D 9 or Windows GL as the renderer (Legacy Integration only). -->

Android

The app does not launch as a VR app.

Verify that you selected Virtual Reality Supported in Player Settings before building your APK.

Applications fail to launch on Gear VR with error message “thread priority security exception make sure the apk is signed”.

You must sign your application with an Oculus Signature File (osig). See “Sign your App with an Oculus Signature File” in Preparing for Android Development for instructions.

General Issues

Unity 5 hangs while importing assets from SDKExamples.

Unity 5 is known to import ETC2-compressed assets very slowly.

Receiving OVRPlugin console errors after importing a new version of Utilities.

Be sure to delete any previously-imported Utilities packages from your Unity project before importing a new version. If you are receiving errors and have not done so, delete the relevant folders in your project and re-import Utilities. For more information, please see Importing the Oculus Utilities Package.

Known Issues

Known issues are listed in the Oculus Integration release notes.

Contact Information

Questions?

Visit our developer support forums at https://forums.oculusvr.com/developer/.

Our Support Center can be accessed at https://support.oculus.com.