Get Referencers
IAssetRegistry
0
Что это
Синхронная (exec) функция, возвращающая массив активов, которые ссылаются на указанный актив. Используется для обратного поиска зависимостей в Asset Registry. Возвращает true, если референсеры найдены (даже если массив пуст — успешный поиск).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (Asset Registry) — ссылка на объект Asset Registry (обычно self)
- Asset Data (Asset Data) — актив, для которого ищутся референсеры
Выходы (данные):
- Out Referencers (Array of Asset Data) — массив активов, ссылающихся на указанный
- Return Value (Boolean) —
true, если операция выполнена успешно (даже при пустом результате)
Когда используется
- Поиск всех ассетов, которые используют данный материал, текстуру, меш и т.д.
- Проверка, можно ли безопасно удалить актив (если на него никто не ссылается).
- Построение графа зависимостей в редакторе или тулзах.
Типичные проблемы
- Игнорирование Return Value — функция может вернуть
falseпри ошибке (например, Asset Registry не загружен), но при этомOut Referencersбудет пустым. Всегда проверяйтеReturn Valueперед использованием массива. - Пустой массив ≠ ошибка — если на актив никто не ссылается,
Return Valueвсё равноtrue, а массив пуст. Не путайте с неудачным поиском. - Синхронность на большом проекте — при тысячах активов вызов может быть медленным. Для частых запросов рассмотрите асинхронные альтернативы (например,
Wait for Asset Registry).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.