Get All Assets
IAssetRegistryЧто это
Функция Get All Assets (IAssetRegistry) возвращает список всех зарегистрированных активов в проекте. Это exec-функция (не pure), так как обращение к реестру может быть затратным. Позволяет получить массив структур AssetData для всех активов, которые в данный момент загружены в реестр (или только для активов на диске).
Пины
Exec-входы:
- execute (exec) — запуск получения списка
Exec-выходы:
- then (exec) — продолжение после завершения
Входы (данные):
- Target (Asset Registry Object Reference) — ссылка на объект Asset Registry (обычно подставляется автоматически как self)
- bIncludeOnlyOnDiskAssets (bool) — если true, возвращает только активы, которые находятся на диске (не загружены в память); по умолчанию false
Выходы (данные):
- Out Asset Data (Array of Asset Data) — массив структур
FAssetData, содержащих информацию о каждом активе (путь, имя, класс, теги и т.д.)
Когда используется
- Для перебора всех активов в проекте (например, для построения кастомного браузера контента).
- Для поиска активов по определённым критериям (после получения списка можно отфильтровать по классу или тегам).
- Для проверки наличия активов перед выполнением операций (например, загрузка всех ассетов определённого типа).
Типичные проблемы
- Забытый фильтр — без дополнительной фильтрации возвращаются ВСЕ активы (включая системные, промежуточные, папки), что может привести к огромному массиву и падению производительности. Всегда используйте последующую фильтрацию по классу или тегам.
- Путаница с bIncludeOnlyOnDiskAssets — если установить true, вы не получите активы, которые были созданы во время выполнения (например, динамически сгенерированные текстуры). Для большинства сценариев нужно false.
- Игнорирование асинхронности — хотя функция синхронная, реестр может быть не полностью заполнен на старте игры. Убедитесь, что Asset Registry завершил сканирование, иначе список будет неполным.