MediaStreamTrackGenerator: MediaStreamTrackGenerator() constructor

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

The MediaStreamTrackGenerator() constructor creates a new MediaStreamTrackGenerator object which consumes a stream of media frames and exposes a MediaStreamTrack.

Syntax

js
new MediaStreamTrackGenerator(options)

Parameters

options Experimental Non-standard

An object containing the property kind, which is one of the following strings:

"audio"

Specifies that the stream accepts AudioTrack objects.

"video"

Specifies that the stream accepts VideoTrack objects.

Exceptions

TypeError

Thrown if init.kind is not "video" or "audio".

Examples

In the following example a new video MediaStreamTrackGenerator is created.

js
const trackGenerator = new MediaStreamTrackGenerator({ kind: "video" });

Specifications

No specification found

No specification data found for api.MediaStreamTrackGenerator.MediaStreamTrackGenerator.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

See also