CaptureController: phương thức setFocusBehavior()
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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 setFocusBehavior() của giao diện CaptureController kiểm soát việc tab hoặc cửa sổ đang được chụp có được nhận tiêu điểm khi Promise của MediaDevices.getDisplayMedia() liên kết hoàn tất hay không, hoặc tiêu điểm sẽ tiếp tục nằm ở tab chứa ứng dụng chụp.
Bạn có thể đặt hành vi này nhiều lần trước lời gọi MediaDevices.getDisplayMedia(), hoặc một lần ngay sau khi Promise của nó được giải quyết. Sau thời điểm đó, hành vi tiêu điểm được coi là đã được chốt và không thể thay đổi nữa.
Syntax
setFocusBehavior(focusBehavior)
Parameters
focusBehavior-
Một giá trị liệt kê mô tả việc user agent nên chuyển tiêu điểm sang bề mặt hiển thị đang được chụp hay giữ tiêu điểm ở ứng dụng chụp. Các giá trị có thể là
focus-captured-surface(chuyển tiêu điểm) vàno-focus-change(giữ tiêu điểm ở ứng dụng chụp).
Return value
Không có (undefined).
Exceptions
InvalidStateErrorDOMException-
Được ném ra nếu:
- Luồng chụp đã bị dừng.
- Người dùng chọn chia sẻ một màn hình (kiểu
displaySurfacelàmonitor) thay vì tabbrowserhoặcwindow; bạn không thể đặt tiêu điểm cho một màn hình. Trong trường hợp này, ngoại lệ được ném ra sau khiPromisecủaMediaDevices.getDisplayMedia()được giải quyết. - Đã trôi qua đủ thời gian sau khi
PromisecủaMediaDevices.getDisplayMedia()hoàn tất để hành vi tiêu điểm được chốt lại.
Examples
Cách dùng setFocusBehavior() cơ bản
// Create a new CaptureController instance
const controller = new CaptureController();
// Prompt the user to share a tab, window, or screen.
const stream = await navigator.mediaDevices.getDisplayMedia({ controller });
// Query the displaySurface value of the captured video track
const [track] = stream.getVideoTracks();
const displaySurface = track.getSettings().displaySurface;
if (displaySurface === "browser") {
// Focus the captured tab.
controller.setFocusBehavior("focus-captured-surface");
} else if (displaySurface === "window") {
// Do not move focus to the captured window.
// Keep the capturing page focused.
controller.setFocusBehavior("no-focus-change");
}
Specifications
| Thông số kỹ thuật |
|---|
| Screen Capture # dom-capturecontroller-setfocusbehavior |