Before you can set up body, face, or eye tracking with the Movement SDK, you’ll need to configure your Unity project for general Unity development on Meta Quest headsets.

Prerequisites

If you are not familiar with setting up a Unity project for a Meta Quest headset:

Follow the Unity Hello World for Meta Quest VR headsets tutorial. This is the basis to create, configure, and build a basic Unity project that runs on your headset.

Once ready, delete the Cube GameObject from your project’s scene. At this stage your project should be ready for setting up Movement SDK.

Proceed to Movement SDK Setup.

Alternatively, if you’re already familiar with setting up Unity projects for a Meta Quest headset, ensure your project meets the following requirements before working with the Movement SDK:

The latest version of the Meta XR Core SDK for Unity

Standard project configuration settings

An XR provider plugin

OVRCameraRig in your scene

Movement SDK setup

Follow these steps to setup Movement SDK.

Step 1. Bring the Movement package into your Unity project

For this step, you have two options:

Install the package directly from the GitHub repo, or

Download the package first and then install it from your disk

Note that the Meta XR Interaction SDK is required in addition to the Meta XR Core SDK.

Option A. Install the package directly from the GitHub repository

On the menu of the Unity Editor, select Window > Package Manager.

On the Package Manager menu, select In Project for Packages in the dropdown list. Then click + to add your package.

In the menu that appears, select Add package from git URL… (or Install package from git URL…)

In the Add package from git URL (or Install package from git URL…) textbox that appears, enter https://github.com/oculus-samples/Unity-Movement.git as URL and select Add/Install.

Alternatively, if you want to use a specific version of the package, append the version number with a # to the URL. For example, use https://github.com/oculus-samples/Unity-Movement.git#74.0.0 for the v74 version of the package.

Ensure that Meta XR Movement SDK is listed under Packages - Meta Platforms, Inc. of the Package Manager.

Option B. Download the package and install it from your disk

Download and unzip one of the package releases from the Unity Movement GitHub repo.

On the menu of the Unity Editor, select Window > Package Manager.

On the Package Manager menu, select In Project for Packages in the dropdown list. Then click + to add your package.

Select Add package from disk…

Select the package.json file from the location where you unzipped the package.

Ensure that Meta Movement is listed under Packages - Meta Platforms, Inc. of the Package Manager.

Step 2. Import samples

Samples are imported separately, which helps to manage the size of your project’s Assets folder. To import samples, go to the menu in Unity, Window > Package Manager. Locate the Meta Movement package and its Samples tab. Clicking Import places the samples in the Assets/Samples/Meta Movement/<version> folder in the Unity Project.

Step 3. Update building blocks

If you have previously used the Movement SDK > Body Tracking > Add Character Retargeter, then check the Character Retargeter building block. If a new version is available, a button should appear that will update the components and scripts to the latest version.

If you have previously used the Movement Samples > Body Tracking > Animation Rigging Retargeting (full body) (constraints) or similar menu on a character from v74 as discussed in Set up a character for body tracking, you can update the setup by using the same menu again. It automatically cleans up old scripts and components and applies the latest ones.

If this does not work, you’ll need to manually clean up the existing configuration:

Remove any Movement-specific retargeting scripts from your character;

Remove any animation rigging constraints under the Rig component of your character.

Then, follow the instructions under Set up a character for body tracking to add the relevant components for retargeting.

Step 4. Configure Meta XR Camera settings

In Unity Editor, under Hierarchy, select and open the OVRCameraRig in the Inspector.

Important: If you haven’t set up OVRCameraRig, you must first follow the steps in the Prerequisites section of this guide. The rig can also be added using Building Blocks.

In the Inspector, under Quest Features > General, set Body, Face, and Eye Tracking Support to Supported or Required for the type of tracking support you wish to add, and Hand Tracking Support to Controllers And Hands.

While in the Inspector window, scroll down to Permission Requests On Startup, and toggle on the Movement features you wish to use. The record audio permission is necessary for Audio To Expressions to work.