XRSession: thuộc tính visibilityState

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.

Thuộc tính chỉ đọc visibilityState của giao diện XRSession là một chuỗi cho biết nội dung WebXR có hiện đang hiển thị cho người dùng hay không và nếu có, liệu nó có phải là trọng tâm chính hay không.

Mỗi khi trạng thái hiển thị thay đổi, một sự kiện visibilitychange được gửi trên đối tượng XRSession.

Giá trị

Một chuỗi cho biết nội dung XR có hiển thị cho người dùng hay không và nếu có, liệu nó có hiện là trọng tâm chính hay không.

Các giá trị có thể của visibilityState là:

hidden: Cảnh ảo được tạo bởi XRSession hiện không hiển thị cho người dùng, vì vậy các callback requestAnimationFrame() của nó không được thực thi cho đến khi visibilityState thay đổi. Các bộ điều khiển đầu vào không được xử lý cho phiên.
visible: Cảnh ảo được kết xuất bởi XRSession hiện đang hiển thị cho người dùng và là trọng tâm chính của sự chú ý người dùng. Do đó, các callback requestAnimationFrame() của phiên đang được thực thi ở tốc độ làm mới gốc của thiết bị XR và các bộ điều khiển đầu vào đang được xử lý bình thường.
visible-blurred: Mặc dù cảnh ảo được kết xuất bởi XRSession có thể hiện đang hiển thị cho người dùng, nhưng nó không phải là trọng tâm chính của người dùng vào lúc này; cũng có thể phiên hiện không hiển thị. Để tối ưu hóa việc sử dụng tài nguyên, user agent có thể đang xử lý các callback requestAnimationFrame() của phiên ở tốc độ bị giới hạn. Các bộ điều khiển đầu vào không được xử lý cho phiên.

Ghi chú sử dụng

Điều quan trọng cần lưu ý là vì một phiên WebXR nhập vai có khả năng được hiển thị bằng màn hình khác với tài liệu HTML mà nó đang chạy (chẳng hạn như khi được hiển thị trên kính thực tế ảo), giá trị của visibilityState của phiên không nhất thiết phải giống với visibilityState của document sở hữu. Ví dụ: nếu người xem đang sử dụng kính thực tế ảo được nối với máy tính và cảnh nhập vai bị che khuất bởi giao diện cấu hình, người dùng có thể nhìn ra phía sau kính và vẫn có thể thấy tài liệu trên màn hình máy tính của họ.

Thông số kỹ thuật

Thông số kỹ thuật
WebXR Device API # dom-xrsession-visibilitystate

Tương thích trình duyệt

Xem thêm

Sự kiện visibilitychange

Help improve MDN

Tìm hiểu cách đóng góp

This page was last modified on Jan 1, 1970 by MDN contributors.

Xem trang này trên GitHub • Báo cáo sự cố với nội dung này