Выбор и настройка XR Interaction Toolkit для механик игр

Выбор и настройка XR Interaction Toolkit для механик игр

XR Interaction Toolkit (XRIT) — официальный пакет Unity для VR/AR взаимодействий. Звучит как «берём из Package Manager и готово». На практике: у него есть своя архитектура, свои компромиссы, и неправильная настройка даёт либо механики, которые работают не так, как ожидалось, либо performance проблемы из-за лишних update-циклов.

Версия имеет значение

XRIT 2.x и 3.x — это фактически разные системы. Версия 3.x переписала Input handling с Legacy Input Manager на новый Input System, изменила архитектуру Interactor/Interactable, добавила Affordance System для визуальных состояний. Если проект начат на 2.5, а документацию читали для 3.0 — часть API просто не существует или работает иначе.

Перед началом настройки: зафиксировать версию XRIT в manifest.json, убедиться, что Input System Package (com.unity.inputsystem) версии ≥ 1.6, и что XR Plugin Management настроен под целевые платформы. Без явного указания OpenXR Loader или Oculus XR Plugin в XR Plug-in Management многие компоненты XRIT просто не инициализируются без внятного сообщения об ошибке.

XR Origin: правильная структура сцены

Корень всей VR-сцены — XR Origin. Неправильная его настройка — источник 80% проблем с позиционированием и масштабом.

Tracking Origin Mode должен соответствовать типу игры. Floor — для room-scale, игрок стоит на полу, Y=0 это реальный пол. Device — для stationary, начало координат там, где шлем при старте. Если выбрать неправильно, аватар игрока окажется либо под полом, либо в воздухе — и это не баг в геймплейном коде, а одна настройка в XROrigin.RequestedTrackingOriginMode.

Camera Floor Offset Object — промежуточный объект между XR Origin и Camera Offset. Его Y-позиция в Device-режиме задаёт виртуальную высоту глаз (обычно 1.5–1.8 м). В Floor-режиме его Y = 0.

Структура иерархии: XR Origin → Camera Offset → Main Camera (шлем) + LeftHand Controller + RightHand Controller. Добавлять игровые объекты напрямую в Camera Offset — плохая практика: они будут двигаться с головой. Элементы, которые должны быть в мире — должны быть в мировом пространстве, не в дочерних объектах XR Origin.

Настройка XRGrabInteractable под конкретные механики

Стандартный XRGrabInteractable работает из коробки для простых случаев. Для нестандартных — нужно понимать его внутренности.

Movement Type определяет, как объект следует за рукой:

• Instantaneous — телепортируется к позиции attach point каждый кадр. Нет физики, нет плавности. Подходит для интерфейсных элементов.
• Kinematic — Rigidbody перемещается через MovePosition/MoveRotation. Корректно взаимодействует с другими Rigidbody и коллайдерами, но может «проходить» через статичные colliders при высокой скорости.
• VelocityTracking — объект получает velocity, которая тянет его к целевой позиции. Самый «физичный» вариант, лучший для объектов, которые могут быть заблокированы другими объектами. Требует тонкой настройки TrackingSpeed и TrackingRotationSpeed.

Для оружия обычно VelocityTracking с TrackingSpeed = 12–15 и отдельной обработкой броска через SelectExited event + Rigidbody.AddForce с расчётом velocity из истории позиций за последние 5 кадров (просто current velocity контроллера даёт неточный бросок).

Attach Transform — критически важный параметр, который часто не настраивают. Без явного Attach Transform объект прикрепляется к позиции контроллера — это правильно только если хват должен быть у основания. Для меча attach point должен быть у рукояти; для пистолета — у рукоятки с правильным углом. Создаём пустой child-объект с нужной позицией и ротацией, назначаем в поле Attach Transform.

Socket Interactor для размещения объектов

XRSocketInteractor — для механик «положить объект на полку/в слот». Частые проблемы: объект прыгает при snapping если Snap Threshold слишком большой (рекомендуем 0.1–0.2 м), или snap не происходит если Interactor Layer Mask не совпадает с тегами Interactable. Проверяем: на XRSocketInteractor Interaction Layer Mask должен включать слои всех объектов, которые можно положить в слот.

Для сложных механик (оружие с модулями, головоломки со сборкой) стандартный Socket часто недостаточен — пишем кастомный Interactor с наследованием от XRBaseInteractor, переопределяем CanHover и CanSelect с дополнительными условиями (тип объекта, ориентация, состояние).

Ray Interactor для UI и дистанционного взаимодействия

XRRayInteractor + XRUIInputModule для взаимодействия с World Space Canvas. Типичная проблема: ray проходит сквозь UI-элементы или срабатывает на элементы за другими элементами. Решение: правильный sorting layer на Canvas и Blocked Physics Raycasts = true на GraphicRaycaster.

Для игровых объектов XRRayInteractor в паре с XRInteractableSnapVolume даёт «притягивание» луча к центру объекта при приближении — улучшает точность взаимодействия с мелкими объектами без изменения коллайдера.

Стоимость рассчитывается после анализа игровых механик и целевых платформ.