CaptureController: decreaseZoomLevel()-Methode

Keine.

Ein Promise, das mit undefined erfüllt wird.

InvalidStateError DOMException

Wird ausgelöst, wenn:

• Die erfasste Bildschirmoberfläche bereits auf der minimal unterstützten Zoomstufe ist.
• Ein Versuch unternommen wird, decreaseZoomLevel() ohne transiente Aktivierung aufzurufen.

NotAllowedError DOMException

Wird ausgelöst, wenn:

• Die captured-surface-control Berechtigungsrichtlinie der Seite nicht zulässt, dass die Seite die Captured Surface Control API verwendet.
• Die Erlaubnis zur Erfassung der Bildschirmoberfläche ausdrücklich vom Benutzer verweigert wird.

Der folgende Codeausschnitt fügt einem Button einen Event-Listener hinzu, sodass beim Klicken die Funktion decreaseZoom() aufgerufen wird. Diese ruft wiederum die decreaseZoomLevel()-Methode auf, wodurch die erfasste Oberfläche 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 bewährte Praxis, decreaseZoomLevel() innerhalb eines try...catch-Blocks aufzurufen, da die Zoomstufe asynchron von einer anderen als der Anwendung geändert werden könnte, was zu einem Fehler führen könnte. Beispielsweise könnte der Benutzer direkt mit der erfassten Oberfläche interagieren, um herein- oder herauszuzoomen.

Sehen Sie sich Using the Captured Surface Control API für ein vollständiges funktionierendes Beispiel an.

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