Async Load Primary Asset
AsyncActionLoadPrimaryAssetЧто это
Асинхронная (latent) функция для загрузки первичного ассета (Primary Asset) по его идентификатору. Выполняется параллельно основному потоку — после завершения вызывается exec-выход Completed с загруженным объектом. Используется в системах Asset Manager для подгрузки контента по требованию.
Пины
Exec-входы:
- execute (exec) — запуск загрузки
Exec-выходы:
- Completed (exec) — срабатывает после завершения асинхронной операции
Входы (данные):
- PrimaryAssetId (FPrimaryAssetId) — идентификатор загружаемого первичного ассета (структура из PrimaryAssetType + PrimaryAssetName)
- bUseSynchronousLoad (bool) — если true, загрузка будет синхронной (по умолчанию false)
Выходы (данные):
- Loaded (UObject) — полученный загруженный объект; если загрузка не удалась — nullptr
Когда используется
- Динамическая загрузка ассетов в рантайме (персонажи, уровни, предметы), когда Asset Manager управляет регистрацией.
- Подгрузка контента в момент перехода между уровнями или по запросу (например, лут-таблицы, скины, звуки).
Типичные проблемы
- Не проверять Loaded на nullptr — после завершения загрузки стоит всегда делать Branch, иначе попытка работы с нулевым объектом приведёт к крашу.
- Опечатка в PrimaryAssetId (например, неверный тип или имя) — функция выполнится, но Completed будет вызван с нулевым Loaded.
- Использование синхронной загрузки (bUseSynchronousLoad = true) в асинхронном контексте — заблокирует игровой поток до завершения загрузки; этого следует избегать на высоконагруженных операциях.