Current Time (ratio)
AnimInstanceЧто это
Pure-функция, возвращающая текущий прогресс (нормализованное время 0…1) анимации, воспроизводимой на указанном плеере (Asset Player Index). Позволяет узнать, на каком относительном этапе находится анимация (0 = начало, 1 = конец). Полезна для синхронизации событий, проверки выполнения анимации или отображения прогресс-баров.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (AnimInstance) — экземпляр анимационного блупринта (self)
- Asset Player Index (Integer) — индекс плеера анимации, полученный, например, из
TryGetInstanceAssetPlayerIndex
Выходы (данные):
- Return Value (Float) — нормализованное время (0.0 … 1.0). Для циклических анимаций значение может сбрасываться на 0 в конце цикла. Если плеер не активен или анимация не воспроизводится, возвращается 0.0.
Когда используется
- Проверка прогресса анимации для запуска кастомных событий (например, звук на 50% анимации).
- Синхронизация нескольких анимаций (сравнение нормализованного времени).
- Отображение прогресс-бара в UI или HUD.
- Условная логика в State Machine («если анимация дошла до 90%, переключиться на другую»).
Типичные проблемы
- Неверный индекс плеера: передача случайного или несуществующего индекса приведёт к возврату 0. Всегда получайте индекс через
GetInstanceAssetPlayerIndexилиTryGetInstanceAssetPlayerIndex. - Игнорирование цикла: для циклических анимаций значение может резко падать с 1 на 0 в конце цикла. Если нужен непрерывный счётчик (например, от 0 до 2 за два цикла), используйте
GetInstanceAssetPlayerTime(абсолютное время). - Некорректная обработка 0: если плеер выключен (например, анимация не инициализирована), функция всё равно возвращает 0 — не путайте это с началом анимации. Проверьте
IsPlayingилиIsValidперед использованием.