Version: 2020.1
UDP troubleshooting
Getting started with AR development in Unity

XR

New to XR development? Start here.

XR is an umbrella term that includes the following types of applications:

  • Virtual Reality (VR): The application simulates a completely different environment around the user.
  • Mixed Reality (MR): The application combines its own environment with the user’s real-world environment and allows them to interact with each other.
  • Augmented Reality (AR): The application layers content over a digital view of the real world.

Officially supported platforms

Unity works closely with strategic partners to make sure that creators have all the support they need when developing content for Unity’s supported platforms. This involves deep platform integration, Unity engine improvements, and XR tech stack optimizations for each platform.

As of 2019.3, Unity officially supports these platforms for XR:

  • ARKit
  • ARCore
  • Microsoft HoloLens
  • Windows Mixed Reality
  • Magic Leap
  • Oculus
  • PlayStation VR

Note: Valve and Google have used Unity’s XR SDK to develop their own plug-ins for OpenVR and Cardboard, respectively. These plug-ins are compatible with Unity 2019.3 and later. For more information, see the Getting started with VR development page.

Unity XR plug-in framework

Unity has developed a new plug-in framework called XR SDK that enables XR providers to integrate with the Unity engine and make full use of its features. This plug-in based approach improves Unity’s ability to make quick bug fixes, distribute SDK updates from platform partners, and to support new XR devices and runtimes without having to modify the core engine. To learn more about:

Deprecation of built-in XR platform integrations

In 2019.3, Unity transitioned to a new plug-in framework to support XR platform integrations. As a result, built-in XR platform integrations have been marked as deprecated. These integrations are still available for use in 2019.3 and will remain functional in 2019.4. Unity will not be developing any new features for these integrations, but will continue to offer essential bug fixes.

The built-in integrations and their corresponding documentation are listed below:

Note: (1) The Vuforia Engine built-in package (Vuforia Engine AR) will no longer be natively distributed and directly supported by Unity as of 2019.3. You will continue to be able to download new versions of Vuforia Engine for Unity via the Vuforia Developer Portal.

AR development in Unity

The AR overview page details how to get started with creating an AR application, lists the packages you need to download, and offers related links to additional documentation. Unity recommends downloading the AR Foundation and XR Management packages to create your application for Unity’s supported handheld and wearable AR devices.

VR development in Unity

The VR overview page details how to get started creating a VR application, lists the packages you need to download, and offers related links to additional documentation. To start, Unity recommends downloading the XR Management and XR Interaction Toolkit (Preview) packages to create your application for Unity’s supported VR devices.

Unity Package Manager

Most of Unity’s XR functionality is available in packages, which you install through the Package Manager (from Unity’s main menu, go to Window > Package Manager). The Package Manager window displays detailed information about each package.

Note: To view preview packages, click the Advanced drop-down menu in the Package Manager window, and select Show Preview Packages.

For a comprehensive list of packages to download, refer to the AR overview and VR overview pages.

API usage examples

Thie AR Foundation Samples GitHub repository contains examples of how to use Unity’s AR Foundation APIs.

Additional Unity resources

UDP troubleshooting
Getting started with AR development in Unity