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 zwingenden Constraints für den Wert der einschränkbaren Eigenschaft logicalSurface beschreibt.
Damit wird festgelegt, ob getDisplayMedia() 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 vollständigen Inhalt zu sehen.
Bei Bedarf können Sie prüfen, ob dieser Constraint 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 Constraints ignorieren.
Wert
Ein ConstrainBoolean, der true ist, wenn logische Anzeigeflächen zu den Auswahlmöglichkeiten für Benutzer gehören sollen.
Hinweise zur Verwendung
Nachdem getDisplayMedia() das Anzeigemedium erstellt hat, 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 anschließend den Wert der Eigenschaft logicalSurface.
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 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 |