CaptureController: increaseZoomLevel() 方法

語法

increaseZoomLevel()

引數

無。

返回值

一個 Promise，它 fulfilled 為 undefined。

異常

InvalidStateError DOMException

丟擲時

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

NotAllowedError DOMException

丟擲時

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

示例

increaseZoomLevel() 的基本用法

以下程式碼片段向按鈕添加了一個事件監聽器，以便在點選按鈕時呼叫 increaseZoom() 函式。該函式接著呼叫 increaseZoomLevel() 方法，從而放大捕獲的表面。

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

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

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

規範

瀏覽器相容性

另見

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