CaptureController: phương thức increaseZoomLevel()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức increaseZoomLevel() của giao diện CaptureController tăng mức thu phóng của bề mặt hiển thị đang được chụp lên một nấc.
Phương thức increaseZoomLevel() phải được gọi thông qua kích hoạt tạm thời. Ngoài ra, người dùng sẽ được hỏi quyền chia sẻ tab khi lần đầu cố gắng chụp màn hình; nếu người dùng từ chối cấp quyền thì mức thu phóng sẽ không thể thay đổi ngay cả khi có kích hoạt tạm thời.
Cú pháp
increaseZoomLevel()
Parameters
Không có.
Return value
Exceptions
InvalidStateErrorDOMException-
Được ném ra khi:
- Bề mặt hiển thị đang được chụp đã ở mức thu phóng tối đa mà nó hỗ trợ.
- Có một nỗ lực gọi
increaseZoomLevel()mà không có kích hoạt tạm thời.
NotAllowedErrorDOMException-
Được ném ra khi:
- Chính sách quyền
captured-surface-control - Người dùng đã từ chối rõ ràng quyền chụp bề mặt hiển thị.
- Chính sách quyền
Examples
Cách dùng increaseZoomLevel() 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 increaseZoom() được gọi. Hàm này sẽ gọi phương thức increaseZoomLevel(), làm phóng to bề mặt đang được chụp.
// 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);
}
}
Nhìn chung, cách làm tốt nhất là gọi increaseZoomLevel() 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
| Thông số kỹ thuật |
|---|
| Captured Surface Control # dom-capturecontroller-increasezoomlevel |