WebIDLpedia

Definition

Media Capture and Streams defines MediaStreamTrack

[Exposed=Window]
interface MediaStreamTrack : EventTarget {
  readonly attribute DOMString kind;
  readonly attribute DOMString id;
  readonly attribute DOMString label;
  attribute boolean enabled;
  readonly attribute boolean muted;
  attribute EventHandler onmute;
  attribute EventHandler onunmute;
  readonly attribute MediaStreamTrackState readyState;
  attribute EventHandler onended;
  MediaStreamTrack clone();
  undefined stop();
  MediaTrackCapabilities getCapabilities();
  MediaTrackConstraints getConstraints();
  MediaTrackSettings getSettings();
  Promise<undefined> applyConstraints(optional MediaTrackConstraints constraints = {});
};

This interface is extended in the following specifications:

• Media Capture and Streams Extensions

  
  
  [Exposed=(Window,DedicatedWorker), Transferable]
  partial interface MediaStreamTrack {
  };
  
  partial interface MediaStreamTrack {
    [SameObject] readonly attribute
        (MediaStreamTrackAudioStats or MediaStreamTrackVideoStats)? stats;
  };
  
  partial interface MediaStreamTrack {
    attribute EventHandler onconfigurationchange;
  };

• The Capture-Handle Actions Mechanism

  
  
  partial interface MediaStreamTrack {
    sequence<DOMString> getSupportedCaptureActions();
    Promise<undefined> sendCaptureAction(CaptureAction action);
  };

• Capture Handle - Bootstrapping Collaboration when Screensharing

  
  
  partial interface MediaStreamTrack {
    CaptureHandle? getCaptureHandle();
  };
  
  partial interface MediaStreamTrack {
    attribute EventHandler oncapturehandlechange;
  };

• MediaStreamTrack Content Hints

  partial interface MediaStreamTrack {
    attribute DOMString contentHint;
  };

• Identity for WebRTC 1.0

  
  
  partial interface MediaStreamTrack {
      readonly        attribute boolean      isolated;
                      attribute EventHandler onisolationchange;
  };

[Exposed=Window]
interface MediaStreamTrack : EventTarget {
  readonly attribute DOMString kind;
  readonly attribute DOMString id;
  readonly attribute DOMString label;
  attribute boolean enabled;
  readonly attribute boolean muted;
  attribute EventHandler onmute;
  attribute EventHandler onunmute;
  readonly attribute MediaStreamTrackState readyState;
  attribute EventHandler onended;
  MediaStreamTrack clone();
  undefined stop();
  MediaTrackCapabilities getCapabilities();
  MediaTrackConstraints getConstraints();
  MediaTrackSettings getSettings();
  Promise<undefined> applyConstraints(optional MediaTrackConstraints constraints = {});
  [SameObject] readonly attribute
      (MediaStreamTrackAudioStats or MediaStreamTrackVideoStats)? stats;
  attribute EventHandler onconfigurationchange;
  sequence<DOMString> getSupportedCaptureActions();
  Promise<undefined> sendCaptureAction(CaptureAction action);
  CaptureHandle? getCaptureHandle();
  attribute EventHandler oncapturehandlechange;
  attribute DOMString contentHint;
    readonly        attribute boolean      isolated;
                    attribute EventHandler onisolationchange;
};

Methods and attributes that return objects implementing MediaStreamTrack

• HTMLCameraElement.track
• HTMLMicrophoneElement.track
• ImageCapture.track
• MediaStream.getAudioTracks()
• MediaStream.getVideoTracks()
• MediaStream.getTracks()
• MediaStream.getTrackById()
• MediaStreamTrack.clone()
• MediaStreamTrackEvent.track
• VideoTrackGenerator.track
• RTCRtpSender.track
• RTCRtpReceiver.track
• RTCTrackEvent.track

Referring IDL interfaces/dictionaries

• AudioContext
• BrowserCaptureMediaStreamTrack
• CanvasCaptureMediaStreamTrack
• HTMLCameraElement
• HTMLMicrophoneElement
• ImageCapture
• MediaStream
• MediaStreamTrack
• MediaStreamTrackAudioSourceOptions
• MediaStreamTrackEvent
• MediaStreamTrackEventInit
• MediaStreamTrackHandle
• RTCPeerConnection
• RTCRtpReceiver
• RTCRtpSender
• RTCTrackEvent
• RTCTrackEventInit
• SpeechRecognition
• VideoTrackGenerator

Referring specifications

• Media Capture and Streams Extensions refers to MediaStreamTrack
• The Capture-Handle Actions Mechanism refers to MediaStreamTrack
• Web Speech API refers to MediaStreamTrack
• Capture Handle - Bootstrapping Collaboration when Screensharing refers to MediaStreamTrack
• MediaStream Image Capture refers to MediaStreamTrack
• Media Capture from DOM Elements refers to MediaStreamTrack
• Region Capture refers to MediaStreamTrack
• MediaStreamTrack Insertable Media Processing using Streams refers to MediaStreamTrack
• MediaStreamTrack Content Hints refers to MediaStreamTrack
• Web Audio API 1.1 refers to MediaStreamTrack
• Identity for WebRTC 1.0 refers to MediaStreamTrack
• WebRTC: Real-Time Communication in Browsers refers to MediaStreamTrack