Usage notes
This adapter is intentionally small: it maps the first active clip from the
configured layers to a native `<video>` or `<audio>` element, seeks the
element to the clip's source time, and lets the element clock drive timeline
playback. Use it for simple browser-native previews before reaching for a
frame-accurate decoded adapter.
Signature
Interface HTMLMediaAdapterProperties
| Name | Signature | Description |
|---|---|---|
dispose | (): void | Release object URLs and pause the media element. |
getClockTime | (): number | Read the external clock in timeline seconds. |
muted | muted: boolean | Whether native media element output is muted. |
onStatus? | (status: TimelineContentPlaybackStatus): void | Observe high-level synchronized playback status changes. |
replaceSource | (source: HTMLMediaSource): Promise<TimelineMediaSourceOperationResult> | Replace one resolved source without recreating the adapter. |
requestClockActivation? | (playbackRate: number): void | Begin browser-gated clock or audio activation without blocking visual transport. |
retrySource | (sourceId: string): Promise<TimelineMediaSourceOperationResult> | Retry one source from its preferred input and report that native loading was configured. |
seek? | (timelineTime: RationalTime, activeLayers: ActiveLayerResult<string>): MaybePromise<void> | Seek the external surface to a timeline position and its active clips. |
setClockRate? | (playbackRate: number): void | Apply a playback-rate change to the running external clock. |
setMuted | (muted: boolean): void | Update native element mute state without reloading the active source. |
setSources | (sources: typeOperator): void | Reconcile the complete logical source registry without recreating the adapter. |
setVolume | (volume: number): void | Update native element volume without reloading the active source. |
sourceStateById | sourceStateById: ReadonlyMap<string, HTMLMediaSourceState> | Immutable source snapshot replaced whenever observable lifecycle state changes. |
startClock | (timelineTime: RationalTime, playbackRate: number): MaybePromise<boolean> | Start the external clock at a timeline position and playback-rate multiplier. |
stopClock? | (): void | Stop the external clock without disposing its loaded media. |
syncLayers? | (details: TimelineLayerSyncDetails<string>): MaybePromise<void> | Render or schedule the active media layers for a transport transition. |
volume | volume: number | Current native media element volume from 0 to 1. |