CaptureController: forwardWheel() 方法

語法

forwardWheel(element)

引數

element

對你想轉發 wheel 事件到已捕獲顯示錶面的元素的引用。

返回值

一個 Promise，它 fulfilled 為 undefined。

異常

InvalidStateError DOMException

丟擲時

• 原始 MediaDevices.getDisplayMedia() 呼叫返回的捕獲 MediaStream 不再捕獲，例如因為關聯的 MediaStreamTrack 物件已呼叫了 stop()。
• 應用程式正在捕獲自身。
• 嘗試在沒有瞬時啟用的情況下呼叫 forwardWheel()，而使用者尚未授予使用它的許可權。

NotAllowedError DOMException

丟擲時

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

NotSupportedError DOMException

正在捕獲的表面型別不是瀏覽器標籤頁。

示例

基本的 forwardWheel() 用法

在我們由 使用捕獲的表面控制 API 解釋的即時演示中，我們在捕獲的 getDisplayMedia() Promise fulfilled 後呼叫了一個名為 startForwarding() 的函式。

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

// ...

startForwarding();

該函式呼叫 forwardWheel() 方法，並將正在顯示捕獲流的 <video> 元素作為引用傳遞給它。

async function startForwarding() {
  try {
    await controller.forwardWheel(videoElem);
  } catch (e) {
    console.log(e);
  }
}

這導致在引用元素上觸發的 wheel 事件被轉發到已捕獲的顯示錶面，使捕獲應用程式能夠滾動它。

規範

瀏覽器相容性

另見

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