Потоковая передача в Unreal

  • Статья
  • Применяется к:
    HoloLens, HoloLens 2

"Потоковая передача" иногда называется голографическим удаленным взаимодействием. Дополнительные сведения см. в этом обзоре.

Потоковая передача с компьютера в HoloLens обеспечивает два основных преимущества:

  • Ваше приложение смешанной реальности может использовать вычислительные мощности компьютера.
  • Ускоренная итерация разработки.

Чтобы приступить к работе, скачайте Holographic Remoting Player на устройство HoloLens. Holographic Remoting Player позволит вашему приложению передавать данные в потоковом режиме непосредственно на проигрыватель удаленного взаимодействия на HoloLens из следующих источников:

  • редактор Unreal Engine;
  • упакованный исполняемый файл Windows.

При потоковой передаче вы получаете доступ практически ко всем возможностям HoloLens, которые можно использовать при запуске приложения на устройстве. К ним относятся отслеживание суставов рук, если вы используете HoloLens 2, пространственное картирование и пространственные привязки. Но при этом недоступны функции из этого списка.

Примечание

  • Качество потоковой передачи в значительной степени зависит от уровня сигнала вашей беспроводной сети.
  • Все возможности автоматически включаются в приложении Holographic Remoting Player. Если вы обнаружите возможность, для включения которой требуется разрешение пользователя (например, отслеживание движения глаз) при потоковой передаче, но не при выполнении на устройстве, убедитесь, что вы включили необходимые возможности в параметрах проекта.

Ограничения потоковой передачи

Виртуальные руки, камера HoloLens и системная клавиатура недоступны при потоковой передаче. Обратите внимание, что речевой ввод для приложений с потоковой передачей можно реализовать через микрофон компьютера, с которого выполняется потоковая передача.

OpenXR

Unreal 4.26 на OpenXR поддерживает потоковую передачу в проигрыватель Holographic Remoting Player версий не младше 2.4.0. Сведения о поддержке последних функций в Holographic Remoting см. в журнале версий и на страницах по устранению неполадок.

Поддержка устройств

Источник HoloLens первого поколения HoloLens 2 Иммерсивные гарнитуры
Unreal Editor ✔️ ✔️ ✔️
Пакет Windows ❌ ✔️ ✔️

Примечание

Начиная с Holographic Remoting версии 2.2.0 потоковая передача также доступна для компьютеров Windows с Windows Mixed Reality.

Потоковая передача из Unreal Editor

Потоковая передача данных из Unreal Editor на устройство HoloLens обеспечивает разработчикам значительные преимущества при тестировании, а именно отсутствие необходимости ждать, пока приложение будет собрано и развернуто, для оценки обновлений.

Подробные инструкции по потоковой передаче из Unreal Editor можно найти в нашей серии руководств.

Потоковая передача из упакованного исполняемого файла Windows

В Unreal 4.25.1 и более поздних версий вы можете передавать данные вашего приложения на устройство HoloLens 2 в потоковом режиме из упакованного исполняемого файла Windows:

  1. Выберите File > Package Project > Windows (Файл > Проект пакета > Windows) в меню редактора.

    • Выберите расположение для сохранения пакета и выберите элемент Select Folder (Выбрать папку).

  2. После завершения сборки пакета откройте инструмент Holographic Remoting Player на HoloLens 2 и запишите значение IP-адреса.

  3. Оставьте Holographic Remoting Player открытым и с помощью командной строки выполните следующие действия:

    • С помощью команды cd перейдите в локальный каталог с сохраненным пакетом.
    • Введите следующую команду: <App Name>.exe -vr -HoloLensRemoting=<IP Address>

Примечание

Имя приложения в параметрах проекта должно быть автоматически использовано для создания пакета Windows. Если по какой-либо причине имена отличаются, используйте имя исполняемого файла Windows в командной строке.

Примечание

Если отслеживание глаз не работает при потоковой передаче из упакованного исполняемого файла, отключите любые другие плагины с устройствами отслеживания глаз (например, Magic Leap), которые поддерживаются компьютером, или запустите приложение из командной строки с соответствующим аргументом отслеживания глаз (см. параметры командной строки).

Нажмите клавишу ВВОД, и ваше приложение начнет потоковую передачу.

Параметры командной строки

Дополнительные параметры командной строки для потоковой передачи с каждой платформы в Unreal Engine 4.26+ можно найти в приведенной ниже таблице.

Параметр Описание
-HoloLensRemoting=<IP address:port> Принимает IP-адрес (и необязательный порт) для подключения к устройству HoloLens 2. Если порт не указан, используется значение по умолчанию 8265.
-RemotingBitrate=<bitrate> (Необязательно) Значение по умолчанию: 8000. Максимальная скорость передачи данных по сети (КБ/с).
-HoloLensRemotingListen (Необязательно) Запуск сервера прослушивания.
-HoloLensRemotingListenPort=<port> (Необязательно) Принимает порт для прослушивания. Используется для подключения к компьютеру или виртуальной машины с устройства HoloLens.
-HoloLens1Remoting=<IP address> (Не рекомендуется с версии 4.26) Принимает IP-адрес для подключения к устройству HoloLens 1.
-eyetracking=WindowsMixedRealityEyeTracker (Необязательно.) Используйте отслеживание глаз Windows Mixed Reality

См. также статью