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, bevor Sie diese produktiv verwenden.
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()
Experimentell-
Erstellt eine neue Instanz eines
CaptureController
-Objekts.
Instanzmethoden
setFocusBehavior()
Experimentell-
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
// 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