MediaTrackSupportedConstraints: displaySurface-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die displaySurface-Eigenschaft des MediaTrackSupportedConstraints-Wörterbuchs gibt an, ob die displaySurface-Einschränkung durch den Benutzeragenten und das Gerät, auf dem die Inhalte genutzt werden, unterstützt wird.

Die Liste der unterstützten Einschränkungen wird durch den Aufruf von navigator.mediaDevices.getSupportedConstraints() erhalten.

Wert

Ein boolescher Wert, der true ist, wenn die displaySurface-Einschränkung durch das Gerät und den Benutzeragenten unterstützt wird.

Beispiele

Diese Methode richtet das Einschränkungsobjekt ein, das die Optionen für den Aufruf von getDisplayMedia() angibt. Sie fügt die displaySurface-Einschränkung hinzu (wobei beantragt wird, dass nur das Teilen des Vollbildes erlaubt ist), nur wenn bekannt ist, dass sie vom Browser unterstützt wird. Die Aufnahme wird dann durch den Aufruf von getDisplayMedia() gestartet und der zurückgegebene Stream an das <video>-Element angehängt, das durch die Variable videoElem referenziert wird.

js
async function capture() {
  let supportedConstraints = navigator.mediaDevices.getSupportedConstraints();
  let displayMediaOptions = {
    video: {},
    audio: false,
  };

  if (supportedConstraints.displaySurface) {
    displayMediaOptions.video.displaySurface = "monitor";
  }

  try {
    videoElem.srcObject =
      await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
  } catch (err) {
    /* handle the error */
  }
}

Spezifikationen

Specification
Screen Capture
# dom-mediatrackconstraintset-displaysurface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch