Configure project settings

Use the Project Settings window to enable OpenXR:Android XR features and add the Oculus Touch Controller Profile to your project.

Prerequisites

You must have the Android module installed in the version of the Unity Editor you're using. Refer to Add modules for more information.

Enable Unity OpenXR: Android XR

To enable Unity OpenXR: Android XR in your project, follow these steps:

  1. Go to Edit > Project Settings > XR Plug-in Management. If you don't already have it installed, click Install XR Plug-in Management.
  2. In the Android tab, under Plug-in Providers, enable OpenXR.
  3. While still in the Project Settings window, go to XR Plug-in Management > OpenXR.
  4. Under OpenXR Feature Groups, enable the Android XR feature group.
  5. To enable only the features relevant to your project, click on the Android XR feature group, and select the relevant features.
  6. To deploy to the Android XR platform, enable Android XR Support under OpenXR Feature Groups.
Important

You must enable the Android XR: AR Session feature for your project to work correctly.

Unity's Project Settings window is open to XR Plug-in Management > OpenXR, showing a list of enabled features in the Android XR feature group
The Android XR OpenXR feature group, shown with all features enabled.

Note

XR Plug-in Management supports only one enabled plug-in provider at a time per build target. If your project also targets ARCore using the Google ARCore XR Plug-in, to avoid errors you should disable the Google ARCore plug-in provider in the Android tab of Project Settings > XR Plug-in Management before you build an APK for Android XR devices. Likewise, you should disable OpenXR before you build for ARCore.

Configure interaction profiles

For Android XR projects using controller input, you should add the Oculus Touch Controller Profile. If you're using Eye tracking and foveated rendering features in your project, you should also add the Eye Gaze Interaction profile.

To add the Oculus Touch Controller Profile and the Eye Gaze Interaction profile:

  1. Go to Edit > Project Settings > XR Plug-in Management.
  2. In the Android tab, under Plug-in Providers, enable OpenXR.
  3. While still in the Project Settings window, go to XR Plug-in Management > OpenXR.
  4. In the Android tab, under Enabled Interaction Profiles, add Oculus Touch Controller Profile and Eye Gaze Interaction profile.

Unity's Project Settings window is open to XR Plug-in Management > OpenXR. The Enabled Controller Profile contains the Oculus Touch Controller Profile and the Eye Gaze Interaction Profile.
The Oculus Touch Controller Profile and Eye Gaze Interaction Profile are enabled.

Run without focus

Enable Run Without Focus to keep your application running even when it's not in focus but is visible, such as on devices supporting split-screen mode. Run Without Focus is disabled by default when you create a project from scratch. When disabled, the application pauses but remains visible.

Important

Enable this setting if your project uses the Input System Tracked Pose Driver component. Without Run Without Focus enabled, you might encounter headlock issues in your project.

Refer to Android Build Settings for more information.

Pop-up windows

Most Android XR apps require the activity window to be resizable so that pop-ups such as system permission requests can be rendered. To make sure pop-up windows are rendered properly, go to Edit > Project Settings > Player, then select the Android tab and enable Resizeable Activity. (In earlier versions of Unity, this setting was named Resizable Window.)

Additional resources