MediaTrackSettings: 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 MediaTrackSettings-Wörterbuchs gibt an, ob der erfasste Anzeigebereich eine logische Oberfläche ist oder nicht. Logische Oberflächen sind solche, die nicht unbedingt vollständig auf dem Bildschirm sichtbar sind oder sogar außerhalb des Bildschirms liegen können, wie z. B. die Puffer von Fenstern (wobei nur ein Teil des Puffers ohne Scrollen des umschließenden Fensters sichtbar ist) und Offscreen-Rendering-Kontexte.

Wert

Ein boolescher Wert, der true ist, wenn der Videotrack im Stream des erfassten Videos von einer logischen Anzeigefläche stammt.

Das häufigste Szenario, in dem eine Anzeigefläche eine logische sein kann, ist, wenn die ausgewählte Fläche den gesamten Inhaltsbereich eines Fensters umfasst, das zu groß ist, um es gleichzeitig auf dem Bildschirm anzuzeigen. Da das Fenster, das die Fläche enthält, gescrollt werden muss, um den Rest der Inhalte anzuzeigen, ist die Fläche eine logische.

Eine sichtbare Anzeigefläche (das heißt, eine Fläche, für die logicalSurface false zurückgibt) ist der Teil einer logischen Anzeigefläche, der derzeit auf dem Bildschirm sichtbar ist.

Zum Beispiel kann ein Benutzeragent dem Benutzer erlauben zu wählen, ob er das gesamte Dokument (einen browser mit dem logicalSurface-Wert true) oder nur den aktuell sichtbaren Teil des Dokuments freigeben möchte (wobei die logicalSurface des browser-Bereichs false ist).

Spezifikationen

Specification
Screen Capture
# dom-mediatrackconstraintset-logicalsurface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch