CaptureController
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das CaptureController-Interface bietet Methoden, die verwendet werden können, um eine erfasste Anzeigeoberfläche weiter zu manipulieren (erfasst mittels MediaDevices.getDisplayMedia()).
Ein CaptureController-Objekt ist mit einer erfassten Anzeigeoberfläche verbunden, indem es in einen getDisplayMedia()-Aufruf als Wert der controller-Eigenschaft des Optionsobjekts übergeben wird.
Konstruktor
CaptureController()-
Erstellt eine neue
CaptureController-Objektinstanz.
Instanzeigenschaften
zoomLevel-
Der aktuelle Zoomfaktor der erfassten Anzeigeoberfläche.
Instanzmethoden
decreaseZoomLevel()-
Verringert den Zoomfaktor der erfassten Anzeigeoberfläche um eine Stufe.
forwardWheel()-
Beginnt damit,
wheel-Events, die auf dem referenzierten Element ausgelöst werden, an die Ansicht einer verbundenen erfassten Anzeigeoberfläche weiterzuleiten. getSupportedZoomLevels()-
Gibt die verschiedenen Zoomstufen zurück, die von der erfassten Anzeigeoberfläche unterstützt werden.
increaseZoomLevel()-
Erhöht den Zoomfaktor der erfassten Anzeigeoberfläche um eine Stufe.
resetZoomLevel()-
Setzt den Zoom der erfassten Anzeigeoberfläche auf seinen Anfangswert zurück, welcher
100ist. setFocusBehavior()-
Steuert, ob der erfasste Tab oder das Fenster fokussiert wird oder ob der Fokus bei dem Tab bleibt, das die erfassende Anwendung enthält.
Ereignisse
zoomlevelchange-
Wird ausgelöst, wenn sich der Zoomfaktor der erfassten Anzeigeoberfläche ändert.
Beispiele
// Create a new CaptureController instance
const controller = new CaptureController();
// Prompt the user to share a tab, window, or screen.
const stream = await navigator.mediaDevices.getDisplayMedia({ controller });
// Query the displaySurface value of the captured video track
const [track] = stream.getVideoTracks();
const displaySurface = track.getSettings().displaySurface;
if (displaySurface === "browser") {
// Focus the captured tab.
controller.setFocusBehavior("focus-captured-surface");
} else if (displaySurface === "window") {
// Do not move focus to the captured window.
// Keep the capturing page focused.
controller.setFocusBehavior("no-focus-change");
}
Spezifikationen
| Spezifikation |
|---|
| Screen Capture # dom-capturecontroller |