Add Widget For Player
GameViewportSubsystemЧто это
Exec-функция класса GameViewportSubsystem. Создаёт экземпляр виджета указанного класса и добавляет его во вьюпорт для конкретного игрока (по его PlayerController). Используется для создания HUD, UI для определённого игрока в мультиплеере или разделённом экране.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (GameViewportSubsystem) — ссылка на подсистему вьюпорта
- Widget Class (TSubclassOf\<UUserWidget\>) — класс создаваемого виджета
- Player Controller (APlayerController) — контроллер игрока, которому назначается виджет
- Z Order (int32) — порядок слоя (чем больше, тем выше приоритет отображения)
Выходы (данные):
- Return Value (UUserWidget) — созданный экземпляр виджета (можно сохранить для дальнейшего управления)
Когда используется
- Создание персонального HUD для каждого игрока в многопользовательской игре.
- Добавление UI-элементов (меню паузы, инвентаря) с привязкой к конкретному игроку.
- Разделение экрана (split‑screen) — разные виджеты для разных игроков.
Типичные проблемы
- Передача некорректного Player Controller
Если Player Controller равен nullptr или принадлежит другому игроку, виджет может не отобразиться или вызвать ошибку.
- Забытый/неправильный Z Order
Неправильный порядок слоя может привести к тому, что виджет окажется за другими UI-элементами или, наоборот, перекроет их.
- Не удаляется при смене уровня
Виджет, добавленный через эту функцию, не привязан к уровню по умолчанию — его необходимо удалять вручную (например, в RemoveWidget при деактивации режима), иначе он может остаться в памяти.