MediaStream Image Capture API

Konzepte und Verwendung der MediaStream Image Capture

Der Prozess des Abrufens eines Bild- oder Videostreams erfolgt wie unten beschrieben. Der Beispielcode ist aus Chromes Image Capture-Beispielen angepasst.

Zuerst erhalten Sie eine Referenz zu einem Gert, indem Sie MediaDevices.getUserMedia() aufrufen. Das untenstehende Beispiel besagt, dass es mir jedes verfgbare Videogert geben soll, obwohl die Methode getUserMedia() es ermglicht, spezifischere Fhigkeiten anzufordern. Diese Methode gibt ein Promise zurck, das mit einem MediaStream-Objekt aufgelst wird.

navigator.mediaDevices.getUserMedia({ video: true }).then((mediaStream) => {
  // Do something with the stream.
});

Als nchstes isolieren Sie den visuellen Teil des Medienstreams. Dies geschieht durch Aufrufen von MediaStream.getVideoTracks(). Dies gibt ein Array von MediaStreamTrack-Objekten zurck. Der untenstehende Code geht davon aus, dass das erste Element im MediaStreamTrack-Array das zu verwendende ist. Sie knnen die Eigenschaften der MediaStreamTrack-Objekte verwenden, um das bentigte auszuwhlen.

const track = mediaStream.getVideoTracks()[0];

An diesem Punkt mchten Sie mglicherweise die Gerteeigenschaften konfigurieren, bevor Sie ein Bild erfassen. Sie knnen dies tun, indem Sie applyConstraints() auf dem Track-Objekt aufrufen, bevor Sie etwas anderes tun.

let zoom = document.querySelector("#zoom");
const capabilities = track.getCapabilities();
// Check whether zoom is supported or not.
if (!capabilities.zoom) {
  return;
}
track.applyConstraints({ advanced: [{ zoom: zoom.value }] });

Zuletzt bergeben Sie das MediaStreamTrack-Objekt an den ImageCapture()-Konstruktor. Obwohl ein MediaStream mehrere Arten von Tracks enthlt und mehrere Methoden bereitstellt, um sie abzurufen, wird der ImageCapture-Konstruktor eine DOMException vom Typ NotSupportedError auslsen, wenn MediaStreamTrack.kind nicht "video" ist.

let imageCapture = new ImageCapture(track);

Schnittstellen

ImageCapture

Eine Schnittstelle zum Erfassen von Bildern von einem fotografischen Gert, das durch ein gltiges MediaStreamTrack referenziert wird.

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• MediaStream
• MediaStreamTrack