CaptureController

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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() Experimentell: Erstellt eine neue CaptureController-Objektinstanz.

Instanzeigenschaften

zoomLevel Experimentell: Der aktuelle Zoomfaktor der erfassten Anzeigeoberfläche.

Instanzmethoden

decreaseZoomLevel() Experimentell: Verringert den Zoomfaktor der erfassten Anzeigeoberfläche um eine Stufe.
forwardWheel() Experimentell: Beginnt damit, wheel-Events, die auf dem referenzierten Element ausgelöst werden, an die Ansicht einer verbundenen erfassten Anzeigeoberfläche weiterzuleiten.
getSupportedZoomLevels() Experimentell: Gibt die verschiedenen Zoomstufen zurück, die von der erfassten Anzeigeoberfläche unterstützt werden.
increaseZoomLevel() Experimentell: Erhöht den Zoomfaktor der erfassten Anzeigeoberfläche um eine Stufe.
resetZoomLevel() Experimentell: Setzt den Zoom der erfassten Anzeigeoberfläche auf seinen Anfangswert zurück, welcher 100 ist.
setFocusBehavior() Experimentell: 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 Experimentell: 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

Specification
Screen Capture # dom-capturecontroller