Введение: типичные проблемы совместимости контроллеров VR
Мы сталкивались с ситуацией, когда приложение, идеально работающее на Quest 2, на Quest Pro теряет функционал захвата. Причина — разные Input Binding Profiles и API хаптики. Без функционального тестирования контроллеров под каждую модель шлема такой баг гарантированно попадёт в релиз. Наша команда провела более 50 проектов по тестированию виртуальной реальности, включая челночные проверки на 8 моделях шлемов. Выполняем тестирование под ключ — от настройки стенда до финального отчёта. Экономия бюджета на исправление багов — до 40% по сравнению с пост-релизными патчами.
Как правильно настроить Input Mapping для всех контроллеров?
OpenXR стандартизировал input через OpenXR Input Binding Profiles. В Unity с XR Interaction Toolkit и OpenXR Plugin все контроллерные действия маппятся через InputActionAsset с несколькими binding profiles: Oculus Touch Controller Profile, Valve Index Controller Profile, HTC Vive Controller Profile, Windows Mixed Reality Controller Profile.
Частая проблема: binding настроен только для одного профиля. Разработчик добавил <XRInputBinding path="/user/hand/right/input/trigger/value"> без указания конкретного профиля — привязка применяется к «дефолтному» контроллеру и не срабатывает на Index Knuckles или WMR контроллерах. Мы рекомендуем использовать мультипрофильные биндинги: для каждого действия в InputActionAsset добавляем bindings для всех поддерживаемых профилей. XR Interaction Toolkit предоставляет Default Input Actions ассет с преднастроенными мультипрофильными биндингами — хорошая отправная точка, но требует аудита под конкретный проект.
Специфика Meta Quest Pro: контроллеры Touch Pro имеют дополнительные сенсоры (stylus pointer, face buttons capacitive touch). Если приложение использует OVRInput напрямую вместо OpenXR Actions, нужно явно обрабатывать OVRInput.Controller.TouchPro как отдельный тип — иначе некоторые кнопки возвращают неверные значения. OpenXR Actions лучше OVRInput в плане кроссплатформенности: он автоматически подстраивается под профиль, что снижает риск багов.
Hand Tracking: альтернативный input, который часто игнорируют
Quest 2, 3, Pro поддерживают Hand Tracking без контроллеров. Если приложение заявляет поддержку ручного трекинга, оно должно тестироваться отдельно — Hand Tracking имеет другой input pipeline и другие ограничения.
XR Hands Package (com.unity.xr.hands) предоставляет XRHandSubsystem с данными о 26 суставах каждой руки. Жесты реализуются через XRHandGesture компоненты или кастомную логику. Проблема: жест «щипок» (pinch) — основной способ взаимодействия без контроллера — срабатывает с задержкой и имеет ложные срабатывания при быстрых движениях пальцев. В наших тестах процент ложных срабатываний pinch при обычной пальцевой активности может достигать 15%, что неприемлемо для игровых сценариев. Задержка реакции может составлять 30–50 ms, что критично для ритмичных игр.
Тест-кейсы для Hand Tracking отличаются от контроллерных: проверяем корректность детектирования в условиях плохого освещения (менее 100 люкс), при перекрытии рук, при быстрых жестах. Фиксируем процент ложных срабатываний и предоставляем рекомендации по настройке порогов чувствительности. Получение консультации по настройке Hand Tracking позволит сократить время на отладку.
Почему тестирование хаптики критично?
Touch Pro и Touch Plus имеют TruTouch haptic system — более точная вибрация с поддержкой амплитуды и частоты. Touch у Quest 2 — базовая вибрация с одним параметром интенсивности. API отличается: OVRHaptics для нативного Meta, XRBaseController.SendHapticImpulse(amplitude, duration) для OpenXR. На Touch Pro через Meta XR SDK доступен OVRInput.SetControllerVibration с расширенными параметрами. Если использовать только базовый OpenXR haptic API, TruTouch на Pro контроллерах будет работать как обычная вибрация без использования преимуществ аппаратуры. В результате пользователь не получает иммерсивного опыта, а команда теряет время на пост-релизные доработки.
Тест: сравнение хаптики на Quest 2 и Quest 3/Pro при одинаковых game events. Удар мечом — разная интенсивность? Ожидаемо. Хаптика отсутствует полностью на одном устройстве — баг, фиксируем.
Матрица тестирования: что входит в работу
Функциональное тестирование ведётся по матрице: устройства × тест-кейсы. Минимальная матрица для Quest-first проекта:
| Тест-кейс | Quest 2 | Quest 3 | Quest Pro | Index |
|---|---|---|---|---|
| Trigger — захват объекта | ||||
| Grip — удержание | ||||
| A/B/X/Y кнопки | ||||
| Thumbstick locomotion | ||||
| Haptic feedback при взаимодействии | ||||
| Hand Tracking — pinch select | ||||
| Граничные случаи (разряженный контроллер) |
Каждая ячейка: Pass / Fail / Not Applicable + описание при Fail. Это живой документ, обновляемый с каждым билдом. Результат работы — test matrix с документированными Fail-кейсами, приоритетами и рекомендациями по фиксу. Входит в объём: аудит Input Mapping, проверка хаптики и Hand Tracking, стресс-тесты граничных условий.
Список типичных ошибок при тестировании контроллеров
- Использование только одного Input Binding Profile вместо мультипрофильного
- Отсутствие тестов хаптики на разных моделях
- Игнорирование Hand Tracking в сценариях с контроллерами
- Тестирование только на одном устройстве из линейки
Сроки и формат работы
Функциональное тестирование контроллеров требует физического доступа к устройствам. Если у клиента нет тестовых шлемов — обсуждаем использование устройств с нашей стороны или аренду.
| Объём тестирования | Ориентировочные сроки |
|---|---|
| Один шлем, базовая матрица | 2–4 дня |
| 2–3 модели шлемов, полная матрица | 1–2 недели |
| Полное мультиплатформенное тестирование | 2–4 недели |
Результат работы — test matrix с документированными Fail-кейсами, приоритетами и рекомендациями по фиксу. Стоимость рассчитывается после получения списка поддерживаемых устройств и объёма функциональности. Получите консультацию — оценим объём и сроки для вашего проекта.