Функция Direct Preview позволяет тестировать и дорабатывать сложные взаимодействия непосредственно в редакторе Unreal Editor, используя данные в реальном времени с устройства Android XR. В режиме Direct Preview хост-машина выполняет рендеринг и отладку контента, передает визуальное окно просмотра непосредственно на ваше физическое устройство Android XR, а также в режиме реального времени передает поддерживаемые расширения OpenXR обратно на хост.
Следуйте этому руководству, чтобы настроить прямой предварительный просмотр для вашего проекта в Unreal Engine.
Предварительные требования
Перед началом убедитесь, что ваша среда разработки соответствует следующим требованиям:
- Версия Unreal Engine : Unreal Engine 5.6.1 или выше.
- Настройка проекта : Выполните все шаги, описанные в руководстве по настройке проекта Unreal Engine .
- Android XR Engine Hub : Выполните все шаги в разделе « Начало работы» руководства по Android XR Engine Hub, чтобы установить и настроить вашу хост-машину для Direct Preview.
Аппаратное обеспечение :
- Используйте хост-машину под управлением Windows 11.
- Используйте современную видеокарту с поддержкой кодирования видео Vulkan .
Настройка плагинов Android XR
Настройте Unreal Engine с необходимыми плагинами Android XR:
Следуйте инструкциям в кратком руководстве по установке расширений Android XR для Unreal Engine .
В дальнейшем, если вы создадите новый проект или откроете проект, который вы еще не использовали с функцией Direct Preview, повторите те же шаги.
Для каждого проекта убедитесь, что у проекта есть символическая ссылка на папку плагинов поставщика.
Настройка параметров проекта
Настройте параметры проекта для потоковой передачи в режиме прямого предварительного просмотра:
- Перейдите в раздел «Настройки проекта» > «Платформы» > «Окна» .
- Для перехода с RHI на Vulkan .
- Перейдите в меню «Редактировать» > «Плагины» .
- Включите плагин AndroidXRStreaming .
- Перейдите в меню «Редактировать» > «Настройки проекта» > «Описание» .
- Включить запуск в VR .
Включить среду выполнения потоковой передачи.
Теперь, когда в проекте включен плагин AndroidXRStreaming , проверьте, присутствует ли среда выполнения Android XR Streaming:
- Перейдите в Настройки проекта > Плагины > AndroidXRStreaming .
Нажмите «Включить потоковую передачу AndroidXR» .
Для применения этих изменений перезапустите Unreal Engine.
Настройте клиент потоковой передачи.
Настройте клиент потоковой передачи, выбрав различные параметры для вашего проекта:
- Перейдите в «Настройки проекта» > «Плагины» .
В разделе AndroidXRStreamingClient просмотрите каждый из следующих параметров и включите или отключите их в соответствии с потребностями вашего проекта:
- Автоматический запуск клиента при предварительном просмотре : При включении этой функции приложение предварительного просмотра запускается на любом допустимом выбранном устройстве при нажатии кнопки «Начать предварительный просмотр VR» в редакторе.
- Автоматическая остановка клиента при предварительном просмотре : Если включено, клиент предварительного просмотра завершает работу при остановке VR-предварительного просмотра в редакторе.
- Автоматический выбор совместимого устройства : При включении этой функции автоматически выбирается первое совместимое устройство, подключенное к устройству, при поиске устройств.
- Отображать диалоговые окна ошибок : При включении этой опции отображаются дополнительные диалоговые окна ошибок (например, диалоговое окно ошибки отображается, если вы пытаетесь запустить предварительный просмотр VR, не выбрав клиентское устройство). Отключите эту опцию, чтобы скрыть эти диалоговые окна.
- Обновление : Если эта функция включена, кнопка «Обновить» выполняет поиск подключенных устройств и отображает список совместимых (определяется наличием клиентского приложения Direct Preview в Android XR Engine Hub ).
Начать прямой предварительный просмотр
Запустите прямой предварительный просмотр, чтобы транслировать видео непосредственно из Unreal Engine:
Подключите ваше устройство Android XR к компьютеру с помощью высококачественного кабеля USB-C.
Если вы никогда раньше не использовали это устройство с функцией Direct Preview, подключите и настройте устройство для Direct Preview в Android XR Engine Hub, прежде чем запускать Direct Preview через игровой движок.
В редакторе Unreal Engine нажмите «Запустить уровень в VR» . Не используйте обычную опцию «Запустить в редакторе» при запуске предварительного просмотра.