MediaTrackSupportedConstraints: logicalSurface-Eigenschaft

Limited availability

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

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

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

Syntax

js
isLogicalSurfaceSupported = supportedConstraints.logicalSurface

Wert

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

Beispiel

Diese Methode richtet das Einschränkungsobjekt ein, das die Optionen für den Aufruf von getDisplayMedia() angibt. Sie fügt die logicalSurface-Einschränkung hinzu (mit der Anfrage, dass nur logische Anzeigeoberflächen — die möglicherweise nicht vollständig auf dem Bildschirm sichtbar sind — zu den dem Benutzer verfügbaren Optionen gehören), nur wenn bekannt ist, dass sie vom Browser unterstützt wird. Die Erfassung wird dann durch den Aufruf von getDisplayMedia() gestartet, und der zurückgegebene Stream wird dem videoElem-Element zugewiesen.

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

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

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

Spezifikationen

Specification
Screen Capture
# dom-mediatrackconstraintset-logicalsurface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch