Get Game Instance
WidgetЧто это
Pure-функция (не требует exec), возвращающая текущий объект Game Instance из мира, к которому принадлежит владелец функции (Widget, Actor и т.д.). Game Instance живёт на всём протяжении сессии и используется для хранения глобальных данных, профилей, сетевых сервисов.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (Object Reference) — объект, из которого берётся Game Instance (обычно self)
Выходы (данные):
- Return Value (Game Instance Object Reference) — возвращаемый Game Instance. Может быть пустым (null), если мир ещё не инициализирован.
Когда используется
- Получение ссылки на кастомный Game Instance (например,
UMyGameInstance) для доступа к сохраняемым данным, настройкам, сетевым менеджерам. - Чтение глобальных флагов, массивов или состояний, которые не привязаны к конкретному уровню.
Типичные проблемы
- Нет проверки на null – если функция вызывается до полной инициализации мира (например, в конструкторе виджета), Return Value может быть пустым, что приведёт к крашу / ошибке.
- Ошибочный кастинг – разработчик часто приводит возвращаемый объект к своему типу (
Cast<UMyGameInstance>) без проверки, что приводит к null-ссылке, если тип не совпадает. - Использование не там – вызов в виджете, откреплённом от текущего мира (например, в редакторе или в лобби без мира), всегда возвращает null.