Async Change Bundle State For Matching Primary Assets
AsyncActionChangePrimaryAssetBundles
0
Что это
Асинхронная (latent) нода для изменения набора бандлов, назначенных первичным активам, соответствующим заданному массиву идентификаторов. Позволяет массово добавить новые бандлы и убрать старые у указанных активов, опционально форсируя сборку мусора после операции.
Пины
Exec-входы:
- execute (exec) — запуск асинхронной операции
Exec-выходы:
- Completed (exec) — действие успешно завершено
- Failed (exec) — произошла ошибка (например, неверные идентификаторы)
Входы (данные):
- NewBundles (Array of Primary Asset Bundle Id) — бандлы, которые нужно присвоить активам
- OldBundles (Array of Primary Asset Bundle Id) — бандлы, которые нужно удалить у активов
- MatchingAssets (Array of Primary Asset Id) — идентификаторы первичных активов, для которых применяются изменения
- bForceGC (bool) — принудительно запустить сборку мусора после обновления (рекомендуется
trueпри частой смене бандлов)
Выходы (данные):
- нет (void) — результат передаётся только через exec-выходы
Когда используется
- Массовая смена загруженных ресурсов (например, переключение текстур высокого/низкого разрешения для нескольких мешей).
- Динамическая подгрузка/выгрузка уровней или ассетов в асинхронном режиме.
- Оптимизация памяти: удаление неиспользуемых бандлов и добавление нужных в одном вызове.
Типичные проблемы
- Пустой или невалидный
MatchingAssets— нода выполнится без ошибок, но ничего не изменит; проверяйте массив перед вызовом. - Пересечение
NewBundlesиOldBundles— если один и тот же бандл одновременно добавляется и удаляется, результат непредсказуем; избегайте дублирования. - Забытый
bForceGC— при частых вызовах без принудительного GC память может расти; включайте флаг, если изменение бандлов происходит в цикле.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.