CaptureController
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.
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.
Die CaptureController-Schnittstelle stellt Methoden bereit, mit denen sich eine erfasste Bildschirmoberfläche weiter steuern lässt (erfasst über MediaDevices.getDisplayMedia()).
Ein CaptureController-Objekt wird einer erfassten Bildschirmoberfläche zugeordnet, indem es bei einem getDisplayMedia()-Aufruf als Wert der controller-Eigenschaft des Optionsobjekts übergeben wird.
Konstruktor
CaptureController()-
Erstellt eine neue
CaptureController-Objektinstanz.
Instanzeigenschaften
zoomLevelSchreibgeschützt-
Die aktuelle Zoomstufe der erfassten Bildschirmoberfläche.
Instanzmethoden
decreaseZoomLevel()-
Verringert die Zoomstufe der erfassten Bildschirmoberfläche um eine Stufe.
forwardWheel()-
Beginnt damit,
wheel-Ereignisse, die auf dem referenzierten Element ausgelöst werden, an den Viewport einer zugeordneten erfassten Bildschirmoberfläche weiterzuleiten. getSupportedZoomLevels()-
Gibt die verschiedenen Zoomstufen zurück, die von der erfassten Bildschirmoberfläche unterstützt werden.
increaseZoomLevel()-
Erhöht die Zoomstufe der erfassten Bildschirmoberfläche um eine Stufe.
resetZoomLevel()-
Setzt die Zoomstufe der erfassten Bildschirmoberfläche auf ihren Ausgangswert
100zurück. setFocusBehavior()-
Steuert, ob der erfasste Tab oder das erfasste Fenster den Fokus erhält oder ob der Fokus bei dem Tab mit der erfassenden Anwendung bleibt.
Ereignisse
zoomlevelchange-
Wird ausgelöst, wenn sich die Zoomstufe der erfassten Bildschirmoberflä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 |