MediaStreamTrackGenerator

Experimental:This is anexperimental technology
Check theBrowser 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.

Note:Consider usingVideoTrackGenerator instead.

TheMediaStreamTrackGenerator interface of theInsertable Streams for MediaStreamTrack API creates aWritableStream that acts as aMediaStreamTrack source.The object consumes a stream of media frames as input, which can be audio or video frames.

Constructor

MediaStreamTrackGenerator()Experimental Non-standard: Creates a newMediaStreamTrackGenerator object which accepts either VideoFrame orAudioData objects.

Instance properties

This interface also inherits properties fromMediaStreamTrack.

MediaStreamTrackGenerator.writableExperimental Non-standard: A WritableStream.

Instance methods

This interface doesn't implement any specific methods, but inherits methods fromMediaStreamTrack.

Examples

The following example is from the articleInsertable streams for MediaStreamTrack, and demonstrates a barcode scanner application, which process barcodes and highlights them before writing the transformed frames to the writable stream ofMediaStreamTrackGenerator.writable.

const stream = await getUserMedia({ video: true });const videoTrack = stream.getVideoTracks()[0];const trackProcessor = new MediaStreamTrackProcessor({ track: videoTrack });const trackGenerator = new MediaStreamTrackGenerator({ kind: "video" });const transformer = new TransformStream({  async transform(videoFrame, controller) {    const barcodes = await detectBarcodes(videoFrame);    const newFrame = highlightBarcodes(videoFrame, barcodes);    videoFrame.close();    controller.enqueue(newFrame);  },});trackProcessor.readable  .pipeThrough(transformer)  .pipeTo(trackGenerator.writable);