The sequencer core in @aphrodite/cinematic-camera provides a renderer-neutral
runtime for cinematic playback and synchronized multiplayer timing.
Sequence Model#
defineSequencerSequence creates a sequence with tracks, actor bindings,
gameplay blend settings, LOD rules, triggers, and metadata. Track kinds cover
property animation, skeletal animation clips, audio cues, gameplay events,
camera keyframes/cuts/rails, and nested sub-sequences.
Playback and Evaluation#
Use createSequencerPlaybackState, playSequence, pauseSequence,
scrubSequence, stopSequence, and updateSequencerPlayback to run timelines
with looping, reverse playback, and variable speed.
evaluateSequencerSequence samples the timeline at a time and returns property
values, active animation clips, active audio cues, fired events, active camera
state, active camera cut, and sub-sequence local times.
Runtime Integration#
evaluateSequencerKeyframessupports step, linear, and cubic-bezier interpolation for scalar and vector values.createActorBindingMapandrebindSequencerActorsmake authored sequences reusable across scenes.createSequencerBlendPlandescribes camera and player-control blending around gameplay.selectSequencerLodchooses full, skipped, or substitute playback based on repeat count and gameplay-critical context.shouldTriggerSequenceevaluates area, interaction, and event triggers.serializeSequencerSequenceandrestoreSequencerSequencepersist authored data.createSequencerNetworkSnapshotandapplySequencerNetworkSnapshotsynchronize playback time and state across clients.