Eve library

Sequencer Core Guide

Guide

Revision 1

On this page

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#

  • evaluateSequencerKeyframes supports step, linear, and cubic-bezier interpolation for scalar and vector values.
  • createActorBindingMap and rebindSequencerActors make authored sequences reusable across scenes.
  • createSequencerBlendPlan describes camera and player-control blending around gameplay.
  • selectSequencerLod chooses full, skipped, or substitute playback based on repeat count and gameplay-critical context.
  • shouldTriggerSequence evaluates area, interaction, and event triggers.
  • serializeSequencerSequence and restoreSequencerSequence persist authored data.
  • createSequencerNetworkSnapshot and applySequencerNetworkSnapshot synchronize playback time and state across clients.