The getVideoTracks()
method of the MediaStream
interface returns a sequence of MediaStreamTrack
objects representing the video tracks in this stream.
MediaStream.getVideoTracks()
Syntax
var mediaStreamTracks[] = mediaStream.getVideoTracks();
Parameters
None.
Return value
An array of MediaStreamTrack
objects, one for each video track contained in the media stream. Video tracks are those tracks whose kind
property is video
. The array is empty if the stream contains no video tracks.
Note: The order of the tracks is not defined by the specification, and may not be the same from one call to getVideoTracks()
to another.
Early versions of this API included a special VideoStreamTrack
interface which was used as the type for each entry in the list of video streams; however, this has since been merged into the main MediaStreamTrack
interface.
Example
The following example, extracted from Chrome's Image Capture / Photo Resolution Sample, uses getVideoTracks()
to retrieve a track for passing to the ImageCapture()
constructor.
var imageCapture; navigator.mediaDevices.getUserMedia({video: true}) .then(mediaStream => { document.querySelector('video').srcObject = mediaStream; const track = mediaStream.getVideoTracks()[0]; imageCapture = new ImageCapture(track); return imageCapture.getPhotoCapabilities(); })
Specifications
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getVideoTracks |
26
|
12
|
22
Before Firefox 64, this method returned an array of
VideoStreamTrack objects. However,
MediaStreamTrack has now subsumed that interface's functionality.
|
No
|
15
|
11
|
37
|
26
|
22
Before Firefox 64, this method returned an array of
VideoStreamTrack objects. However,
MediaStreamTrack has now subsumed that interface's functionality.
|
No
|
11
|
1.5
|
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaStream/getVideoTracks