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.

We'd love to hear more about your role and the company you work for
Please help us by answering a few questions.

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