XR packages

The Unity packages that support XRAn umbrella term encompassing Virtual Reality (VR), Augmented Reality (AR) and Mixed Reality (MR) applications. Devices supporting these forms of interactive applications can be referred to as XR devices. More info
See in Glossary development fall into two broad categories:

• XR provider plug-ins: provider plug-ins enable support for XR devices and platforms. For example, the Apple ARKit plug-inA set of code created outside of Unity that creates functionality in Unity. There are two kinds of plug-ins you can use in Unity: Managed plug-ins (managed .NET assemblies created with tools like Visual Studio) and Native plug-ins (platform-specific native code libraries). More info
  See in Glossary allows ARAugmented Reality More info
  See in Glossary applications to run on the iOS platform and the OpenXR plug-in allows applications to run on several VRVirtual Reality More info
  See in Glossary and MRMixed Reality
  See in Glossary systems.
• Feature and tool support packages: these packages provide features and tools for developing XR applications.

XR provider plug-ins

The Unity XR plug-in framework provides the basis for XR development in Unity. You can add support for an XR device to a project by installing and enabling the relevant XR plug-in. You can add or remove plug-ins to the project at any time.

See XR Project set up for instructions on how to add XR plug-ins to your project using the XR Plug-in Management system.

Unity supports the following XR plug-ins:

Refer to XR Platform System Requirements for system requirements for developing XR projects in Unity.

Notes:

• One plug-in can support more than one type of XR device and more than one operating system.
• Plug-ins for additional XR devices might be available from their platform creators or other third parties.
• Unity does not directly support XR on WebGLA JavaScript API that renders 2D and 3D graphics in a web browser. The Unity WebGL build option allows Unity to publish content as JavaScript programs which use HTML5 technologies and the WebGL rendering API to run Unity content in a web browser. More info
  See in Glossary. Projects that add support for WebXR, such as Needle Engine, SimpleWebXR, and WebXR Export, are available.

XR support packages

Unity’s XR packages build on the XR plug-in framework to add additional application-level features and developer tools.

The XR packages include:

Note: If you use the AR Foundation package in a project, the version numbers of AR Foundation, ARCore, and ARKit must all match. In other words, if you are using version 4.2 of the AR Foundation package, you must also use version 4.2 of the ARCore and ARKit packages.

XR package support notes

The following information provides details about support for specific XR devices.

Magic Leap support

Developing for the Magic Leap 1 is not supported after Unity 2020.3.

Windows Mixed Reality support

Use the OpenXR provider plug-in to develop for Windows Mixed Reality devices.

To configure the OpenXR provider plug-in for Windows MR:

1. In the Unity Editor, open Edit > Project Settings

2. Select the XR Plug-in Management category.

3. Choose the Windows, Mac, Linux tab.

4. In the Plug-in Providers list, enable OpenXR.

   The OpenXR package installs, if necessary.

5. Click the Help icon next to the Windows Mixed Reality feature group option to open the Microsoft Mixed Reality OpenXR Plugin setup instructions.

   

6. Follow the the instructions to install the Microsoft Mixed Reality OpenXR plug-in. (The Microsoft Mixed Reality Feature Tool program lists the plug-in under its Platform Support category.)

7. Enable the Windows Mixed Reality feature group.

After you have installed the plug-in, review the OpenXR settings under XR Plug-in Management.

Meta Quest support

Quest 1 support

Meta has dropped support for the Quest 1 device as of version 51.0 of their Platform SDK. The Platform SDK is included in version 51.0 of the Oculus Integration package on the Unity Asset StoreA growing library of free and commercial assets created by Unity and members of the community. Offers a wide variety of assets, from textures, models and animations to whole project examples, tutorials and Editor extensions. More info
See in Glossary. To continue developing for the Quest 1, you must use version 50 or earlier of the Oculus Integration package. If needed, you can download this version from the Meta Quest downloads page: https://developer.oculus.com/downloads/package/unity-integration/50.0.

In addition, version 4+ of the Oculus provider plug-in package no longer supports Quest 1 development. You must use an earlier version of the Oculus provider plug-in to continue developing for the Quest 1. Because Oculus 4.0 is the verified packageWhen a package passes release cycle testing for a specific version of Unity, it receives the Verified For designation. This means that these packages are guaranteed to work with the designated version of Unity.
See in Glossary version on Unity 2022.3, you must downgrade to the lower package version.

To install version 3.3.0 of the Oculus package:

1. Open your project in the Unity Editor.

2. Click Oculus XR plug-in version 3.3.0.

   
   The Editor Package Manager window opens, showing the Add package by name dialog

3. Click Add to install the last compatible version of the plugin.

Alternately, you can open the Add package by name dialog manually and enter the package id and version. You can also edit the project’s package manifestEach package has a manifest, which provides information about the package to the Package Manager. The manifest contains information such as the name of the package, its version, a description for users, dependencies on other packages (if any), and other details. More info
See in Glossary file directly to reference the required package version:

"com.unity.xr.oculus": "3.3.0"