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
zoomLevelExperimentell-
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
100ist. 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
zoomlevelchangeExperimentell-
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 |
Browser-Kompatibilität
Loading…