MediaStream
The MediaStream
interface represents a stream of media content. A stream consists of several tracks, such as video or audio tracks. Each track is specified as an instance of MediaStreamTrack
.
You can obtain a MediaStream
object either by using the constructor or by calling functions such as MediaDevices.getUserMedia()
, MediaDevices.getDisplayMedia()
, or HTMLCanvasElement.captureStream()
.
Some user agents subclass this interface to provide more precise information or functionality, like in CanvasCaptureMediaStreamTrack
.
Constructor
MediaStream()
-
Creates and returns a new
MediaStream
object. You can create an empty stream, a stream which is based upon an existing stream, or a stream that contains a specified list of tracks (specified as an array ofMediaStreamTrack
objects).
Instance properties
This interface inherits properties from its parent, EventTarget
.
MediaStream.active
Read only-
A Boolean value that returns
true
if theMediaStream
is active, orfalse
otherwise. MediaStream.id
Read only-
A string containing a 36-character universally unique identifier (UUID) for the object.
Instance methods
This interface inherits methods from its parent, EventTarget
.
MediaStream.addTrack()
-
Stores a copy of the
MediaStreamTrack
given as argument. If the track has already been added to theMediaStream
object, nothing happens. MediaStream.clone()
-
Returns a clone of the
MediaStream
object. The clone will, however, have a unique value forid
. MediaStream.getAudioTracks()
-
Returns a list of the
MediaStreamTrack
objects stored in theMediaStream
object that have theirkind
attribute set toaudio
. The order is not defined, and may not only vary from one browser to another, but also from one call to another. MediaStream.getTrackById()
-
Returns the track whose ID corresponds to the one given in parameters,
trackid
. If no parameter is given, or if no track with that ID does exist, it returnsnull
. If several tracks have the same ID, it returns the first one. MediaStream.getTracks()
-
Returns a list of all
MediaStreamTrack
objects stored in theMediaStream
object, regardless of the value of thekind
attribute. The order is not defined, and may not only vary from one browser to another, but also from one call to another. MediaStream.getVideoTracks()
-
Returns a list of the
MediaStreamTrack
objects stored in theMediaStream
object that have theirkind
attribute set to"video"
. The order is not defined, and may not only vary from one browser to another, but also from one call to another. MediaStream.removeTrack()
-
Removes the
MediaStreamTrack
given as argument. If the track is not part of theMediaStream
object, nothing happens.
Events
addtrack
-
Fired when a new
MediaStreamTrack
object is added. removetrack
-
Fired when a
MediaStreamTrack
object has been removed. active
-
Fired when the MediaStream is activated.
inactive
-
Fired when the MediaStream is inactivated.
Specifications
Specification |
---|
Media Capture and Streams # mediastream |
Browser compatibility
BCD tables only load in the browser