Play Animation Time Range with Finished event
WidgetAnimationPlayCallbackProxyЧто это
Async-нода для воспроизведения анимации виджета (UMG) в заданном временном диапазоне с событием по завершении. Позволяет запустить анимацию с указанием начального и конечного времени, количества циклов, режима и скорости воспроизведения. Относится к типу async (latent): выполнение приостанавливается до завершения анимации.
Пины
Exec-входы:
- Execute (exec) — запуск воспроизведения анимации.
Exec-выходы:
- Then (exec) — срабатывает сразу после вызова (до завершения анимации).
- Completed (exec) — срабатывает после полного завершения анимации (с учётом циклов).
Входы (данные):
- World Context Object (UObject*) — контекст мира (обычно self или GameInstance).
- Widget (UUserWidget*) — виджет, содержащий анимацию.
- In Animation (UWidgetAnimation*) — анимация для воспроизведения.
- Start at Time (float) — начальное время анимации (в секундах).
- End at Time (float) — конечное время анимации (в секундах).
- Num Loops to Play (int32) — количество циклов воспроизведения (0 = бесконечно? обычно 1).
- Play Mode (EUMGSequencePlayMode::Type) — режим воспроизведения (Forward, Reverse, PingPong).
- Play Speed (float) — скорость воспроизведения (1.0 = нормальная).
Выходы (данные):
- нет (void) — данные не возвращаются, только exec-события.
Когда используется
Для воспроизведения анимации UMG с точным контролем временного отрезка и обязательной реакцией на окончание (например, скрыть виджет после завершения анимации). Удобно для последовательностей анимаций, где нужно дождаться окончания перед следующим действием.
Типичные проблемы
- Неправильный Play Mode: при Reverse или PingPong анимация может воспроизводиться не так, как ожидается, если не учесть направление.
- Start at Time > End at Time: если начальное время больше конечного, анимация может не воспроизвестись или воспроизвестись в обратном направлении (зависит от Play Mode).
- Num Loops to Play = 0: в некоторых версиях движка 0 означает бесконечный цикл, что приведёт к тому, что Completed никогда не сработает. Рекомендуется явно указывать 1 для однократного воспроизведения.