Get Linked Anim Layer Instance By Group
AnimInstance
0
Что это
Pure-функция, возвращающая экземпляр анимационного слоя, привязанного к данному AnimInstance через группу (Group). Позволяет получить доступ к другому AnimInstance, подключенному как связанный слой, по имени группы, заданному в настройках слоя. Тип: pure (не требует exec-пинов).
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (Anim Instance Object Reference) — AnimInstance, от которого вызывается функция (self)
- In Group (Name) — имя группы, по которой ищется связанный слой
Выходы (данные):
- Return Value (Anim Instance Object Reference) — найденный экземпляр анимационного слоя, либо None, если слой с указанной группой не найден
Когда используется
- Для доступа к переменным и функциям другого AnimInstance, подключенного как linked anim layer (например, для управления BlendSpace или StateMachine из основного AnimBP).
- Для переключения или проверки активного слоя по группе в сложных анимационных системах (например, оружие, верхняя/нижняя часть тела).
Типичные проблемы
- Неверное имя группы — функция возвращает None, если имя группы не совпадает с настроенным в слое (регистрозависимо).
- Слой не привязан — если слой не подключен через Linked Anim Class или не активен, возвращается None, что может вызвать краш при попытке вызова методов на None.
- Путаница с GetLinkedAnimLayerInstanceByClass — эта функция ищет по классу, а не по группе; использование не той функции приводит к неожиданным результатам.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.