XRHandTracker

public XRHandTracker();

Создаёт контейнер руки: Type=Hand, Hand=Left, HasTrackingData=false, источник Unknown. Дефект: массив флагов суставов не инициализирован. Новая рука не является валидным поставщиком: до включения данных собственный provider должен заполнить флаги и значения. Не регистрирует устройство автоматически.

public XRHandTracker.HandTrackingSourceEnum HandTrackingSource { get; set; }

Источник данных, изначально Unknown. Unobstructed и Controller описывают сообщённый тип, NotTracked — отсутствие tracking; доступность зависит от поставщика. Unknown не доказывает оптическое tracking. Setter не меняет HasTrackingData или флаги суставов.

public bool HasTrackingData { get; set; }

Флаг данных всей руки, изначально false. Setter меняет только его: не заполняет флаги/трансформы суставов и не создаёт pose default. При false суставные данные сохраняются, но использовать их для взаимодействий нельзя. Состоянием реальной руки управляет поставщик, не игровой код.

public Vector3 GetHandJointAngularVelocity(XRHandTracker.HandJoint joint);

Возвращает сохранённую угловую скорость. Для использования нужен AngularVelocityValid; сам getter не применяет reference frame или WorldScale.

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

Читает битовую маску валидности и tracking сустава. До инициализации поставщиком возможны случайные значения из-за дефекта конструктора. VALID не равен TRACKED. Проверяйте HasTrackingData и нужные биты; для скоростей есть отдельные биты.

public Vector3 GetHandJointLinearVelocity(XRHandTracker.HandJoint joint);

Возвращает сохранённую линейную скорость без проверки LinearVelocityValid и без преобразования в игровой мир. Не используйте оставшееся значение после потери tracking.

public float GetHandJointRadius(XRHandTracker.HandJoint joint);

Читает сохранённый радиус, изначально 0. Для OpenXR единицы — метры и радиус имеет смысл только при PositionValid. Getter не проверяет флаг и не переводит значение через WorldScale.

public Transform3D GetHandJointTransform(XRHandTracker.HandJoint joint);

Возвращает Transform3D по значению без проверки флагов. В OpenXR это пространство tracking с поправкой ориентации для Humanoid, не локальный трансформ кости и не мир. Для позиции проверяйте PositionValid, для вращения OrientationValid. Сохранённые данные могут быть неактуальны.

public XRHandTracker.HandTrackingSourceEnum GetHandTrackingSource();

Возвращает сохранённый источник. Не определяйте его по имени runtime; Unknown оставляйте неизвестным.

public bool GetHasTrackingData();

Читает флаг всей руки. Дополнительно нужны флаги конкретного сустава; одно true не подтверждает валидность всех 26 суставов.

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

Сохраняет угловую скорость без вычисления из вращения и без изменения AngularVelocityValid. Соглашения пространства задаёт поставщик.

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

Записывает маску одного сустава; не меняет трансформ, скорости или HasTrackingData. Для собственного поставщика явно инициализируйте все нужные суставы до публикации данных. Не исправляйте этим состояние настоящей руки из игрового кода.

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

Сохраняет линейную скорость отдельно от трансформа и флагов. Не вычисляет её по предыдущему кадру и не включает LinearVelocityValid.

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

Сохраняет float радиуса без проверки диапазона или изменения флагов. Поставщик должен передать конечное физически корректное значение; getter не подтверждает его пригодность.

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

Сохраняет трансформ сустава без пересчёта флагов или скоростей. Это API поставщика, не команда перемещения кости модели.

public void SetHandTrackingSource(XRHandTracker.HandTrackingSourceEnum source);

Источник данных, изначально Unknown. Unobstructed и Controller описывают сообщённый тип, NotTracked — отсутствие tracking; доступность зависит от поставщика. Unknown не доказывает оптическое tracking. Setter не меняет HasTrackingData или флаги суставов.

public void SetHasTrackingData(bool hasData);

Флаг данных всей руки, изначально false. Setter меняет только его: не заполняет флаги/трансформы суставов и не создаёт pose default. При false суставные данные сохраняются, но использовать их для взаимодействий нельзя. Состоянием реальной руки управляет поставщик, не игровой код.