CaptureController: phương thức forwardWheel()

Syntax

forwardWheel(element)

Parameters

element

Tham chiếu tới phần tử có các sự kiện wheel mà bạn muốn chuyển tiếp tới bề mặt hiển thị đang được chụp có liên kết.

Return value

Một Promise hoàn tất với undefined.

Exceptions

InvalidStateError DOMException

Được ném ra khi:

• MediaStream dùng để chụp do lời gọi MediaDevices.getDisplayMedia() ban đầu trả về không còn chụp nữa, ví dụ vì các đối tượng MediaStreamTrack liên kết đã bị gọi stop().
• Ứng dụng đang tự chụp chính nó.
• Có một nỗ lực gọi forwardWheel() mà không có kích hoạt tạm thời, trong khi người dùng chưa cấp quyền dùng tính năng đó.

NotAllowedError DOMException

Được ném ra khi:

• Permissions Policy captured-surface-control của trang không cho phép trang sử dụng Captured Surface Control API.
• Người dùng đã từ chối rõ ràng quyền chụp bề mặt hiển thị.

NotSupportedError DOMException

Kiểu bề mặt đang được chụp không phải là tab trình duyệt.

Examples

Cách dùng forwardWheel() cơ bản

Trong bản demo trực tiếp của chúng tôi, được giải thích trong Using the Captured Surface Control API, chúng tôi gọi một hàm tên là startForwarding() sau khi promise chụp getDisplayMedia() hoàn tất:

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

// ...

startForwarding();

Hàm này gọi phương thức forwardWheel(), truyền vào đó tham chiếu tới phần tử <video> mà luồng đã chụp đang được hiển thị trong đó:

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

Kết quả là các sự kiện wheel phát ra trên phần tử được tham chiếu sẽ được chuyển tiếp tới bề mặt hiển thị đang được chụp, cho phép ứng dụng chụp cuộn bề mặt đó.

Specifications

Browser compatibility

See also

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