MediaStream: getVideoTracks()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Die getVideoTracks()-Methode des MediaStream-Interfaces gibt eine Sequenz von MediaStreamTrack-Objekten zurück, die die Videospuren in diesem Stream repräsentieren.

Syntax

js
getVideoTracks()

Parameter

Keine.

Rückgabewert

Ein Array von MediaStreamTrack-Objekten, eines für jede Videospur im Medienstream. Videospuren sind die Spuren, deren kind-Eigenschaft video ist. Das Array ist leer, wenn der Stream keine Videospuren enthält.

Hinweis: Die Reihenfolge der Spuren ist durch die Spezifikation nicht definiert und kann von einem Aufruf von getVideoTracks() zum nächsten unterschiedlich sein.

Beispiele

Das folgende Beispiel, entnommen aus Chrome's Image Capture / Photo Resolution Sample, verwendet getVideoTracks(), um eine Spur für die Übergabe an den ImageCapture()-Konstruktor abzurufen.

js
let 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();
});

Spezifikationen

Specification
Media Capture and Streams
# dom-mediastream-getvideotracks

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getVideoTracks

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.