Restore State
MovieSceneSequencePlayerЧто это
Restore State — исполняемая функция (exec) класса MovieSceneSequencePlayer. Принудительно восстанавливает исходное состояние всех объектов, изменённых последовательностью, возвращая их к значениям до начала воспроизведения. Используется для отката изменений, если bRestoreState отключён или требуется ручной контроль восстановления.
Пины
Exec-входы:
- execute (exec) — запуск восстановления
Exec-выходы:
- then (exec) — продолжение выполнения после восстановления
Входы (данные):
- Target (MovieSceneSequencePlayer Object Reference) — экземпляр плеера, чьё состояние нужно восстановить
Выходы (данные):
- нет (void)
Когда используется
- После остановки плеера (
Stop) вручную вернуть объекты к исходному состоянию, если автоматическое восстановление (bRestoreState) отключено. - При перезапуске последовательности, чтобы сбросить накопленные изменения перед повторным проигрыванием.
- В кастомной логике управления временной шкалой (например, для отката по отмене действия).
Типичные проблемы
- Вызов до остановки плеера:
RestoreStateможет работать некорректно, если плеер всё ещё воспроизводит секцию; рекомендуется вызывать только послеStopили при паузе после завершения. - Динамически созданные объекты: если объекты не привязаны к треку в момент захвата начального состояния, их позиции/свойства не будут восстановлены — нужно сохранять вручную.
- Отключённый
bRestoreState: плеер по умолчанию не сохраняет состояние, если флаг не включён в настройках; вызовRestoreStateбез предварительного сохранения (черезSet bRestoreState= true) не даст эффекта.