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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
logicalSurface constraint

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch