Коротко
- Система Remote Control обеспечивает удалённое управление через HTTP-запросы и сообщения WebSocket, принимаемые сервером, работающим внутри Unreal Engine.
- Для плагина Web Interface требуется NodeJS версии от 8 до 14.15.5.
- Открытые для внешнего доступа свойства в Remote Control Preset можно связать с виджетами веб-панели.
- Epic помечает функцию как бета-версию и рекомендует соблюдать осторожность при её использовании в распространяемых проектах.
Чему вы научитесь в этом руководстве?
Unreal Engine Remote Control позволяет управлять определёнными свойствами и функциями проекта за пределами интерфейса редактора. Согласно документации Epic, система принимает HTTP-запросы и сообщения WebSocket через веб-сервер, работающий внутри Unreal Engine. Remote Control Web Interface позволяет без написания кода связывать открытые для внешнего доступа свойства с виджетами веб-интерфейса.
В этом руководстве мы пошагово рассмотрим требования к плагину, запуск интерфейса в браузере и добавление свойства на панель. Пример использования в архитектурной визуализации — изменение через браузер параметра, открытого для внешнего доступа в сцене, например Contrast в PostProcessVolume. Это не означает, что все настройки сцены доступны автоматически: свойства, которыми нужно управлять, необходимо открыть через Remote Control Preset.
Требования и важные замечания
Нужен проект, открытый в Unreal Editor.
Плагин Remote Control Web Interface использует NodeJS. Согласно требованиям в документации Epic, минимальная версия NodeJS — 8, максимальная — 14.15.5.
Плагин можно найти в категории Messaging в окне Edit > Plugins в Unreal Editor.
Для веб-интерфейса официально поддерживаются браузеры Chrome, Firefox и Safari.
Функция Unreal Engine Remote Control помечена как бета-версия. Epic рекомендует соблюдать осторожность при использовании в проектах, выпускаемых для распространения.
В документации не указаны конкретный номер версии Unreal Engine, требования к оборудованию или цена продукта. Поэтому совместимость с текущим проектом и средой организации нужно проверять отдельно; не следует предполагать версию или характеристики оборудования, которых нет в источнике. По умолчанию Remote Control отключён в упакованных проектах и во время работы игры. Для включения в этих режимах нужны указанные в источнике параметры запуска.
Включите веб-интерфейс
Установите NodeJS на компьютер и проверьте, что его версия входит в указанный диапазон. Затем откройте проект Unreal в Editor.
В главном меню откройте Edit > Plugins. В категории Messaging включите плагин Remote Control Web Interface.
Перезапустите Unreal Engine. Чтобы проверить работу интерфейса, откройте Window > Developer Tools > Output Log и отфильтруйте записи по фразе “remote control web”. В сообщении об успешном запуске должно быть указано, что веб-приложение работает, а также показан порт; в примере из документации используется порт 7000.
Откройте браузер на том же компьютере и перейдите по адресу
127.0.0.1:7000. Порт, используемый Remote Control Web Interface, можно изменить в настройках проекта. В документе Epic Remote Control Quick Start описана дополнительная настройка для доступа с другого компьютера; не следует предполагать детали этой конфигурации.
После загрузки веб-страницы интерфейс считывает открытый в сеансе Unreal Remote Control Preset. Иными словами, свойства, которые будут использоваться на панели, сначала нужно открыть в preset. Набор доступных параметров и их названия можно спланировать с учётом потребностей команды архитектурной визуализации.
Свяжите свойство с панелью
В веб-приложении переключите представление Control в режим Design и откройте вкладку Properties.
Выберите одно из открытых свойств в панели Properties и перетащите его в рабочую область справа. Если на панели ещё нет виджета, приложение создаст его; также на панель будет добавлен подходящий виджет для выбранного свойства.
Например, открытое в preset свойство Contrast можно представить с помощью цветового селектора. В документации Epic это показано на примере поля Contrast компонента PostProcessVolume сцены. Доступный тип виджета может зависеть от формата данных свойства.
Вернитесь в режим Control, измените значение в веб-интерфейсе и проверьте, обновилось ли соответствующее свойство в Unreal Editor.
Чтобы сохранить макет, сохраните соответствующий Remote Control Preset в Unreal Editor. Согласно документации, при следующем открытии веб-приложения макет интерфейса загружается из последнего сохранённого состояния Asset.
В интерфейсе доступны такие виджеты, как кнопка, цветовой селектор, диск, выпадающий список, джойстик, метка, список, панель, слайдер, вкладка, текст, переключатель и вектор. Панель служит контейнером для других виджетов. Для отображения нескольких интерфейсов во вкладке можно использовать виджет List. Можно задавать метки виджетов и свойства, к которым они привязаны. Для некоторых форматов данных, например вектора, можно выбрать отображение в виде джойстика, диска или слайдера.
Использование в архитектурной визуализации
Для архитектурных презентаций и сеансов интерактивной визуализации можно создать отдельный интерфейс управления открытыми параметрами сцены в браузере. Команда может сделать нужные свойства доступными в preset и разместить их на панели с понятными метками. К одному веб-приложению могут подключаться несколько клиентов; изменения, внесённые одним клиентом, передаются остальным через веб-сервер. Это может быть полезно во время совместного сеанса.
В Remote Control Web Interface также есть специальные вкладки для Level Snapshots и Sequencer. Для работы Level Snapshots необходимо включить соответствующий плагин. Вкладка Sequencer позволяет просматривать секвенции проекта, фильтровать их по названию, а также запускать или продолжать секвенции на текущем уровне. В источнике указано, что в списке видны секвенции всего проекта, но воспроизводить можно только те, что находятся на текущем уровне.
Ещё один важный момент — отображение обновлений, когда Editor работает в фоновом режиме. Отключение параметра Use Less CPU when in Background в разделе General > Performance окна Edit > Editor Preferences в Unreal Editor может помочь отображать в Editor значения, изменённые в веб-приложении. Кроме того, при использовании HTTP API можно работать только с функциями и свойствами, открытыми для Blueprint и Python. В API предусмотрены параметры сохранения изменений в истории транзакций, чтобы их можно было отменить; необходимость этого следует оценить с учётом рабочего процесса команды.
Типичные ошибки и дальнейшие шаги
Веб-страница не открывается: Проверьте, включён ли плагин, перезапускали ли вы Unreal Engine и есть ли в Output Log сообщение об успешном запуске. Указанные в источнике локальный адрес и пример порта — 127.0.0.1:7000; также учитывайте, что порт мог быть изменён в настройках проекта.
В списке Properties нет нужной настройки: Веб-интерфейс считывает открытый Remote Control Preset. Убедитесь, что нужное свойство открыто в preset. При прямом доступе через API поддерживаются не все свойства: источник отдельно ограничивает доступ в зависимости от типа свойства и режима использования.
Изменение не отображается у других клиентов: В документации указано, что можно использовать несколько веб-клиентов, а изменения распространяются через сервер. Убедитесь, что клиенты подключены к одному работающему веб-приложению; для доступа из разных сетей отдельно изучите необходимую конфигурацию.
При первом запуске добавьте на панель только несколько нужных свойств и проверьте их соответствие в Editor. Затем можно распределить элементы по вкладкам в соответствии с рабочим процессом и оценить, нужны ли интеграции с Sequencer или Level Snapshots. Учтите в плане развёртывания, что Remote Control по умолчанию отключён в упакованных проектах, а сама функция помечена как бета-версия.
Источник и лицензия
Это руководство адаптировано на турецкий язык по официальной документации Epic Games “Remote Control for Unreal Engine”, “Remote Control Web Application for Unreal Engine” и “Remote Control API HTTP Reference for Unreal Engine”. Источники предоставлены на условиях свободной лицензии; материал переписан, прямые цитаты не использовались.
Источники
Источников: 3Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для архитектурных и визуализационных команд в Турции практическая ценность Remote Control заключается в возможности собрать несколько нужных для сцены элементов управления в общей веб-панели и использовать её с несколькими клиентами во время живых сеансов. Технические специалисты также могут создавать более специализированные сценарии с помощью HTTP API и доступа через Blueprint/Python, однако для этого необходимо тщательно подготовить preset и структуру проекта.
Перед принятием решения важно оценить не только стоимость и оборудование, но и условия совместимости: в источниках не указаны цена и требования к оборудованию, а диапазон NodeJS приведён как 8–14.15.5. Поскольку функция помечена как бета-версия, перед использованием в критически важных производственных процессах её следует протестировать в контролируемом проекте; особенно важно отдельно проверить условия развёртывания и сетевого доступа.
Частые вопросы
Какая версия NodeJS нужна для Unreal Engine Remote Control Web Interface?
Согласно документации Epic, требуется версия не ниже 8 и не выше 14.15.5.
Как добавить свойство сцены на веб-панель Remote Control?
Свойство должно быть открыто в Remote Control Preset. Переключитесь в веб-приложении в режим Design и перетащите его из вкладки Properties в рабочую область — будет добавлен подходящий виджет.
Включён ли Remote Control по умолчанию в упакованных проектах Unreal Engine?
Нет. Epic указывает, что Remote Control по умолчанию отключён в упакованных проектах и во время работы игры.
