MediaTrackConstraints: 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 MediaTrackConstraints-Wörterbuchs ist ein ConstrainDOMString, das die angeforderten oder zwingenden Einschränkungen beschreibt, die dem Wert der logicalSurface beschränkbaren Eigenschaft auferlegt werden.

Dies wird verwendet, um anzugeben, ob getDisplayMedia() dem Benutzer die Auswahl von Anzeigeflächen ermöglichen soll, die nicht unbedingt vollständig auf dem Bildschirm sichtbar sind, wie zum Beispiel verdeckte Fenster oder der gesamte Inhalt von Fenstern, die groß genug sind, um das Scrollen zu erfordern, um ihren gesamten Inhalt zu sehen.

Falls erforderlich, können Sie feststellen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von MediaTrackSupportedConstraints.logicalSurface überprüfen, der durch einen Aufruf von MediaDevices.getSupportedConstraints() zurückgegeben wird. In der Regel ist dies jedoch nicht erforderlich, da Browser alle ihnen unbekannten Einschränkungen ignorieren.

Wert

Ein ConstrainBoolean, das true ist, wenn logische Flächen unter den für den Benutzer verfügbaren Auswahlmöglichkeiten erlaubt sein sollen.

Siehe wie Einschränkungen definiert sind.

Anwendungshinweise

Sie können die vom User-Agent ausgewählte Einstellung überprüfen, nachdem das Anzeigemedium durch getDisplayMedia() erstellt wurde, indem Sie getSettings() auf dem Video-MediaStreamTrack des Anzeigemediums aufrufen und dann den Wert des zurückgegebenen MediaTrackSettings-Objekts logicalSurface überprüfen.

Wenn Ihr App beispielsweise wissen muss, ob die ausgewählte Anzeigefläche eine logische ist:

js
let isLogicalSurface = displayStream
  .getVideoTracks()[0]
  .getSettings().logicalSurface;

Ist isLogicalSurface nach diesem Code true, wenn die im Stream enthaltene Anzeigefläche eine logische Oberfläche ist, also eine, die möglicherweise nicht vollständig auf dem Bildschirm ist oder sogar vollständig außerhalb des Bildschirms liegt.

Spezifikationen

Specification
Screen Capture
# dom-mediatrackconstraintset-logicalsurface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch