License requirement

The functionality described requires a MANUS Bodypack or a MANUS license key with the OpenXR feature enabled.

Getting started with OpenXR

The MANUS Core OpenXR API Layer allows you to stream glove data to OpenXR applications. This guide delves into its setup and usage.

About

The MANUS Core OpenXR API layer is a plugin that allows you to stream glove data to OpenXR applications. The API Layer implements both the XrHandTrackerEXT extension and XR_FB_hand_tracking_aim extension. The Hand Tracker extension facilitates the tracking of hands in 3D space and provides detailed information about the joints of the hands. The Hand Tracking Aim extension on the other hand, enables the tracking of the hand's state through poses such as pinches. This is beneficial for applications requiring such interactions.

Usage

The MANUS Core OpenXR API layer is automatically installed with MANUS Core version 2.2 and later. It will begin streaming data to OpenXR applications that request such data without any additional setup.

To begin, configure a user with both gloves and trackers in the MANUS Core Dashboard. For detailed instructions on setting up trackers in MANUS Core, please refer to this article.

User list order

Ensure that the intended user is positioned first in the list. Users can be reordered using the button located to the left of the username.

Once configured, the gloves will stream data to any OpenXR applications that support the XrHandTrackerEXT extension.

Troubleshooting

When you are experiencing issues with the MANUS Core OpenXR integration, try the following steps:

1. Put on the HMD: Certain OpenXR applications will only receive glove data when an HMD is active.
2. Check MANUS Core version: Ensure you have Core 2.2 or later installed.
3. Restart the OpenXR application: Sometimes a simple restart can resolve issues.
4. Verify device setup in Core: Ensure all devices are correctly set up in Core. If the trackers are not being detected by your tracking system of choice, the hands will not appear in the OpenXR application.
5. Assign trackers to hands: Make sure the trackers are assigned to the hands of the user and verify that the hands are moving within the MANUS Core scene view.
6. Single user support: OpenXR supports only a single user with up to two gloves. If multiple users are present, the first user in the list in Core will be used.
7. Reinstall MANUS Core: If files related to the Core OpenXR integration are moved, the installation may break. If this happens, try reinstalling MANUS Core.
8. Check license key: Ensure you have a valid license key with the OpenXR feature connected to the computer.

By following these steps, you should be able to resolve most issues with the MANUS Core OpenXR integration.