In the Inspector, under Quest Features, ensure that Body, Face, and Eye Tracking Support are set to Supported, and Hand Tracking Support is set to Controllers And Hands.

In the Inspector, ensure the Movement features you use are toggled on under Permission Requests On Startup.

Go to Meta > Tools > Project Setup Tool, select the standalone icon (left icon), and Fix All if any issues. For details, see Use Project Setup Tool.

Step 2. Follow troubleshooting guidelines

If the configuration steps above don’t resolve the problem, use the following guidelines to isolate the problem further.

Note: The following cases cover use of Link for app development with Movement SDK, in addition to general Movement SDK troubleshooting. If you’re facing issues using Movement SDK over Link, ensure you have configured these settings first.

Symptom	Resolution
Body tracking works with controllers on the Meta Quest headset, but not with hands when not using Link.	Enable hand tracking permissions on your headset under Settings > Movement Tracking > Hand Tracking. In the Unity Editor, ensure Hand Tracking and Controllers are enabled in your project’s configuration. Finally, ensure that the app requests Hand Tracking Support during startup.
(Link) Body Tracking works when running an app directly on the headset as an Android build, but fails to run over Link.	Ensure that you connect with a USB cable that supports data transfer, and open Meta Horizon Link app on the PC. Then, under Device Settings, go to Link Cable > Connect Your Headset > Continue. Also, ensure you have Developer Runtime Features enabled on the Meta Horizon Link app on the PC by navigating to Settings > Developer > Developer Runtime Features.
Body looks collapsed on the floor.	This means that Body tracking is not working. Outside of the app context, verify that controllers are being tracked, if you are using controllers. If you are using hand tracking, verify that hands are being tracked.
Body looks invalid after the headset is remounted.	This means that the Body tracking service is not in a valid state. To restart the tracking on this event, add the HMDRemountRestartTracking⁠ script to your scene.
Character with body tracking rigged does not move or follow neither controllers nor hands.	Ensure the components `OVRBody` and `CharacterRetargeter` are enabled on the character. These components also must be on GameObjects that are enabled. If you later disable an `OVRBody` component, body tracking will also be disabled.
(Link) When running the app on PC, it starts on PC, but doesn’t appear on the headset.	Check that Link is enabled on the headset. Disconnect USB cable, connect it back, and enable Link again.
Tracking technologies fail to start via Link or built APKs even with tracking features enabled, and their permissions checks toggled.	Make sure that the account running on the headset and the app on PC is the same, and is a developer account with a team created. Refer to our overview page for setup details.

Step 3. Gather debug log messages

If the above steps don’t resolve the issue, the debug log messages might provide a clue to the problem. In such situations, try routing Debug.Log messages (including exceptions) to text displays visible in your app.

For details, see Unity’s documentation on Application.logMessageReceived⁠.

Did you find this page helpful?