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 Aufnahmesitzung weiter zu manipulieren, getrennt von ihrer Initiierung über MediaDevices.getDisplayMedia().

Ein CaptureController-Objekt wird einer Aufnahmesitzung zugeordnet, indem es in einen Aufruf von getDisplayMedia() als Wert der controller-Eigenschaft des Optionsobjekts übergeben wird.

Konstruktor

CaptureController()

Erstellt eine neue Instanz eines CaptureController-Objekts.

Instanzmethoden

setFocusBehavior()

Steuert, ob der aufgenommene Tab oder das Fenster fokussiert wird oder ob der Fokus bei dem Tab bleibt, das die aufnehmende Anwendung enthält.

Beispiele

js
// 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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch