Set up an XR scene

To set up an XR sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary, add an XR Rig, XR Origin, or AR Session Origin.

These objects are collections of GameObjectsThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary and components that provide a frame of reference for transforming spatial tracking data into the scene, including controlling the scene cameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
See in Glossary.

The XR Rig and XR Origin are very similar and serve the same purpose. The name has been changed to better reflect the object’s role in the Unity scene. In addition, the XR Origin component has replaced the Camera Offset component. The XR Origin component provides a few additional settings. See XR Origin component for more information.

The AR Session Origin serves as the spatial origin in an AR application. See AR Session Origin for more information. Note that the AR Session Origin is also being renamed to XR Origin (AR) in version 5 of the AR Foundation package.

Prerequisites

Before you can set up a scene for XR, you must first:

• Configure the project for XR.
• Add the AR Foundation to the project, if you are developing an AR app.
• Add the XR Interaction Toolkit package, if you are planning to use it (recommended).
• If you are using the XR Interaction Toolkit, import the Starter Assets. These assets contain Input System actions and presets that you can use to configure XR controller input.

Set up a scene for XR

The basic steps to set up a scene for XR include:

1. Create or open the Scene in the Unity Editor.
2. Add an XR Rig, XR Origin, or AR Session Origin to the scene with the GameObject > XR menu. You will see different options in the menu depending on which XR packages you have added to your project. See XR Origin for a description of the available XR Origin options.
3. Configure XR input. See XR input options for more information.

For AR projects, see Scene setup in the AR Foundation manual for additional set up steps and more detailed instructions.

For VR projects using the XR Interaction Toolkit, see General Setup in the Interaction Toolkit manual for additional information.