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

Syntax

decreaseZoomLevel()

Parameters

Không có.

Return value

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

Exceptions

InvalidStateError DOMException

Được ném ra khi:

• Bề mặt hiển thị đang được chụp đã ở mức thu phóng tối thiểu mà nó hỗ trợ.
• Có một nỗ lực gọi decreaseZoomLevel() mà không có kích hoạt tạm thời.

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ị.

Examples

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

Đoạn mã sau thêm một trình lắng nghe sự kiện vào một nút để khi nút được nhấn, hàm decreaseZoom() được gọi. Hàm này sẽ gọi phương thức decreaseZoomLevel(), làm thu nhỏ bề mặt đang được chụp.

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

Nhìn chung, cách làm tốt nhất là gọi decreaseZoomLevel() bên trong khối try...catch vì mức thu phóng có thể bị thay đổi không đồng bộ bởi một thực thể khác ngoài ứng dụng, điều này có thể dẫn đến ngoại lệ được ném ra. Ví dụ, người dùng có thể tương tác trực tiếp với bề mặt đang được chụp để phóng to hoặc thu nhỏ.

Xem Using the Captured Surface Control API để có ví dụ đầy đủ đang hoạt động.

Specifications

Browser compatibility

See also

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