Настройки OpenXR

Настройки OpenXR

Настройки проекта задают запрос движка к OpenXR. Они не устанавливают XR runtime, не подключают гарнитуру и не подтверждают поддержку расширения. Ниже приведены ключи и значения по умолчанию текущего Reckfell 1.0.0; включайте только нужные функции.

Минимальный запуск

1. В Project Settings найдите xr/openxr/enabled и включите его. Для первого запуска оставьте Head Mounted, Stereo, Stage и Opaque.
2. Подготовьте action map по пути xr/openxr/default_action_map. В текущем проекте это по умолчанию asset://openxr_action_map.rdata; используйте руководство по action map.
3. Настройте XR-риг и обработку запуска: наличие XRCamera3D само по себе не включает вывод XR. Проверяйте результат инициализации и отдельно разрешайте XR у нужного Viewport.
4. Перезапустите приложение после смены стартовых настроек. Проверяйте лог, активный XR runtime и фактические возможности интерфейса; не определяйте успех по сохранённой галочке.

--xr-mode on принудительно запрашивает XR при старте, --xr-mode off отключает его для диагностического запуска. В обычном режиме редактор не начинает OpenXR-сессию только из-за enabled=true. Запуск игры и запуск самого редактора — разные процессы и этапы.

Для Vulkan запрашивайте OpenXR при старте: расширения графической интеграции нужны до подготовки устройства. Не рассчитывайте, что поздний вызов Initialize исправит пропущенную стартовую конфигурацию. Изменение ProjectSettings во время игры также не пересоздаёт существующие instance, session и swapchain автоматически.

Основные параметры

Не оставляйте action map случайному fallback. Если ресурс не загрузился, интерфейс создаёт стандартные действия; в сборке с инструментами он также пытается сохранить ресурс. Это не подтверждает наличие ваших пользовательских действий и bindings. Сохраните и проверьте собственный .rdata до экспорта.

Stereo with Foveated Inset уже имеет реализацию в текущем исходнике. Это отдельная конфигурация видов с дополнительным inset, а не обещание работы на любой гарнитуре. Для обычного проекта начинайте со Stereo; не путайте inset с настройкой плотности shading.

Выбрать пространство tracking

Это запрошенный режим, а не безусловное обещание. Текущий код при отсутствии Local Floor может эмулировать его через Local и Stage; при других неподдерживаемых запросах выбирает Local. Смотрите лог и фактический режим, прежде чем строить логику пола и recenter.

OpenXRInterface.PoseRecentered сообщает об обновлении reference space после обновления tracking. Обработчик из гайда запуска только передаёт событие; не вызывает CenterOnHmd за вас. Политику сброса выбирайте вместе с room-scale и locomotion. Дополнительный безусловный CenterOnHmd может повторно сместить уже скорректированную камеру. Граница Stage не заменяет коллизии и не останавливает физическое движение человека.

Смешивание с окружением

Opaque полностью выводит виртуальную картинку. Additive складывает свет виртуального изображения с окружением; чёрный здесь не обязан закрывать реальный мир. Alpha использует прозрачность вывода, поэтому проверьте TransparentBg нужного Viewport и материал/фон сцены.

Если выбранный blend mode недоступен, код может перейти к первому поддерживаемому. Alpha также может обслуживаться специальной реализацией passthrough. Не считайте чёрное окно доказательством сломанного материала: сначала проверьте фактический blend mode, доступность passthrough, разрешения и интеграцию целевого устройства. Галочка Alpha сама не устанавливает vendor plugin.

Foveation и качество

Eye-tracked foveation и eye-gaze interaction — разные функции. Значение true не подтверждает ни датчик, ни разрешение, ни активное расширение. Для RD проверьте VRS у Viewport; наличие карты VRS также не является замером фактической экономии.

Если лог сообщает, что subsampled images отключены несовместимыми rendering features, это относится к этому пути изображений. Не переносите вывод автоматически на все варианты foveation. Сравнивайте один и тот же кадр и время GPU на целевом устройстве; не меняйте одновременно разрешение, MSAA, эффекты и уровень foveation.

Расширения и ввод

Все перечисленные переключатели ниже по умолчанию false, кроме явно указанных числовых значений.

Для gaze pose нужен action типа Pose в карте: профиль /interaction_profiles/ext/eye_gaze_interaction, input path /user/eyes_ext/input/gaze_ext/pose. У XRController3D задайте Tracker=/user/eyes_ext, а Pose — имя вашего action. Одного включения расширения недостаточно. Это именование и маршрут по исходнику, не проверка точности взгляда или разрешений устройства.

Пространственное окружение

Следующие ключи нужны для возможностей реального окружения, а не для обычных Entity игрового мира. Включение не создаёт обнаруженные поверхности или сохранённые anchors автоматически. Проверяйте поддержку, согласие пользователя и жизненный цикл данных на устройстве.

Это справочник стартовых запросов, а не инструкция к готовой системе пространственного распознавания. Не используйте наличие этих ключей как проверку доступности anchors, plane tracking или marker detection.

Диагностика запуска

Что проверено

В отдельном проекте установленного Reckfell 1.0.0 с --headless --xr-mode off проверены регистрация и значения 39 скалярных настроек, вектор bounds и наличие неинициализированного заимствованного интерфейса. Получено 81 успешное наблюдение; настройки проекта не записывались, Initialize не вызывался.

Порядок запуска, enum mapping, fallback пространств и blend mode, gating расширений и перечисленные ограничения сверены с текущим исходником. Это не проверка реальной гарнитуры, loader/runtime, permissions, recenter, passthrough, foveation, frame synthesis, tracking, экспорта или UI редактора. Сборка движка и SDK не изменялись.