CaptureController: decreaseZoomLevel()-Methode

Syntax

decreaseZoomLevel()

Parameter

Keine.

Rckgabewert

Ein Promise, das mit undefined erfllt wird.

Ausnahmen

InvalidStateError DOMException

Wird ausgelst, wenn:

• Die erfasste Bildschirmoberflche bereits auf der minimal untersttzten Zoomstufe ist.
• Ein Versuch unternommen wird, decreaseZoomLevel() ohne transiente Aktivierung aufzurufen.

NotAllowedError DOMException

Wird ausgelst, wenn:

• Die captured-surface-control Berechtigungsrichtlinie der Seite nicht zulsst, dass die Seite die Captured Surface Control API verwendet.
• Die Erlaubnis zur Erfassung der Bildschirmoberflche ausdrcklich vom Benutzer verweigert wird.

Beispiele

Grundlegende decreaseZoomLevel()-Verwendung

Der folgende Codeausschnitt fgt einem Button einen Event-Listener hinzu, sodass beim Klicken die Funktion decreaseZoom() aufgerufen wird. Diese ruft wiederum die decreaseZoomLevel()-Methode auf, wodurch die erfasste Oberflche herausgezoomt wird.

// Create controller and start capture
const controller = new CaptureController();
videoElem.srcObject = await navigator.mediaDevices.getDisplayMedia({
  controller,
});

// ...

decBtn.addEventListener("click", decreaseZoom);

async function decreaseZoom() {
  try {
    await controller.decreaseZoomLevel();
  } catch (e) {
    console.log(e);
  }
}

Es ist generell eine bewhrte Praxis, decreaseZoomLevel() innerhalb eines try...catch-Blocks aufzurufen, da die Zoomstufe asynchron von einer anderen als der Anwendung gendert werden knnte, was zu einem Fehler fhren knnte. Beispielsweise knnte der Benutzer direkt mit der erfassten Oberflche interagieren, um herein- oder herauszuzoomen.

Sehen Sie sich Using the Captured Surface Control API fr ein vollstndiges funktionierendes Beispiel an.

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Screen Capture API
• MediaDevices.getDisplayMedia()
• Using the Captured Surface Control API