MediaTrackConstraints: logicalSurface property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Thuộc tính logicalSurface của từ điển MediaTrackConstraints là ConstrainDOMString mô tả các ràng buộc được yêu cầu hoặc bắt buộc đặt lên giá trị của thuộc tính có thể ràng buộc logicalSurface.
Điều này được sử dụng để chỉ định xem getDisplayMedia() có nên cho phép người dùng chọn các bề mặt hiển thị không nhất thiết hoàn toàn hiển thị trên màn hình hay không, chẳng hạn như các cửa sổ bị che khuất hoặc toàn bộ nội dung của các cửa sổ đủ lớn để yêu cầu cuộn để xem toàn bộ nội dung của chúng.
Nếu cần, bạn có thể xác định xem ràng buộc này có được hỗ trợ hay không bằng cách kiểm tra giá trị của MediaTrackSupportedConstraints.logicalSurface như được trả về bởi lệnh gọi MediaDevices.getSupportedConstraints(). Tuy nhiên, thông thường điều này là không cần thiết vì các trình duyệt sẽ bỏ qua mọi ràng buộc mà chúng không quen.
Giá trị
ConstrainBoolean là true nếu các bề mặt logic nên được cho phép trong số các lựa chọn có thể cho người dùng.
Ghi chú sử dụng
Bạn có thể kiểm tra cài đặt được user agent chọn sau khi phương tiện hiển thị đã được tạo bởi getDisplayMedia() bằng cách gọi getSettings() trên rãnh video MediaStreamTrack của phương tiện hiển thị, sau đó kiểm tra giá trị của đối tượng MediaTrackSettings được trả về logicalSurface.
Ví dụ, nếu ứng dụng của bạn cần biết liệu bề mặt hiển thị được chọn có phải là bề mặt logic hay không:
let isLogicalSurface = displayStream
.getVideoTracks()[0]
.getSettings().logicalSurface;
Sau code này, isLogicalSurface là true nếu bề mặt hiển thị trong luồng là bề mặt logic; tức là bề mặt có thể không hoàn toàn hiển thị trên màn hình, hoặc thậm chí hoàn toàn nằm ngoài màn hình.
Thông số kỹ thuật
| Specification |
|---|
| Screen Capture # dom-mediatrackconstraintset-logicalsurface |