Configure project settings

Configure your project settings for Unity OpenXR: Meta.

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

Prerequisites

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

Add the Meta Quest build platform

Unity 6.1 introduced the Meta Quest build platform. You can use this build platform to configure settings for standalone Meta Quest headsets. When you select this build platform, Unity automatically installs the Unity OpenXR: Meta package.

To add the Meta Quest build platform:

  1. Go to File > Build Profiles to open the Build Profiles window.
  2. In the Platforms list, select Meta Quest.
  3. Click the Switch Platform button.
  4. If you haven't already installed the Unity OpenXR: Meta package, select Install when you're prompted.

The Meta Quest build platform shares its settings with the Android build platform by default. Optionally, you can add a Meta Quest Build profile to customize Meta Quest-specific settings. Refer to Develop for Meta Quest workflow for more information.

Enable OpenXR features

To use any feature in this package, you must enable the corresponding OpenXR Feature in the Meta Quest feature group. Otherwise, your app can't access these features.

To enable the features in this package:

  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 and Meta Quest feature group.
  3. While still in the Project Settings window, go to XR Plug-in Management > OpenXR.
  4. Under OpenXR Feature Groups, enable the Meta Quest feature group.
  5. To enable only the features relevant to your project, click on the Meta Quest feature group, and select the relevant features.

Unity's Project Settings window is open to XR Plug-in Management > OpenXR, showing a list of enabled features in the Meta Quest feature group
The Meta Quest 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 Meta Quest devices. Likewise, you should disable OpenXR before you build for ARCore.

Add the Oculus Touch Controller Profile

To add the Oculus Touch Controller 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.

Unity's Project Settings window is open to XR Plug-in Management > OpenXR. The Enabled Controller Profile contains the Oculus Touch Controller Profile.
The Oculus Touch Controller Profile is the enabled controller profile.

Choose graphics settings

Refer to Optimize graphics settings to understand the required and recommended graphics settings for your OpenXR Meta project.

Additional resources