Appearance
Sequence runtime
component · /sequenceImmersiveSequencePlayer
Headless component that applies sampled snapshots to model, camera, controls, renderer exposure, environment intensity, and optional lights.
Key props
| Prop | Type | Description |
|---|---|---|
sequence | SequenceInput | Sequence config or payload |
modelRef | object ref | Pivot root to animate |
controlsRef | controls ref | OrbitControls-compatible target/update API |
play | boolean | Time-based playback |
progress | number | Deterministic progress |
loop | boolean | Loop override |
speed | number | Playback speed |
startTime | number | Initial seconds |
progressRef | mutable ref | Per-frame normalized progress output |
onFrame | callback | Throttled snapshot callback |
onComplete | callback | Non-looping completion callback |
Utilities
| Function | Purpose |
|---|---|
captureSnapshot(config) | Build a keyframe snapshot |
applySnapshot(config, snapshot) | Merge snapshot into config |
sampleSequence(sequence, time) | Interpolate at seconds |
upsertKeyframe(sequence, config) | Add or replace current-time keyframe |
createFovWarpSequence(config) | Generate starter warp timeline |
resolveSequence(input) | Unwrap config or payload |
sequenceProgressToTime(sequence, progress) | Map normalized progress to seconds |
sortedKeyframes(sequence) | Stable time ordering |