MediaTrackConstraints: Eigenschaft logicalSurface
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die Eigenschaft logicalSurface des Dictionaries MediaTrackConstraints ist ein ConstrainDOMString, der die gewünschten oder verbindlichen Einschränkungen für den Wert der einschränkbaren Eigenschaft logicalSurface beschreibt.
Damit wird festgelegt, ob getDisplayMedia() den Benutzern erlauben soll, Anzeigeflächen auszuwählen, die nicht unbedingt vollständig auf dem Bildschirm sichtbar sind. Dazu gehören verdeckte Fenster oder der gesamte Inhalt von Fenstern, die so groß sind, dass man scrollen muss, um ihren gesamten Inhalt zu sehen.
Bei Bedarf können Sie prüfen, ob diese Einschränkung unterstützt wird, indem Sie den Wert von logicalSurface überprüfen, den ein Aufruf von MediaDevices.getSupportedConstraints() zurückgibt. In der Regel ist dies jedoch nicht nötig, da Browser unbekannte Einschränkungen ignorieren.
Wert
Ein ConstrainBoolean, der true ist, wenn logische Anzeigeflächen zu den Auswahlmöglichkeiten für die Benutzer gehören sollen.
Hinweise zur Verwendung
Nachdem das Anzeigemedium durch getDisplayMedia() erstellt wurde, können Sie die vom User Agent gewählte Einstellung überprüfen: Rufen Sie dazu getSettings() für den Video-MediaStreamTrack des Anzeigemediums auf und prüfen Sie dann den Wert der Eigenschaft logicalSurface des zurückgegebenen MediaTrackSettings-Objekts.
Wenn Ihre Anwendung beispielsweise wissen muss, ob die ausgewählte Anzeigefläche eine logische Anzeigefläche ist:
let isLogicalSurface = displayStream
.getVideoTracks()[0]
.getSettings().logicalSurface;
Nach Ausführung dieses Codes ist isLogicalSurface gleich true, wenn die im Stream enthaltene Anzeigefläche eine logische Anzeigefläche ist. Das bedeutet, dass sie möglicherweise nicht vollständig oder sogar überhaupt nicht auf dem Bildschirm sichtbar ist.
Spezifikationen
| Spezifikation |
|---|
| Screen Capture # dom-mediatrackconstraintset-logicalsurface |