TimelineMediaQueries (core) API

Signature

Interface TimelineMediaQueries

Methods

Name	Signature	Description
`getActiveClip`	`getActiveClip(query: ActiveClipQuery = {}): ActiveClip<string> \| undefined`	Returns the first active clip matching an active layer query.
`getActiveClips`	`getActiveClips(time: RationalTime = ...): ActiveClip<string>[]`	Returns enabled clips under a timeline time, ordered by track and clip order. Hidden or muted tracks and disabled clips are excluded so preview and playback integrations can pick sources using the same visibility rules. Clip intervals are half-open: active at `timelineStart` and inactive at `timelineEnd`.
`getActiveClipsByTrack`	`getActiveClipsByTrack(time: RationalTime = ...): Map<string, ActiveClip<string>[]>`	Groups active clips by containing track id.
`getActiveLayers`	`getActiveLayers(options: ActiveLayerOptions<LayerName>): ActiveLayerResult<LayerName>`	Finds the clips active at a timeline time and groups them by named layer selectors. Use this for preview, playback, subtitle, and effect integrations that need to know which layer clips should be rendered or synced at the playhead. Hidden or muted tracks and disabled clips are excluded. The result preserves every match in `layers`, deduplicates matches in `all`, and exposes `primary` as a first-match convenience for each requested layer.
`getClipSourceRange`	`getClipSourceRange(clipIdOrClip: string \| object): ClipSourceRange \| undefined`	Computes the source-media range covered by a clip.
`getClipSyncKey`	`getClipSyncKey(clipIdOrClip: string \| object): string \| undefined`	Returns a stable media sync signature for timing-affecting clip fields.
`getFirstContentTime`	`getFirstContentTime(options: FirstContentTimeOptions<LayerName>): RationalTime \| undefined`	Finds the earliest clip start matching any requested layer.
`sourceTimeToTimelineTime`	`sourceTimeToTimelineTime(clipIdOrClip: string \| object, sourceTime: RationalTime): RationalTime \| undefined`	Maps a source-media timestamp within a clip back to timeline time.
`timelineTimeToSourceTime`	`timelineTimeToSourceTime(clipIdOrClip: string \| object, timelineTime: RationalTime = ...): RationalTime \| undefined`	Maps a timeline timestamp within a clip to the matching source-media time.