Set Timer by Function Name
KismetSystemLibraryЧто это
Устанавливает таймер, который по истечении заданного времени вызывает указанную функцию (по имени) на заданном объекте. Может работать как одноразово, так и циклически. Это exec-функция (не pure, не latent): сразу возвращает Timer Handle, а выполнение продолжается по Then, сам таймер работает в фоне.
Пины
Exec-входы:
- execute (exec) — запуск установки таймера
Exec-выходы:
- then (exec) — выполняется сразу после установки таймера (не после его срабатывания)
Входы (данные):
- Target (Object) — объект, на котором будет вызвана функция (если None, то self)
- Function Name (Name) — имя вызываемой функции (должна быть объявлена как BlueprintCallable)
- Time (float) — время в секундах до первого срабатывания (или между циклами при bLooping=true)
- bLooping (bool) — если true, таймер повторяется бесконечно; если false — срабатывает один раз
- Initial Start Delay (float) — дополнительная задержка перед первым запуском (по умолчанию 0)
- Initial Start Delay Variance (float) — случайная вариация начальной задержки (по умолчанию 0)
- Timer Kind (ETimerKind) — тип таймера (обычно «Timer» — зависит от мира; редко меняется)
Выходы (данные):
- Return Value (Timer Handle) — хендл созданного таймера (можно использовать для остановки или проверки)
Когда используется
- Для создания периодических действий (например, обновление состояния, спавн объектов через интервал).
- Для одноразовой отложенной логики (задержка без блокировки основного потока, с возможностью отмены).
- Когда функция, которую нужно вызвать по таймеру, известна по имени (например, динамически из строки).
Типичные проблемы
- Function Name указан неверно (опечатка или различие в регистре) — функция просто не будет вызвана. Имя должно точно совпадать с именем UFUNCTION в Blueprint.
- Потеря Timer Handle — если не сохранить возвращаемое значение, таймер нельзя будет остановить или изменить досрочно.
- Забыли bLooping — если нужно повторение, но флаг не установлен, таймер сработает только один раз, что может быть неожиданным.
- Initial Start Delay > Time при bLooping=true — таймер начнёт повторяться только после Initial Start Delay, а затем каждые Time секунд. Если нужны равные интервалы, обе задержки должны совпадать или Initial Start Delay = 0.