# Sequencer Core Guide

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.
