CaptureController: increaseZoomLevel() 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 increaseZoomLevel()-Methode der CaptureController-Schnittstelle erhöht den Zoomfaktor der erfassten Anzeigefläche um einen Schritt.
Die increaseZoomLevel()-Methode muss über eine transiente Aktivierung aufgerufen werden. Außerdem wird der Benutzer um Erlaubnis gebeten, Tabs zu teilen, wenn die Bildschirmaufnahme zum ersten Mal versucht wird; verweigert der Benutzer die Erlaubnis, kann der Zoomfaktor auch mit transiente Aktivierung nicht geändert werden.
Syntax
increaseZoomLevel()
Parameter
Keine.
Rückgabewert
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn:
- Die erfasste Anzeigefläche bereits den maximal unterstützten Zoomfaktor erreicht hat.
- Ein Versuch unternommen wird,
increaseZoomLevel()ohne transiente Aktivierung aufzurufen.
NotAllowedErrorDOMException-
Wird ausgelöst, wenn:
- Die
captured-surface-controlBerechtigungsrichtlinie der Seite der Seite nicht erlaubt, die Captured Surface Control API zu nutzen. - Die Erlaubnis zur Erfassung der Anzeigefläche vom Benutzer ausdrücklich verweigert wird.
- Die
Beispiele
Grundlegende Verwendung von increaseZoomLevel()
Der folgende Code-Ausschnitt fügt einem Button einen Event-Listener hinzu, sodass beim Klicken die increaseZoom()-Funktion aufgerufen wird. Diese wiederum ruft die increaseZoomLevel()-Methode auf und zoomt dadurch die erfasste Oberfläche ein.
// Create controller and start capture
const controller = new CaptureController();
videoElem.srcObject = await navigator.mediaDevices.getDisplayMedia({
controller,
});
// ...
incBtn.addEventListener("click", increaseZoom);
async function increaseZoom() {
try {
await controller.increaseZoomLevel();
} catch (e) {
console.log(e);
}
}
Es ist allgemein eine bewährte Praxis, increaseZoomLevel() innerhalb eines try...catch-Blocks aufzurufen, da der Zoomfaktor asynchron von einer anderen Entität als der Anwendung geändert werden könnte, was zu einem Fehler führen kann. Beispielsweise könnte der Benutzer direkt mit der erfassten Oberfläche interagieren, um ein- oder auszuzoomen.
Siehe Verwendung der Captured Surface Control API für ein vollständiges Arbeitsbeispiel.
Spezifikationen
| Specification |
|---|
| Captured Surface Control # dom-capturecontroller-increasezoomlevel |
Browser-Kompatibilität
Loading…