Convert to Animation State
AnimationStateMachineLibraryЧто это
Pure-функция, преобразующая структуру Animation State Result Reference в её составляющие — имя состояния, имя машины состояний и время пребывания в состоянии. Используется для извлечения данных из результата проверки состояния анимации, полученного от ноды Is In State или Get Active State.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Animation State (Animation State Result Reference) — ссылка на результат проверки состояния анимации
Выходы (данные):
- State Name (Name) — имя состояния анимации
- Machine Name (Name) — имя машины состояний
- State Duration (float) — время, проведённое в текущем состоянии (в секундах)
Когда используется
- После ноды
Is In StateилиGet Active State, когда нужно получить имя состояния или время пребывания в нём для дальнейшей логики (например, для выбора анимации перехода или проверки длительности проигрывания). - В кастомных функциях, анализирующих активное состояние анимационного графа.
Типичные проблемы
- Неверный тип входа: В пин
Animation Stateподаётся неAnimation State Result Reference, а другой тип (например,Animation State Reference). Функция не скомпилируется. - Пустая ссылка: Если
Animation Stateне был инициализирован (например, нодаIs In Stateне выполнялась), выходные пины вернут нулевые значения (пустое имя, 0.0), что может привести к неверной логике. - Игнорирование времени: Разработчики часто забывают использовать пин
State Duration, хотя он критичен для тайминговых проверок (например, «если состояние длится более 2 секунд, сделать X»).