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 vom Benutzeragenten und dem Gerät, auf dem der Inhalt verwendet wird, unterstützt wird.

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

Wert

Ein boolescher Wert, der true ist, wenn die logicalSurface-Einschränkung vom Gerät und dem 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 (die anfordert, dass nur logische Anzeigeoberflächen—die möglicherweise nicht vollständig sichtbar auf dem Bildschirm sind – in die vom Benutzer verfügbaren Optionen aufgenommen werden) nur hinzu, wenn bekannt ist, dass sie vom Browser unterstützt wird. Das Erfassen wird dann durch den Aufruf von getDisplayMedia() gestartet, und der zugehörige Stream wird an das durch die Variable videoElem referenzierte Videoelement angehängt.

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