Interface

UseTimelineMediaSyncOptions

Options for high-level timeline media synchronization.

Usage notes

The `layers` record names the media outputs your adapter can synchronize. Those names flow through `LayerName`, allowing `activeLayers.primary.visuals` or `activeLayers.layers.audio` to stay typed from the same object. Each value is an ActiveLayerSelector passed through active layer lookup before adapter callbacks receive an ActiveLayerResult.

Signature

Type Definition
Interface UseTimelineMediaSyncOptions

Type parameters

NameConstraintDefaultDescription
LayerNamestringstringNamed media layer keys inferred from `layers`.

Properties

NameSignatureDescription
adapteradapter: TimelineMediaSyncAdapter<LayerName>External media adapter callbacks.
frameRate?frameRate?: TimecodeFrameRateOptional sequence frame rate used to lock media playback to project frames.
layerslayers: Record<LayerName, ActiveLayerSelector>Named active layer selectors used by the external media surface.
onError?(message: string): voidCalled when no content exists or no active layer clip is available.
ready?ready?: booleanWhether the external media adapter is loaded and ready to play.