Files
VIVE-OpenXR-Unity/com.htc.upm.vive.openxr/Runtime/Features/Tracker/Wrist/Documentation/OpenXRExtensions.md
2024-01-10 14:20:05 +08:00

2.3 KiB

12.70. XR_HTC_vive_wrist_tracker_interaction

Name String

XR_HTC_vive_wrist_tracker_interaction

Revision

1

Overview

This extension provides an XrPath for getting device input from a VIVE wrist tracker to enable its interactions. VIVE wrist tracker is a tracked device mainly worn on user¡¦s wrist for pose tracking. Besides this use case, user also can tie it to a physical object to track its object pose, e.g. tie on a gun.

VIVE Wrist Tracker input

Interaction profile path:

  • /interaction_profiles/htc/vive_wrist_tracker

Valid for user paths:

  • /user/wrist_htc/left
  • /user/wrist_htc/right

Supported input source

  • On /user/wrist_htc/left only:
    • ¡K/input/menu/click
    • ¡K/input/x/click
  • On /user/wrist_htc/right only:
    • ¡K/input/system/click (may not be available for application use)
    • ¡K/input/a/click
  • ¡K/input/entity_htc/pose

The entity_htc pose allows the applications to recognize the origin of a tracked input device, especially for the wearable devices which are not held in the user¡¦s hand. The entity_htc pose is defined as follows:

  • The entity position: The center position of the tracked device.
  • The entity orientation: Oriented with +Y up, +X to the right, and -Z forward.

VIVE Plugin

After adding the "VIVE Focus3 Wrist Tracker" to "Project Settings > XR Plugin-in Management > OpenXR > Android Tab > Interaction Profiles", you can use the following Input Action Pathes.

Left Hand

  • {LeftHand}/primaryButton: Left tracker primary button pressed state.
  • {LeftHand}/menu: Left tracker menu button pressed state.
  • {LeftHand}/devicePose: Left tracker pose.
  • {LeftHand}/devicePose/isTracked: Left tracker tracking state.

Right Hand

  • {RightHand}/primaryButton: Right tracker primary button pressed state.
  • {RightHand}/menu: Right tracker menu button pressed state.
  • {RightHand}/devicePose: Right tracker pose.
  • {RightHand}/devicePose/isTracked: Right tracker tracking state.

Refer to the /Plugin/Input/ActionMap/InputActions.inputActions about the "Input Action Path" usage and the sample /Plugin/Input/OpenXRInput.unity.