Play Animation with Finished event
WidgetAnimationPlayCallbackProxy
0
Что это
Асинхронная (latent) нода для воспроизведения анимации виджета с автоматическим вызовом события Completed после завершения анимации. Возвращает прокси-объект, который можно использовать для дополнительной привязки событий, но обычно достаточно встроенного выхода Completed.
Пины
Exec-входы:
- Execute (exec) — запуск воспроизведения
Exec-выходы:
- Completed (exec) — срабатывает, когда анимация завершена (в том числе после всех циклов)
Входы (данные):
- Widget (User Widget Object) — виджет, на котором воспроизводится анимация
- Animation (Widget Animation Object) — анимация, которую нужно воспроизвести
- Start At Time (float) — время начала анимации (в секундах)
- Number of Loops (int) — количество повторений (0 — не воспроизводится, -1 — бесконечно)
- Playback Speed (float) — скорость воспроизведения (1.0 — нормальная)
- Restore State (bool) — если true, после остановки анимации состояние виджета возвращается к исходному
Выходы (данные):
- Return Value (Widget Animation Play Callback Proxy Object Reference) — ссылка на созданный прокси-объект (обычно не используется, так как событие Completed уже подключено)
Когда используется
- Воспроизведение анимации интерфейса (появление, исчезновение, акценты) с необходимостью выполнить действие сразу после её окончания.
- Циклические анимации с ограниченным числом повторений, после которых нужно переключить состояние виджета.
Типичные проблемы
- Не подключён выход Completed — разработчик не знает, когда анимация закончилась, и не может выполнить последующие действия.
- Restore State включён без необходимости — анимация сбрасывает изменения виджета после завершения, что может быть неожиданно, если вы хотели оставить финальное состояние.
- Number of Loops = 0 — анимация не воспроизводится ни разу, и Completed срабатывает сразу (пустой цикл).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.