Load Asset Blocking
KismetSystemLibraryЧто это
Синхронная (блокирующая) загрузка ассета по Soft Object Reference. Выполнение графа приостанавливается до полной загрузки объекта в память. Тип: exec (не pure).
Пины
Exec-входы:
- execute (exec) — запуск загрузки
Exec-выходы:
- then (exec) — продолжение после завершения загрузки
Входы (данные):
- Asset (Soft Object Reference) — ссылка на ассет, который требуется загрузить
Выходы (данные):
- Return Value (Object Reference) — загруженный объект (None, если ассет не найден или не удалось загрузить)
Когда используется
Когда необходимо гарантированно получить объект в памяти до продолжения логики (например, для немедленного использования в конструкции или модификации). Подходит для небольших ассетов, где задержка незаметна.
Типичные проблемы
- Зависание редактора/игры — синхронная загрузка большого ассета (текстуры 8K, сложного меша) может заблокировать основной поток на секунды. В таких случаях используйте асинхронную загрузку (
Async Load Asset). - Передача некорректного Soft Reference — если
Assetуказывает на несуществующий или удалённый ассет, возвращаетсяNone. Всегда проверяйте результат на валидность. - Повторная загрузка уже загруженного ассета — функция не кеширует результат; повторный вызов с тем же референсом приведёт к повторной синхронной загрузке (хотя объект уже в памяти). Лучше сохранить полученный объект в переменную.