Find Or Add Meta Data By Class
LevelSequence
0
Что это
Exec-функция класса LevelSequence. Ищет среди метаданных последовательности объект указанного класса и возвращает его. Если такого объекта нет — создаёт новый экземпляр этого класса и добавляет в коллекцию метаданных. Тип: exec (изменяет состояние последовательности).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- _(не уверен в точной сигнатуре)_
Выходы (данные):
- _(не уверен в точной сигнатуре)_
Когда используется
- Когда нужно гарантированно получить объект метаданных определённого класса для чтения или записи пользовательских данных в LevelSequence, не проверяя вручную его наличие.
- В системах, где метаданные создаются по требованию (например, хранение кастомных настроек для последовательности уровней).
Типичные проблемы
- Передача класса, не являющегося наследником
MetaDataCollection, — функция не сможет создать экземпляр и вернётNone. - Забывают, что функция изменяет последовательность (добавляет метаданные), поэтому её нельзя вызывать в pure-контексте (например, в вычислениях без exec-связи).
- Если метаданные уже существуют, но имеют другой класс (не тот, что запрошен), функция не перезаписывает их, а возвращает существующий объект — это может привести к неожиданному типу возвращаемого значения.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.