Коротко
- Pixel Streaming передаёт изображение и звук упакованного приложения Unreal Engine в браузер; пользователи также могут взаимодействовать с трансляцией.
- Для настройки нужны плагин Pixel Streaming, серверы, подключающиеся к приложению, и открытые сетевые порты 80 и 8888.
- Несколько устройств в одной сети могут просматривать одну и ту же сцену, транслируемую из одного экземпляра Unreal Engine.
- Для доступа через интернет или из других сетей могут потребоваться дополнительные сетевые настройки, например конфигурация STUN/TURN.
Система Pixel Streaming в Unreal Engine запускает проект на удалённом компьютере и передаёт изображение и звук в веб-браузер. Базовую настройку, описанную в официальной документации Epic Games, можно сначала проверить в локальной сети: к трансляции через браузер подключаются настольные компьютеры и мобильные устройства. Благодаря этому компьютеру, на котором запущена архитектурная сцена, и устройствам зрителей не обязательно использовать одно и то же оборудование.
Это руководство следует инструкциям официальной документации Unreal Engine по настройке локальной сети. В документации не указана конкретная минимальная версия движка; в качестве примера ветки инфраструктуры приводится 5.7. Плагин Pixel Streaming может работать в Windows, Linux или Mac, однако для кодирования видео требуется совместимое GPU-оборудование. Подробности о поддержке оборудования и браузеров см. в официальной справочной документации Pixel Streaming.
1. Подготовьте проект к трансляции
Откройте проект в Unreal Editor и перейдите в категорию Graphics через меню Edit › Plugins. Включите плагин Pixel Streaming или Pixel Streaming 2 и перезапустите редактор. Используемый плагин должен соответствовать настройкам проекта; в документации перечислены оба варианта.
Выберите способ запуска проекта. Pixel Streaming можно использовать с упакованным приложением или через пункт Standalone Game в Unreal Editor. В официальных инструкциях для Windows приведён пример упаковки; для Linux и Mac указаны другие пути к папкам со скриптами запуска сервера.
Если проект запускается из редактора, добавьте параметр подключения в поле Additional Launch Parameters в разделе Editor Preferences › Level Editor › Play. Тот же параметр нужен при запуске упакованного приложения; документация рекомендует создать для него ярлык.
-PixelStreamingURL=ws://127.0.0.1:8888Если пользователи телефона или планшета должны управлять персонажем в сцене касанием, включите настройку Always Show Touch Interface в разделе Project Settings › Engine › Input. Она нужна не во всех проектах; кроме того, структура Player Controller проекта должна поддерживать сенсорный ввод.
При сворачивании окна приложения поток ввода может нарушиться, поэтому в документации также описан необязательный параметр -RenderOffScreen. Он запускает приложение без видимого окна. Но сначала стоит проверить в локальном тесте, нужен ли он для вашей схемы презентации.
2. Настройте серверные компоненты и сеть
Веб-интерфейс и серверные компоненты Pixel Streaming получают из репозитория Pixel Streaming Infrastructure, который размещается отдельно от установки Unreal Engine. В официальной документации описаны два способа: использовать репозиторий напрямую или получить соответствующую ветку инфраструктуры с помощью скрипта
get_ps_serversиз папкиWebServersдвижка. В качестве примера выбора ветки документация указывает 5.7 в шаблонеUEX.Y; этот пример не следует считать гарантией совместимости версий для любой конфигурации.Для подключения по локальной сети убедитесь, что порты 80 и 8888 открыты. В примере для Windows сначала запускают PowerShell от имени администратора и подготавливают зависимости сервера:
SignallingWebServer\platform_scripts\cmd\setup.batЗатем запускают Signalling Server:
SignallingWebServer\platform_scripts\cmd\start_with_stun.batВ документации отмечено, что в Linux и Mac те же действия выполняются скриптами из папки SignallingWebServer\platform_scripts\bash. После успешного запуска в консоли должны появиться строки о прослушивании подключений на портах 80 и 8888. Также рекомендуется перед запуском остановить другие веб-серверы, работающие на компьютере.
| Настройка | Рекомендуемое значение | Назначение |
|---|---|---|
| Порты локальной сети | 80 и 8888 | Помогают браузеру обмениваться данными с приложением-транслятором. |
| Адрес локальной машины | 127.0.0.1 или localhost | Позволяет сначала проверить подключение на том же компьютере. |
| Параметр подключения к трансляции | ws://127.0.0.1:8888 | Подключает приложение Unreal Engine к локальному Signalling Server. |
3. Запустите трансляцию и подключитесь через браузер
Когда серверы будут готовы, запустите упакованное приложение Unreal Engine с параметром подключения. Пример команды из документации:
MyPixelStreamingApplication.exe -PixelStreamingURL=ws://127.0.0.1:8888Сообщение “Streamer connected” в консоли сервера означает, что приложение подключилось к Signalling Server. Затем откройте на том же компьютере поддерживаемый браузер и перейдите по адресу http://127.0.0.1. Запустите подключение и воспроизведение на странице. На другом устройстве в той же сети следует использовать IP-адрес компьютера, который ведёт трансляцию.
Страница проигрывателя по умолчанию может передавать приложению ввод с клавиатуры, мыши и сенсорного экрана. При подключении нескольких устройств все они получают одно и то же изображение сцены; по умолчанию ввод могут отправлять все подключённые пользователи. Если во время презентации важно контролировать, кому доступно управление, можно настроить веб-страницу проигрывателя и права ввода.
4. Использование в архитектуре и визуализации
Pixel Streaming можно использовать, чтобы показывать сцену в реальном времени через браузер членам команды или участникам презентации, у которых нет доступа к компьютеру, где она запущена. Команды по дизайну интерьеров и архитектурной визуализации могут демонстрировать сцену с настольных компьютеров и мобильных устройств в одной сети; устанавливать отдельное приложение на стороне браузера не требуется. Вместо запуска сцены на каждом устройстве зрителя трансляция ведётся из одного работающего экземпляра Unreal Engine.
При этом качество и плавность изображения зависят не только от браузера: приложение работает на компьютере-трансляторе, а кодирование видео плагином требует определённого GPU-оборудования. В исходной документации не указаны модели оборудования или показатели производительности, поэтому перед проектом необходимо проверить совместимость целевого компьютера. Если презентация будет доступна из интернета, сетевые настройки также нужно продумать отдельно; для подключения из разных сетей могут понадобиться параметры STUN/TURN.
Поскольку веб-страницу проигрывателя можно настраивать, для презентации проекта можно разработать собственный интерфейс HTML5 или управление вводом. Однако это выходит за рамки базовой настройки локальной сети. Если нужно изменить файлы сервера, вносите правки в исходное расположение, а не в копии в папке пакета: при новой упаковке изменения в папке пакета могут быть перезаписаны.
Частые ошибки
Не перезапустить редактор после включения плагина или не запускать приложение в упакованном режиме либо в режиме Standalone Game.
Порты 80 и 8888 закрыты либо другой веб-сервер на компьютере мешает настройке.
Запустить упакованное приложение без параметра
-PixelStreamingURL.Сразу проверять подключение из разных сетей. Устранить неполадки проще, если сначала протестировать
127.0.0.1на том же компьютере, а затем подключить другое устройство в локальной сети.Считать подключение через интернет таким же, как подключение в локальной сети. Для доступа из других сетей могут потребоваться STUN/TURN или другие сетевые настройки.
Источники
Источников: 2Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для архитектурных бюро и студий визуализации в Турции практическое преимущество Pixel Streaming в том, что участники могут смотреть сцену в браузере, а один экземпляр Unreal Engine на компьютере-трансляторе можно использовать совместно. Особенно полезно это может быть для презентаций в локальной сети: отпадает необходимость отдельно устанавливать приложение на каждое устройство зрителя.
Перед инвестициями или проведением презентации в реальном времени следует проверить совместимость GPU компьютера-транслятора, сетевые порты и выбранный вариант плагина. Документация не приводит подробных требований к оборудованию, поэтому совместимость нельзя принимать как данность. Если нужен доступ через интернет, конфигурацию STUN/TURN и сети следует спланировать отдельно; первую проверку лучше провести в локальной сети.
Частые вопросы
Какие порты должны быть открыты для Unreal Engine Pixel Streaming?
В официальной инструкции по начальной настройке для обмена данными в локальной сети требуется открыть порты 80 и 8888. Если нужно изменить значения по умолчанию, обратитесь к справочной документации Pixel Streaming.
Можно ли использовать Pixel Streaming на мобильных устройствах?
Да. К трансляции можно подключиться с мобильных устройств через браузер; страница проигрывателя по умолчанию передаёт сенсорный ввод. Работа сенсорного управления в проекте зависит от поддержки со стороны приложения и Player Controller.
Можно ли использовать Pixel Streaming через интернет?
Для доступа из других сетей может потребоваться дополнительная настройка сети. В официальной документации отмечено, что могут понадобиться настройки STUN/TURN-сервера.
