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

BCD tables only load in the browser