Direct Preview позволяет тестировать и итерировать сложные взаимодействия непосредственно в Unreal Editor, используя данные в реальном времени с устройства Android XR. При использовании Direct Preview хост-компьютер выполняет рендеринг и отладку контента, транслирует визуальную область просмотра непосредственно на физическое устройство Android XR и передает поддерживаемые расширения OpenXR обратно на хост-компьютер в режиме реального времени.
В этом руководстве рассказывается, как настроить Direct Preview для проекта в Unreal Engine.
Требования
Прежде чем начать, убедитесь, что ваша среда разработки соответствует следующим требованиям:
- Версия Unreal Engine: Unreal Engine 5.6.x или 5.8.x.
- Настройка проекта. Выполните все шаги, описанные в руководстве по настройке проекта Unreal Engine.
- Android XR Engine Hub. Выполните все шаги в разделе Начало работы руководства по Android XR Engine Hub, чтобы установить и настроить хост-машину для прямого предпросмотра.
Оборудование:
- Используйте хост-машину с Windows 11.
- Используйте современную видеокарту с поддержкой Vulkan Video Encoding.
Как настроить плагины Android XR
Настройте Unreal Engine с необходимыми плагинами Android XR:
Следуйте инструкциям в кратком руководстве по расширениям Android XR для Unreal Engine.
Если вы создадите новый проект или откроете проект, который ранее не использовался с Direct Preview, повторите эти шаги.
Убедитесь, что в каждом проекте есть символическая ссылка на папку с плагинами поставщика.
Настройте параметры проекта.
Задайте настройки проекта для прямой трансляции в режиме предпросмотра:
- Перейдите в раздел Project Settings (Настройки проекта) > Platforms (Платформы) > Windows.
- Для RHI выберите Vulkan.
- Выберите Edit (Изменить) > Plugins (Плагины).
- Включите плагин AndroidXRStreaming.
- Выберите Edit (Изменить) > Project Settings (Настройки проекта) > Description (Описание).
- Включите параметр Запускать в режиме виртуальной реальности.
Как включить среду выполнения потоковой передачи
Теперь, когда в проекте включен плагин AndroidXRStreaming, проверьте, есть ли среда выполнения Android XR Streaming:
- Перейдите в Project Settings (Настройки проекта) > Plugins (Плагины) > AndroidXRStreaming.
Нажмите Включить стриминг Android XR.
Чтобы применить изменения, перезапустите Unreal Engine.
Настройте клиент потоковой передачи
Настройте клиент потоковой передачи, выбрав нужные параметры для проекта:
- Выберите Project Settings (Настройки проекта) > Plugins (Плагины).
В разделе AndroidXRStreamingClient проверьте каждый из следующих параметров и включите или отключите их в соответствии с потребностями вашего проекта:
- Auto Start Client On Preview (Автоматически запускать клиент при предпросмотре). Если этот параметр включен, при нажатии кнопки Start VR Preview (Начать предпросмотр в VR) в редакторе на любом допустимом выбранном устройстве запускается клиентское приложение для предпросмотра.
- Auto Stop Client On Preview (Автоматически останавливать клиент при предварительном просмотре). Если этот параметр включен, клиент предварительного просмотра закрывается, когда останавливается предварительный просмотр VR из редактора.
- Автоматически выбирать совместимое устройство. Если этот параметр включен, при поиске устройств автоматически выбирается первое совместимое устройство, подключенное к компьютеру.
- Показывать диалоговые окна с ошибками. Если этот параметр включен, будут показываться дополнительные диалоговые окна с ошибками (например, если вы попытаетесь запустить предварительный просмотр в VR, не выбрав клиентское устройство). Отключите этот параметр, чтобы скрыть эти диалоговые окна.
- Обновить. Если этот параметр включен, кнопка Обновить ищет подключенные устройства и показывает список совместимых (определяется по наличию клиентского приложения Direct Preview в Android XR Engine Hub).
Начать прямой предпросмотр
Чтобы начать трансляцию напрямую из Unreal Engine, запустите Direct Preview:
Подключите устройство Android XR к хост-машине с помощью качественного кабеля USB-C.
Если вы никогда не использовали это устройство с Direct Preview, подключите и настройте его для Direct Preview в Android XR Engine Hub, прежде чем запускать Direct Preview через игровой движок.
В Unreal Editor нажмите Play level in VR (Воспроизвести уровень в VR). При запуске прямого предварительного просмотра не используйте обычный вариант Play in Editor (Воспроизвести в редакторе).