Migrate to OpenXR

Understand how to migrate your project from the Oculus plugin to OpenXR Meta.

From OpenXR 1.14, the Unity OpenXR: Meta 2.1 package is at feature parity with the Oculus plugin. This means that you can use OpenXR in your Meta Quest project without losing functionality.

Migrating to OpenXR has additional benefits including ongoing support, an active development roadmap, and cross-platform development.

The following sections describe how to migrate your project from the Oculus plugin to Unity OpenXR: Meta 2.1.

Choose your OpenXR packages

For full feature parity, use the Unity OpenXR: Meta package. The OpenXR Meta package isn't a requirement if you don’t need the additional features it provides. If you don't need these features, you can use the OpenXR plugin with Meta Quest Support.

To understand the features each package provides, refer to the OpenXR Features and OpenXR Meta Features documentation respectively.

OpenXR Meta requirements

To use the Unity OpenXR: Meta package, your project must meet the following requirements:

Install packages

Unity OpenXR: Meta is an official Unity package available from the Package Manager. To understand how to install a package via the Package Manager, refer to Install a UPM package from a registry.

Note

When you install the Unity OpenXR: Meta package from the Package Manager, Unity automatically installs the OpenXR Plug-in as a required dependency.

Configure project settings

To use OpenXR Meta, you need to configure your project for OpenXR Meta features to function. This includes enabling OpenXR Meta features in XR Plug-in Management.

To understand how to set up your project for OpenXR Meta, refer to Configure project settings in the OpenXR Meta documentation.

You can also Set up your scene and Optimize graphics settings to adjust your project for OpenXR Meta.

Configure interaction profiles

The recommended interaction profile for OpenXR Meta is the Oculus Touch controller Profile. You can add this in the provider settings as outlined in Configure project settings.

Understand OpenXR features

The following table outlines how specific Oculus features correspond to OpenXR Meta features:

Oculus feature OpenXR Meta feature
Software Dynamic Resolution Dynamic resolution (Meta developer documentation)
Occlusion Occlusion
Meta Quest Touch Plus Controller Meta Quest Touch Plus Controller Profile
Quest Link support Meta Quest Link

Refer to the documentation for each feature to learn about specific requirements.

Additional resources