Interface

UseTimelineMediaSyncResult

Result returned by `useTimelineMediaSync`.

Usage notes

Use the commands in this result for media-aware transport controls. The `activeLayers` snapshot is useful for custom status panels, preview badges, and adapter diagnostics.

Signature

Type Definition
Interface UseTimelineMediaSyncResult

Type parameters

NameConstraintDefaultDescription
LayerNamestringstringNamed media layer keys from UseTimelineMediaSyncOptions.layers.

Properties

NameSignatureDescription
activeLayersactiveLayers: ActiveLayerResult<LayerName>Active layers at the current playhead time.
pause(): TimelineCommandResultStops synchronized timeline/media playback and pauses external media state.
play(): Promise<TimelineMediaPlayResult>Starts external media playback and then advances the timeline from that clock.
playbackRateplaybackRate: numberCurrent synchronized playback speed multiplier.
playingplaying: booleanWhether synchronized timeline and external media playback is currently running.
setPlaybackRate(playbackRate: number): TimelineCommandResultUpdates both the external clock rate and the timeline playback rate.