MediaStreamTrack: applyConstraints() Methode

constraints Optional

Ein MediaTrackConstraints-Objekt, das die auf die einschränkbaren Eigenschaften des Tracks anzuwendenden Einschränkungen auflistet; bestehende Einschränkungen werden durch die neu angegebenen Werte ersetzt, und alle nicht enthaltenen einschränkbaren Eigenschaften werden auf ihre standardmäßigen Einschränkungen zurückgesetzt. Wird dieser Parameter weggelassen, werden alle derzeit festgelegten benutzerdefinierten Einschränkungen gelöscht. Dieses Objekt stellt das grundlegende Set von Einschränkungen dar, die erfüllt sein müssen, damit der Promise erfolgreich aufgelöst wird. Das Objekt kann eine erweiterte Eigenschaft enthalten, die ein Array zusätzlicher MediaTrackConstraints-Objekte umfasst, die als exakt erforderlich behandelt werden.

Ein Promise, das aufgelöst wird, wenn die Einschränkungen erfolgreich angewendet wurden. Wenn die Einschränkungen nicht angewendet werden können, wird das Promise mit einem OverconstrainedError abgelehnt, das ein DOMException ist, dessen Name OverconstrainedError ist, mit zusätzlichen Parametern, um anzuzeigen, dass die Einschränkungen nicht erfüllt werden konnten. Dies kann passieren, wenn die festgelegten Einschränkungen zu streng sind, um beim Versuch, den Track zu konfigurieren, eine Übereinstimmung zu finden.

Das Folgende zeigt, wie man ein grundlegendes und erweitertes Set von Einschränkungen spezifiziert. Es spezifiziert, dass die Seite oder Web-App eine Breite zwischen 640 und 1280 und eine Höhe zwischen 480 und 720 benötigt, wobei die spätere Zahl in jedem Paar bevorzugt wird. Die erweiterte Eigenschaft legt ferner fest, dass eine Bildgröße von 1920 x 1280 bevorzugt wird oder ein Seitenverhältnis von 1.333, falls dies nicht verfügbar ist. Beachten Sie, dass diese Einschränkungen auch veranschaulichen, was die Spezifikation als Rückzugsstrategie bezeichnet.

const constraints = {
  width: { min: 640, ideal: 1280 },
  height: { min: 480, ideal: 720 },
  advanced: [{ width: 1920, height: 1280 }, { aspectRatio: 1.333 }],
};

navigator.mediaDevices.getUserMedia({ video: true }).then((mediaStream) => {
  const track = mediaStream.getVideoTracks()[0];
  track
    .applyConstraints(constraints)
    .then(() => {
      // Do something with the track such as using the Image Capture API.
    })
    .catch((e) => {
      // The constraints could not be satisfied by the available devices.
    });
});

• MediaStream Image Capture API