Getting started with the Meta XR Movement SDK

• Install and set up the Movement SDK.
• Add body, face, or eye tracking from the Movement SDK.
• Update from an older Movement SDK version.

1. In the Unity Editor, select Window > Package Management > Package Manager.
2. Select In Project in the dialog, then click + (plus icon) to add a package.
   
3. Select Install package from git URL…
   
4. Enter https://github.com/oculus-samples/Unity-Movement.git in the URL field and click Install. Alternatively, if you want to use a specific version of the package, append # and the version number to the URL. For example, use https://github.com/oculus-samples/Unity-Movement.git#v83.0.0 for the v83 version of the package.
5. Ensure Meta XR Movement SDK displays under Packages - Meta Platforms, Inc. in the Package Manager.

1. Download and unzip a package release from the Assets section of the Unity Movement releases⁠ GitHub repository.
2. In the Unity Editor, select Window > Package Manager.
3. Select In Project in the dialog. Then, click + (plus icon) to add a package.
4. Select Install package from disk…
   
5. Locate and select the package.json file from the unzipped package.
6. Ensure that Meta XR Movement SDK is listed under Packages - Meta Platforms, Inc..

1. From the Package Manager, select the Meta XR Movement SDK package and select the Samples tab.
2. Click Import next to each of the types of samples you need. These are saved in the Assets/Samples/Meta XR Movement SDK/<version> directory of your Unity project.

1. In the Unity Editor, under Hierarchy, select and open the OVRCameraRig within the Inspector.
   
   Set up the OVRCameraRig

   If your project lacks an OVRCameraRig, make sure to complete the Hello World project setup steps.
2. In Inspector, under Quest Features > General, set the types of tracking support your project needs to Supported or Required:
   • Body Tracking Support
   • Face Tracking Support
   • Eye Tracking Support
   Set Hand Tracking Support to Controllers and Hands.
   
3. In Inspector, under Permission Requests On Startup, toggle on the Movement features your project requires. The Record Audio for audio based Face Tracking permission is necessary for the Audio to Expressions (A2E) feature.
   

1. From the Meta toolbar menu, select Tools > Project Setup Tool.
2. Select the standalone tab, which resembles a computer display.
3. Select Apply All if there are any issues. Select the Meta tab and select Apply All.

1. Select the character in the Hierarchy and locate the Character Retargeter building block within the Inspector.
2. Click the button that updates the components and scripts to the latest version. This action automatically cleans up old scripts and components and applies the latest ones.

1. Remove all movement-specific retargeting scripts from your character.
2. Remove all animation rigging constraints under the Rig component of your character.
3. Follow the instructions in Set up a character for body tracking to add the relevant retargeting components.