Set Start Position
SequencePlayerLibraryЧто это
Set Start Position — exec-функция библиотеки SequencePlayerLibrary, устанавливающая начальную позицию (в секундах) проигрывателя последовательности (Sequence Player). Она изменяет точку, с которой начнётся воспроизведение при следующем запуске или перемотке (Seek). Используется для прыжка на определённый момент анимации / кат-сцены без сброса текущего состояния.
Пины
Exec-входы:
- execute (exec) — запуск установки позиции
Exec-выходы:
- then (exec) — продолжение выполнения после установки
Входы (данные):
- Target (Sequence Player Reference) — ссылка на проигрыватель последовательности (объект, к которому применяется команда)
- Start Position (Float) — позиция в секундах, которую требуется установить
Выходы (данные):
- нет (void)
Когда используется
В сценариях, где нужно перемотать кат-сцену, анимацию или трек на определённую метку, например, для синхронизации с другими событиями (звук, VFX). Полезна при реализации системы пропуска или возврата к контрольной точке в последовательностях.
Типичные проблемы
- Неинициализированный Sequence Player — вызов функции до того, как ссылка Target была получена (например, через Create Sequence Player или из переменной) приведёт к ошибке выполнения.
- Значение за пределами длительности — передача отрицательного числа или числа, превышающего длину последовательности, может вызвать неоднозначное поведение (часто игнорируется или устанавливается на границы).
- Путаница единиц — случайная передача целого числа вместо Float (в BP автоматически не преобразуется, вызов не скомпилируется или приведёт к неожиданной позиции).