CaptureController: resetZoomLevel() Methode
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.
Die resetZoomLevel() Methode der CaptureController Schnittstelle setzt den Zoom der aufgenommenen Anzeigefläche auf das ursprüngliche Niveau zurück, was 100 ist.
Die resetZoomLevel() Methode muss über eine transiente Aktivierung aufgerufen werden. Zusätzlich wird der Benutzer beim ersten Versuch, den Bildschirm zu erfassen, um Erlaubnis gebeten, Tabs zu teilen; wenn der Benutzer die Erlaubnis verweigert, kann das Zoomniveau nicht einmal mit transiente Aktivierung geändert werden.
Syntax
resetZoomLevel()
Parameter
Keine.
Rückgabewert
Ausnahmen
InvalidStateErrorDOMException-
Ein Versuch,
resetZoomLevel()ohne transiente Aktivierung aufzurufen. NotAllowedErrorDOMException-
Wird ausgelöst, wenn:
- Die
captured-surface-controlPermissions Policy der Seite es der Seite nicht erlaubt, die Captured Surface Control API zu verwenden. - Die Erlaubnis, die Anzeigefläche zu erfassen, explizit vom Benutzer verweigert wird.
- Die
Beispiele
Grundlegende Verwendung von resetZoomLevel()
Das folgende Snippet fügt einem Button einen Event Listener hinzu, sodass beim Klicken darauf die Funktion resetZoom() aufgerufen wird. Diese ruft wiederum die Methode resetZoomLevel() auf und setzt das Zoomniveau der erfassten Oberfläche auf 100 zurück.
// Create controller and start capture
const controller = new CaptureController();
videoElem.srcObject = await navigator.mediaDevices.getDisplayMedia({
controller,
});
// ...
resetBtn.addEventListener("click", resetZoom);
async function resetZoom() {
await controller.resetZoomLevel();
}
Siehe Verwendung der Captured Surface Control API für ein vollständiges, funktionierendes Beispiel.
Spezifikationen
| Specification |
|---|
| Captured Surface Control # dom-capturecontroller-resetzoomlevel |