ue-sequencer-cinematics
Use when playing Level Sequences from C++, building cutscenes or in-game camera moments, binding actors to sequence tracks at runtime, wiring Sequencer event tracks, or rendering with Movie Render Graph. Also use when the user mentions 'Sequencer', 'LevelSequence', 'ALevelSequenceActor', 'ULevelSequencePlayer', 'CreateLevelSequencePlayer', 'cutscene', 'camera cut', 'event track', 'ULevelSequenceDirector', 'SetBindingByTag', 'spawnable', 'possessable', 'CineCamera', 'Movie Render Queue', or 'MRQ'. For animation tracks, see ue-animation-system; for gameplay cameras and shakes, see ue-gameplay-cameras; for sequence audio, see ue-audio-system.
quodsoler · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add quodsoler/unreal-engine-skills --skill ue-sequencer-cinematics技能说明
name: ue-sequencer-cinematics description: "Use when playing Level Sequences from C++, building cutscenes or in-game camera moments, binding actors to sequence tracks at runtime, wiring Sequencer event tracks, or rendering with Movie Render Graph. Also use when the user mentions 'Sequencer', 'LevelSequence', 'ALevelSequenceActor', 'ULevelSequencePlayer', 'CreateLevelSequencePlayer', 'cutscene', 'camera cut', 'event track', 'ULevelSequenceDirector', 'SetBindingByTag', 'spawnable', 'possessable', 'CineCamera', 'Movie Render Queue', or 'MRQ'. For animation tracks, see ue-animation-system; for gameplay cameras and shakes, see ue-gameplay-cameras; for sequence audio, see ue-audio-system." metadata: version: "2.0.0" engine: "5.8"
UE Sequencer and Cinematics
Target engine: UE 5.8. APIs below are verified against the 5.8 headers; older forms are listed under "Deprecated — do not use".
Sequencer spans three runtime modules plus a plugin. MovieScene holds the data model and the player base class, MovieSceneTracks holds the concrete track and section types, LevelSequence holds the asset, actor, player and director, and CinematicCamera holds the cine camera and camera rigs. Offline rendering lives in the Movie Render Queue plugin (MovieRenderPipelineCore for runtime, MovieRenderPipelineEditor for the editor queue UI); it is disabled by default and must be enabled in the .uproject.
Context
Read .agents/ue-project-context.md if it exists (module names, conventions, enabled plugins, GAS/networking setup). Do not stop if it is missing.
Identify the area from the request and the codebase. Ask only when two plausible readings would produce different code.
| Request is about… | Go to |
|---|---|
| Which modules to add to Build.cs | Build.cs Modules |
| What C++ can do at runtime vs editor-only | Runtime vs Editor |
| Starting, stopping, seeking, looping a sequence | Playing a Level Sequence |
| Pointing sequence tracks at gameplay actors | Binding Actors at Runtime |
| Calling C++ from a key on the timeline | Sequencer Event Tracks |
| Tracks, sections, sub-sequences, frame math | MovieScene Data Model |
| Cine camera setup, focus, rails and cranes | Cine Cameras and Camera Rigs |
| Rendering frames or video to disk | Movie Render Graph |
| Full worked cutscene, multiplayer and rig examples | Sequencer runtime patterns |
Build.cs Modules
PublicDependencyModuleNames.AddRange(new string[]
{
"LevelSequence", // ULevelSequence, ALevelSequenceActor, ULevelSequencePlayer, ULevelSequenceDirector
"MovieScene", // UMovieScene, UMovieSceneSequencePlayer, FMovieSceneObjectBindingID
"MovieSceneTracks", // UMovieSceneEventTrack, UMovieSceneCameraCutTrack, property tracks
"CinematicCamera", // ACineCameraActor, UCineCameraComponent, ACameraRig_Rail, ACameraRig_Crane
});
// Offline rendering only. Requires the MovieRenderPipeline plugin enabled in the .uproject.
PrivateDependencyModuleNames.Add("MovieRenderPipelineCore");
Runtime vs Editor
Authoring a sequence is an editor operation. Shipping game code plays and re-binds sequences; it does not build them.
| Task | API | Availability |
|---|---|---|
| Play, stop, seek, set play rate | UMovieSceneSequencePlayer | Runtime |
| Override which actors a binding resolves to | ALevelSequenceActor::SetBinding* | Runtime |
| Read tracks, bindings, frame rates | UMovieScene getters, UMovieSceneSequence::GetMovieScene | Runtime |
| Call C++ from the timeline | ULevelSequenceDirector subclass | Runtime |
| Queue and run a render | UMoviePipelineQueueEngineSubsystem (UEngineSubsystem) | Runtime |
| Add actors, cameras, spawnables to a sequence | ULevelSequenceEditorSubsystem (UEditorSubsystem) | Editor only |
| Scripted track/section creation and keying | UMovieSceneSequenceExtensions (Runtime module of the Beta SequencerScripting plugin) | Editor scripting — mutates assets |
| Register a custom track editor | ISequencerModule::RegisterTrackEditor | Editor only |
| Drive the Movie Render Queue window | UMoviePipelineQueueSubsystem (UEditorSubsystem) | Editor only |
UMovieScene::AddTrack and UMovieSceneSubTrack::AddSequence do compile into runtime builds, but they mutate the sequence asset. Call them only from editor tooling or commandlets — a cooked ULevelSequence must not be edited in a shipped game.
Playing a Level Sequence
From a placed ALevelSequenceActor
#include "LevelSequenceActor.h"
// LevelSequenceActor.h:153 — UFUNCTION(BlueprintGetter) ULevelSequencePlayer* GetSequencePlayer() const;
if (ULevelSequencePlayer* Player = SeqActor->GetSequencePlayer())
{
Player->Play();
}
Useful ALevelSequenceActor members: PlaybackSettings, LevelSequenceAsset, BindingOverrides, DefaultInstanceData, bOverrideInstanceData, bReplicatePlayback, GetSequence(), SetSequence(), SetReplicatePlayback(). Auto-play is PlaybackSettings.bAutoPlay; the actor's own bAutoPlay field no longer exists. AReplicatedLevelSequenceActor is a subclass that is always net-relevant.
Spawning a player at runtime
#include "LevelSequencePlayer.h"
#include "MovieSceneSequencePlaybackSettings.h"
// LevelSequencePlayer.h:106
// static ULevelSequencePlayer* CreateLevelSequencePlayer(
// UObject* WorldContextObject, ULevelSequence* LevelSequence,
// FMovieSceneSequencePlaybackSettings Settings, ALevelSequenceActor*& OutActor);
FMovieSceneSequencePlaybackSettings Settings;
Settings.bAutoPlay = false;
Settings.PlayRate = 1.0f;
Settings.StartTime = 0.0f; // seconds into the playback range
Settings.LoopCount.Value = 0; // 0 = once, -1 = in
阅读完整来源 ↗