Настройте прямой предварительный просмотр для Unity.

Применимые устройства XR
Данное руководство поможет вам создавать приложения для устройств XR такого типа.
XR-гарнитуры
Проводные XR-очки

Функция Direct Preview позволяет тестировать и дорабатывать сложные взаимодействия непосредственно в режиме воспроизведения редактора Unity, используя данные в реальном времени с устройства Android XR. В режиме Direct Preview хост-компьютер отображает и отлаживает контент, передает визуальное окно просмотра непосредственно на ваше физическое устройство Android XR и в режиме реального времени передает поддерживаемые расширения OpenXR обратно на хост.

Следуйте этому руководству, чтобы настроить прямой предварительный просмотр для вашего проекта в Unity.

Предварительные требования

Перед началом убедитесь, что ваша среда разработки соответствует следующим требованиям:

  • Android XR Engine Hub : Выполните все шаги в разделе « Начало работы» руководства по Android XR Engine Hub, чтобы установить и настроить вашу хост-машину для Direct Preview.
  • Аппаратное обеспечение :

    • Используйте хост-машину под управлением Windows 11.
    • Используйте современную видеокарту с поддержкой кодирования видео Vulkan .

Ознакомьтесь с известными проблемами и ограничениями.

Ознакомьтесь со следующими известными проблемами и ограничениями, чтобы знать, чего ожидать при использовании функции Direct Preview в Unity:

  • Аудио : Звук не передается в гарнитуру потоком. Вместо этого он воспроизводится через динамики или наушники вашего компьютера.
  • Разрешение : Возможности управления для изменения разрешения ограничены. Система запрашивает {2364, 2880} на каждый глаз.
  • UI/UX : Процесс подключения клиента функционален, но для этой ранней версии еще не доработан.
  • Поддержка расширений : Хотя многие расширения поддерживаются (например, отслеживание движений рук, взгляда и лица), этот набор ограничен по сравнению с нативными сборками.

Настройка параметров графики

В Windows установите Vulkan в качестве средства рендеринга по умолчанию для кодирования видеопотока:

  1. Перейдите в меню «Редактировать» > «Настройки проекта» > «Плеер» .
  2. Перейдите во вкладку «Другие настройки» .
  3. Снимите флажок «Автоматический графический API для Windows» .
  4. Если в списке указаны Direct3D11 или Direct3D12 , выберите каждый из них и нажмите минус (-) .
  5. Добавить Vulkan : Нажмите плюс (+) и выберите Vulkan .

    Используйте Vulkan в качестве графического API для Windows.

  6. Перезапустите редактор Unity, чтобы применить эти изменения.

Настройка параметров управления плагинами OpenXR

Настройте плагины OpenXR для потоковой передачи:

  1. Перейдите в меню «Редактировать» > «Настройки проекта» > «Управление плагинами XR» .
  2. Щелкните вкладку Windows / Автономное приложение (на этой вкладке есть значок компьютера).
  3. В разделе «Поставщики плагинов» выберите OpenXR .
  4. В разделе OpenXR Feature Group выберите Android XR (Extensions) .
  5. Выберите одновременно «Поддержка Android XR» и «Android XR: сеансы дополненной реальности» .

    Это активирует все поддерживаемые функции и зависимости для потоковой передачи.

    Включите поддержку потоковой передачи Direct Preview с помощью нескольких плагинов OpenXR.

  6. Перезапустите редактор Unity, чтобы применить эти изменения.

Настройка параметров графики и качества.

Для обеспечения совместимости потоковой передачи настройте следующие параметры:

  1. Перейдите в меню «Редактировать» > «Настройки проекта» > «Управление плагинами XR» > «OpenXR» .
  2. Для каждой из следующих настроек выберите следующие параметры:

    • Режим рендеринга : Многопроходный
    • Отправка данных о глубине : глубина 24 бита
    • API фовеального рендеринга : устаревший

    Настройте параметры графики и качества для обеспечения совместимости потоковой передачи.

Провести проверку проекта

Выполните проверку проекта, чтобы исправить любые ошибки OpenXR в конфигурации вашего проекта:

  1. Перейдите в меню «Редактировать» > «Настройки проекта» > «Управление плагинами XR» > «Проверка проекта» .
  2. Перейдите на вкладку «Автономный режим» .
  3. Нажмите «Исправить все» , если возникли ошибки с префиксом [OpenXR] .
  4. Нажмите «Исправить все» , если возникли ошибки, связанные с префиксом [Android XR Streaming] .

    Выполните проверку проекта, чтобы исправить любые ошибки OpenXR в конфигурации вашего проекта:

Начать прямой предварительный просмотр

Запустите прямой предварительный просмотр, чтобы транслировать видео непосредственно из Unity:

  1. Подключите ваше устройство Android XR к компьютеру с помощью высококачественного кабеля USB-C.

  2. Если вы никогда раньше не использовали это устройство с функцией Direct Preview, подключите и настройте устройство для Direct Preview в Android XR Engine Hub, прежде чем запускать Direct Preview через игровой движок.

  3. В редакторе Unity нажмите кнопку Play .

    Потоковая передача с устройства запускается автоматически.