Get Timer Elapsed Time by Handle
KismetSystemLibrary
0
Что это
Pure-функция, возвращающая время в секундах, прошедшее с момента запуска таймера по его дескриптору (Timer Handle). Позволяет получить elapsed time без привязки к конкретному объекту или имени функции — достаточно handle, полученного при установке таймера.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Handle (Timer Handle) — дескриптор целевого таймера.
Выходы (данные):
- ReturnValue (float) — прошедшее время в секундах. Если таймер не активен или handle недействителен, возвращает
-1.0.
Когда используется
- Для отслеживания оставшегося времени или длительности работы таймера, когда handle уже сохранён.
- В UI-виджетах (прогресс-бары, таймеры обратного отсчёта) или в логике состояний, где нужно знать, сколько времени прошло с момента старта.
Типичные проблемы
- Недействительный handle – если handle был получен от таймера, который уже очищен или не был установлен, функция вернёт
-1.0. Рекомендуется предварительно проверять активность таймера черезIs Timer Active by Handle. - Путаница с версией без Handle –
Get Timer Elapsed Time(по Object + FunctionName) иGet Timer Elapsed Time by Handle(по handle) — разные ноды. Использование не той версии приводит к ошибкам компиляции или неверным результатам. - Игнорирование возвращаемого значения – функция pure, её результат можно использовать непосредственно в выражениях (например, в
BranchилиFormat Text), но если выход не подключён, вызов теряет смысл.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.