Get Length
AnimSingleNodeInstance
0
Что это
Pure-функция, возвращающая общую длину анимации (в секундах) для текущего анимационного ассета, загруженного в AnimSingleNodeInstance. Полезна для расчёта времени проигрывания, синхронизации или проверки завершения анимации.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (AnimSingleNodeInstance Object Reference) — экземпляр анимации, для которого запрашивается длина.
Выходы (данные):
- Return Value (float) — длина анимации в секундах.
Когда используется
- Для определения времени окончания анимации в логике состояний (State Machine) или при кастомном управлении временем.
- Для расчёта прогресса анимации (текущее время / длина).
- Для синхронизации нескольких анимаций или событий с длительностью клипа.
Типичные проблемы
- Вызов на
null-ссылке (неинициализированномAnimInstance) — приведёт к крашу. Всегда проверяйтеIs Validперед вызовом. - Функция возвращает
0для анимаций с нулевой длиной (например, пустой Sequence) — это может быть неочевидно при отладке. - Не учитывает скорость воспроизведения (Play Rate) — возвращает исходную длину ассета, а не фактическое время проигрывания.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.