XRPositionalTracker

public XRPositionalTracker();

Создаёт контейнер состояния без pose, с пустым Profile, Hand=Unknown и Type=Unknown. Не регистрирует tracker в XRServer и не обнаруживает устройство. Для контроллера используйте XRControllerTracker.

public XRPositionalTracker.TrackerHand Hand { get; set; }

Принадлежность руке, изначально Unknown. Используйте Unknown, Left или Right; Max — граница enum, не значение устройства. Setter проверяет диапазон. Не выводится автоматически из Name, не создаёт pose и не испускает ProfileChanged.

public string Profile { get; set; }

Строка профиля, изначально пустая. Для OpenXR обычно путь interaction profile; setter сам не проверяет поддержку или формат. ProfileChanged испускается только при изменении строки и передаёт новый профиль. Не создаёт устройство и не переключает его возможности.

public Variant GetInput(StringName name);

Возвращает Variant по внутреннему имени действия или Nil. В текущем C# SDK метод помечен Obsolete и наследуется XRControllerTracker с той же пометкой. Для игрового ввода используйте XRController3D.GetInput; прямое чтение базового XRPositionalTracker дополнительно выдаёт native-предупреждение. Метод не проверяет pose или фокус.

public XRPose GetPose(StringName name);

Возвращает общее состояние именованной pose или null. Повторный SetPose обновляет тот же объект; это не снимок. В C# может повторно использоваться та же обёртка: не вызывайте Dispose/using для заимствованной pose, которую могут читать другие ссылки. Для снимка копируйте Transform и нужные значения; проверяйте HasTrackingData.

public XRPositionalTracker.TrackerHand GetTrackerHand();

Возвращает сохранённую принадлежность руке, изначально Unknown. Не подтверждает наличие данных tracking.

public string GetTrackerProfile();

Возвращает сохранённую строку профиля, изначально пустую. Это не имя tracker, не рука и не подтверждение поддержки устройства.

public bool HasPose(StringName name);

Проверяет наличие именованной записи pose. После InvalidatePose остаётся true: запись не удаляется. Для пригодности данных проверяйте GetPose(name) и HasTrackingData самой pose.

public void InvalidatePose(StringName name);

Для существующей pose сбрасывает HasTrackingData и испускает PoseLostTracking при каждом вызове, включая повторный. Не удаляет запись, не обнуляет трансформ, скорости или confidence, не сбрасывает ввод. Неизвестное имя ничего не делает. Следующий SetPose снова делает запись валидной.

public void SetInput(StringName name, Variant value);

Записывает значение по имени действия; события возникают только при изменении значения и только для Bool, Float или Vector2. Float не синтезирует ButtonPressed по порогу. В C# SDK метод Obsolete даже через XRControllerTracker; это не API ввода игрока. Поставщик tracking управляет состоянием, игровой код читает XRController3D. В QA native Call использован только для искусственных данных.

public void SetPose(StringName name, Transform3D transform, Vector3 linearVelocity, Vector3 angularVelocity, XRPose.TrackingConfidenceEnum trackingConfidence);

Создаёт запись pose при отсутствии или обновляет прежний объект. Записывает трансформ, скорости, confidence и HasTrackingData=true; PoseChanged испускается при каждом вызове, даже с прежними значениями. Confidence=None сам по себе не сбрасывает HasTrackingData. Метод для поставщика tracking; игровой код не должен подменять состояние реального устройства.

public void SetTrackerHand(XRPositionalTracker.TrackerHand hand);

Принадлежность руке, изначально Unknown. Используйте Unknown, Left или Right; Max — граница enum, не значение устройства. Setter проверяет диапазон. Не выводится автоматически из Name, не создаёт pose и не испускает ProfileChanged.

public void SetTrackerProfile(string profile);

Строка профиля, изначально пустая. Для OpenXR обычно путь interaction profile; setter сам не проверяет поддержку или формат. ProfileChanged испускается только при изменении строки и передаёт новый профиль. Не создаёт устройство и не переключает его возможности.

public event XRPositionalTracker.ButtonPressedEventHandler ButtonPressed;

Событие записи изменившегося Bool=true. Повтор true не испускается; Float не преобразуется в нажатие автоматически. Содержит внутреннее имя действия, не подпись.

public event XRPositionalTracker.ButtonReleasedEventHandler ButtonReleased;

Событие записи изменившегося Bool=false. Потеря pose не сбрасывает ввод и не испускает отпускание; очищайте игровое состояние взаимодействий отдельно.

public event XRPositionalTracker.InputFloatChangedEventHandler InputFloatChanged;

Передаёт новое значение действия Float при изменении. Параметр value в C# — double. Не создаёт событий нажатия кнопки и не добавляет dead zone.

public event XRPositionalTracker.InputVector2ChangedEventHandler InputVector2Changed;

Передаёт изменившееся значение Vector2. Параметр в этом событии называется vector; не путайте с value у XRController3D.InputVector2Changed. Нормализация и dead zone не применяются.

public event XRPositionalTracker.PoseChangedEventHandler PoseChanged;

Передаёт общий объект pose после каждого SetPose, даже если значения совпали. Это обновление данных поставщиком, не обязательно изменение координат. Не освобождайте и не изменяйте переданную pose; скопируйте нужные поля для длительного хранения.

public event XRPositionalTracker.PoseLostTrackingEventHandler PoseLostTracking;

Передаёт сохранённую pose уже с HasTrackingData=false. Повторный InvalidatePose снова испускает событие. Отличается от дедуплицируемого TrackingChanged у XREntity3D. Старые координаты остаются доступными, но не подтверждают текущую pose.

public event XRPositionalTracker.ProfileChangedEventHandler ProfileChanged;

Испускается при изменении Profile. Параметр role фактически содержит новую строку профиля, а не Left/Right. Повтор того же профиля событие не создаёт.