XRHandTracker

public XRHandTracker();

Creates a hand container: Type=Hand, Hand=Left, HasTrackingData=false, source Unknown. Defect: the joint-flag array is uninitialized. A new hand is not valid provider data: a custom provider must fill flags and values before enabling data. Does not automatically register a device.

public XRHandTracker.HandTrackingSourceEnum HandTrackingSource { get; set; }

Data source, initially Unknown. Unobstructed and Controller describe the reported kind, NotTracked denotes no tracking; availability depends on the provider. Unknown does not establish optical tracking. The setter changes neither HasTrackingData nor joint flags.

public bool HasTrackingData { get; set; }

Whole-hand data flag, initially false. The setter changes only it: populates no joint flags/transforms and creates no default pose. Joint values remain when false but must not drive interactions. The provider owns real-hand state, not gameplay code.

public Vector3 GetHandJointAngularVelocity(XRHandTracker.HandJoint joint);

Returns stored angular velocity. Use requires AngularVelocityValid; the getter applies neither reference frame nor WorldScale.

public XRHandTracker.HandJointFlags GetHandJointFlags(XRHandTracker.HandJoint joint);

Reads joint validity/tracking bits. Before provider initialization values can be arbitrary because of the constructor defect. VALID is not TRACKED. Check HasTrackingData and required bits; velocities have separate bits.

public Vector3 GetHandJointLinearVelocity(XRHandTracker.HandJoint joint);

Returns stored linear velocity without checking LinearVelocityValid or converting to gameplay world space. Do not use a retained value after tracking loss.

public float GetHandJointRadius(XRHandTracker.HandJoint joint);

Reads stored radius, initially 0. In OpenXR units are meters and radius is meaningful only with PositionValid. The getter checks no flag and applies no WorldScale.

public Transform3D GetHandJointTransform(XRHandTracker.HandJoint joint);

Returns a Transform3D value without flag checks. In OpenXR it is tracking space with Humanoid orientation adjustment, not a bone-local or world transform. Check PositionValid for position and OrientationValid for rotation. Retained data may be stale.

public XRHandTracker.HandTrackingSourceEnum GetHandTrackingSource();

Returns the stored source. Do not infer it from the runtime name; keep Unknown unknown.

public bool GetHasTrackingData();

Reads the whole-hand flag. Specific joint flags are also required; true alone does not validate all 26 joints.

public void SetHandJointAngularVelocity(XRHandTracker.HandJoint joint, Vector3 angularVelocity);

Stores angular velocity without deriving it from rotation or changing AngularVelocityValid. The provider defines space conventions.

public void SetHandJointFlags(XRHandTracker.HandJoint joint, XRHandTracker.HandJointFlags flags);

Stores one joint mask; changes no transform, velocities or HasTrackingData. A custom provider must explicitly initialize all required joints before publishing data. Do not use this to alter real-hand state from gameplay.

public void SetHandJointLinearVelocity(XRHandTracker.HandJoint joint, Vector3 linearVelocity);

Stores linear velocity separately from transform and flags. Derives nothing from the previous frame and does not enable LinearVelocityValid.

public void SetHandJointRadius(XRHandTracker.HandJoint joint, float radius);

Stores the radius float without range validation or flag changes. The provider must supply a finite physically meaningful value; readback does not establish usability.

public void SetHandJointTransform(XRHandTracker.HandJoint joint, Transform3D transform);

Stores a joint transform without recomputing flags or velocities. Provider API, not a model-bone movement command.

public void SetHandTrackingSource(XRHandTracker.HandTrackingSourceEnum source);

Data source, initially Unknown. Unobstructed and Controller describe the reported kind, NotTracked denotes no tracking; availability depends on the provider. Unknown does not establish optical tracking. The setter changes neither HasTrackingData nor joint flags.

public void SetHasTrackingData(bool hasData);

Whole-hand data flag, initially false. The setter changes only it: populates no joint flags/transforms and creates no default pose. Joint values remain when false but must not drive interactions. The provider owns real-hand state, not gameplay code.