Get Relevant Anim Time Remaining Fraction
AnimationStateMachineLibrary
0
Что это
Pure-функция из библиотеки Animation State Machine. Возвращает долю (0..1) оставшегося времени проигрывания текущей релевантной анимации для указанного состояния в заданной машине состояний анимации. Полезна для синхронизации событий или переходов по прогрессу анимации.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (Anim Instance Object Reference) — анимационный блюпринт, в котором выполняется поиск
- MachineName (Name) — имя машины состояний анимации (обычно задаётся в редакторе анимаций)
- StateName (Name) — имя состояния внутри машины, для которого нужно получить оставшуюся долю времени
Выходы (данные):
- ReturnValue (float) — оставшаяся доля времени (0.0 = анимация закончилась, 1.0 = только началась)
Когда используется
- Для создания плавных переходов по прогрессу анимации (например, когда анимация достигла 70%).
- Для синхронизации звуков, VFX или других событий с определённой фазой анимации.
- В условиях перехода между состояниями (например, «если оставшаяся доля < 0.3, то переключиться»).
Типичные проблемы
- Неверное имя машины или состояния — если MachineName или StateName не совпадают с именами, заданными в анимационном блюпринте, функция вернёт 0.0 без предупреждения.
- Использование вне контекста анимационного блюпринта — функция работает только внутри анимационного графа; вызов из других классов (например, из персонажа) приведёт к нулевому результату.
- Путаница с «оставшимся временем» и «долей» — функция возвращает именно долю (0..1), а не абсолютное время в секундах. Для абсолютного времени используйте
GetRelevantAnimTimeRemaining.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.