CaptureController：decreaseZoomLevel() 方法

語法

decreaseZoomLevel()

引數

無。

返回值

一個 Promise，它 fulfilled 為 undefined。

異常

InvalidStateError DOMException

丟擲時

• 捕獲的顯示圖面已達到其支援的最低縮放級別。
• 嘗試在沒有瞬時啟用的情況下呼叫 decreaseZoomLevel()。

NotAllowedError DOMException

丟擲時

• 頁面的 captured-surface-control 許可權策略不允許頁面使用 Captured Surface Control API。
• 使用者明確拒絕了捕獲顯示圖面的許可權。

示例

decreaseZoomLevel() 的基本用法

以下程式碼段向按鈕添加了一個事件監聽器，以便在點選按鈕時呼叫 decreaseZoom() 函式。該函式又會呼叫 decreaseZoomLevel() 方法，從而縮小捕獲的圖面。

// 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);
  }
}

通常，最好將 decreaseZoomLevel() 呼叫放在 try...catch 塊中，因為縮放級別可能被應用程式以外的實體非同步更改，這可能導致錯誤被丟擲。例如，使用者可能直接與捕獲的圖面進行互動來放大或縮小。

有關完整的可執行示例，請參閱 使用 Captured Surface Control API。

規範

瀏覽器相容性

另見

• Screen Capture API
• MediaDevices.getDisplayMedia()
• 使用 Captured Surface Control API