Usage notes
Use `ActiveClipQuery` when an integration needs one matching clip, such as a
focused preview thumbnail, inspector, subtitle renderer, or source-specific
media control. For named multi-layer playback surfaces, prefer
ActiveLayerOptions and TimelineEngine.getActiveLayers.
Signature
Interface ActiveClipQueryType parameters
| Name | Constraint | Default | Description |
|---|---|---|---|
TrackKind | None | string | App-defined track kind values used by your timeline,
such as `"visual"`, `"audio"`, or `"subtitle"`. |
Properties
| Name | Signature | Description |
|---|---|---|
predicate? | (activeClip: ActiveClip<TrackKind>): boolean | Optional app predicate for custom selection logic. |
sourceId? | sourceId?: string | Source asset id to match. |
time? | time?: RationalTime | Timeline time to inspect. Defaults to the current playhead. |
trackKind? | trackKind?: TrackKind | App-defined track kind to match, such as "visual", "audio", or "subtitle". |