Skip to content
Class

MediaStreamVideoTrackSource

Video source that encodes the frames of a MediaStreamVideoTrack and pipes them into the output. This is useful for capturing live or real-time data such as webcams or screen captures. Frames will automatically start being captured once the connected Output is started, and will keep being captured until the Output is finalized or this source is closed.

Extends: VideoSource

Constructor

ts
constructor(
	track: MediaStreamVideoTrack,
	encodingConfig: VideoEncodingConfig,
): MediaStreamVideoTrackSource;

Creates a new MediaStreamVideoTrackSource from a MediaStreamVideoTrack, which will pull video samples from the stream in real time and encode them according to VideoEncodingConfig.

Properties

errorPromise

ts
get errorPromise(): Promise<void>;

A promise that rejects upon any error within this source. This promise never resolves.

paused

ts
get paused(): boolean;

Whether this source is currently paused as a result of calling .pause().

Methods

pause()

ts
pause(): void;

Pauses the capture of video frames - any video frames emitted by the underlying media stream will be ignored while paused. This does not close the underlying MediaStreamVideoTrack, it just ignores its output.

resume()

ts
resume(): void;

Resumes the capture of video frames after being paused.

Released under the Mozilla Public License 2.0.