Set Timer by Event
KismetSystemLibrary
0
Что это
Exec-функция, которая создаёт таймер с привязкой к делегату (событию). Позволяет выполнить произвольный граф действий с задержкой, повторением и начальной задержкой. Не является pure-функцией: имеет exec-вход и несколько exec-выходов.
Пины
Exec-входы:
- Execute (exec) — запуск установки таймера.
Exec-выходы:
- Then (exec) — срабатывает сразу после установки таймера (до первого срабатывания).
- Completed (exec) — срабатывает каждый раз, когда таймер «тикает» (для нециклических — один раз по истечении времени).
Входы (данные):
- Event (Delegate) — делегат, который будет вызван по срабатыванию таймера. В редакторе подключается ссылка на событие или создаётся привязка.
- Time (float) — интервал между срабатываниями (в секундах).
- Looping (bool) — если true, таймер повторяется бесконечно; если false — срабатывает один раз.
- Initial Start Delay (float) — задержка перед первым срабатыванием (по умолчанию 0).
- Initial Start Delay Variance (float) — вариация начальной задержки (добавляет случайный разброс).
- Ignore Time Dilation (bool) — если true, таймер не зависит от глобального замедления/ускорения времени.
Выходы (данные):
- Timer Handle (TimerHandle) — хендл созданного таймера. Можно использовать для его остановки, паузы или проверки активности.
Когда используется
- Выполнение действия с задержкой (например, анимация, спавн, смена состояния).
- Циклические процессы с фиксированным интервалом (периодическая проверка, регенерация).
- Отложенный запуск с возможностью отмены через Timer Handle.
Типичные проблемы
- Не привязан делегат — если к пину Event ничего не подключено, таймер не вызовет никакой код. Всегда проверяйте, что делегат указывает на существующее событие.
- Забытый Initial Start Delay — при ненулевом значении первое срабатывание произойдёт не сразу, а через указанное время. Если это не учтено, логика может сдвинуться.
- Путаница между Looping и Completed — для нециклического таймера Completed срабатывает один раз, для циклического — каждый интервал. Не используйте Looping, если нужно однократное выполнение.
- Timer Handle не сохраняется — если не сохранить выходной хендл в переменную, вы не сможете остановить или изменить таймер впоследствии.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.