Meta XR SDK Installation and Project Setup

0. Contents of This Article

This article introduces project setup methods and SDK installation procedures for developing Meta Quest-compatible applications in Unity. By completing the steps in this article, you will have established the foundation for VR/AR application development using the Meta XR SDK.

1. Creating a Unity Project

[Creating a New Project]

  • Open Unity Hub and click New project
  • Select the Unity version in the New project window
    This article uses 6000.0.34f Install Android development environment when installing Unity
  • Select Universal 3D from the templates
  • Set the Project name in Project Settings
    This article sets it as *MetaXRSDK_Samples
  • Click Create project to create the project

Unity Project Creation Screen

[Switching to Android Platform]

  • Click File -> Build Profiles
  • Select Android in the Build Profiles window and click Switch Platform

Build Settings Screen

  • Click Scene List in the left column
  • Right-click and delete Scenes/SampleScene from the Scene List
  • Close the Build Settings window

2. Installing Meta XR SDK

[Registering to My Assets on Asset Store]

  • Open the Meta XR SDK page on Asset Store and add Meta XR All-in-One SDK to My Assets
    *Sign in with your account on the Unity page beforehand

[Installation via Package Manager]

  • Return to Unity Editor, click Window -> Package Manager to open Package Manager
  • Click My Assets and enter Meta in the search window

Package Manager Screen

  • Select Meta XR All in One SDK and click Install
    If using this asset for the first time, first click *Download. Install after SDK download is complete.
  • After installation, you'll be prompted to restart the Editor, so click Restart Editor

Editor Restart Screen

  • After restart, the Interaction SDK OpenXR Upgrade window may appear, but ignore and close it for now

3. Installing OpenXR Plugin

  • After Unity Editor restart, open Package Manager again
  • Click Unity Registry and search for OpenXR
  • Install OpenXR Plugin
  • A dialog prompting Meta XR Feature Set configuration will appear, so click Yes

XRFeature Set

  • The Project Settings window will appear but can be ignored for now

4. Installing Unity OpenXR Meta (Optional)

The Unity OpenXR plugin installed in the above steps does not support Depth API occlusion features. If you plan to use Depth API, install Unity OpenXR Meta with the following steps.

  • Open Package Manager
  • Click Unity Registry and search for OpenXR
  • Install Unity OpenXR Meta

5. Project Configuration

[Basic Configuration]

  • Close the project once and reopen it just to be safe
  • If the Interaction SDK OpenXR Upgrade dialog appears, click Use OpenXR Hand

Interaction SDK OpenXR Upgrade

[XR Plugin Management Configuration]

  • Open Edit -> Project Settings
  • Click XR Plugin Management in the Project Settings window
  • Select the Android tab and turn OpenXR ON (others should be OFF)
  • If using Meta Quest Link (PC VR for Windows), also turn OpenXR ON from the Windows tab

XR Plugin Settings Screen

[Running Project Validation]

  • Click Project Validation directly under XR Plugin Management
  • Open the Android tab and click Fix All displayed in the tab information
    *Results may not be reflected immediately after clicking Fix All. In such cases, try opening other items and returning to Project Validation to check again
  • If using Meta Quest Link, perform the same operation from the Windows tab

[Meta XR Configuration Verification]

  • Click Meta XR
  • Open the Android tab and click Fix All next to Outstanding Issues
  • If using Meta Quest Link, perform the same operation from the Windows tab

[Creating AndroidManifest.xml]

  • Close the Project Settings window
  • In Unity Editor menu bar, click Meta -> Tools
  • Click Create store-compatible AndroidManifest.xml
  • If prompted for overwrite permission, click Replace

6. Build Settings (Optional)

This operation sets a custom app name (package name). While not mandatory, it's recommended when developing multiple apps.

[App Information Configuration]

  • Open Edit -> Project Settings
  • Select Player
  • Set Company Name and Product Name

Player Settings Screen

[Package Name Configuration]

  • Select Android from the tabs displayed slightly below
  • Open Other Settings
  • Turn OFF the Override Default Package Name checkbox in Identification

Android Settings Screen

7. Next Steps

The basic project configuration is now complete. Next, we'll explain how to display 3D objects in VR.

Displaying Objects in MetaQuest

8. Complete List of Meta XR SDK Articles

Getting Started with Meta XR SDK Quest App Development

0
Subscribe to my newsletter

Read articles from Takashi Yoshinaga directly inside your inbox. Subscribe to the newsletter, and don't miss out.

Written by

Takashi Yoshinaga
Takashi Yoshinaga