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.
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:
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