CaptureController

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 100 ist.

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

Browser-Kompatibilität

Siehe auch

• Screen Capture API
• MediaDevices.getDisplayMedia()
• Verwendung der Elementfassungs- und Bereichserfassungs-APIs
• Verwendung der Captured Surface Control API
• Besseres Bildschirmfreigeben mit bedingtem Fokus