XRSessionEvent

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Giao diện XRSessionEvent của WebXR Device API mô tả một sự kiện cho biết sự thay đổi trạng thái của XRSession. Các sự kiện này xảy ra, ví dụ, khi phiên kết thúc hoặc trạng thái hiển thị của ngữ cảnh thay đổi.

Event XRSessionEvent

Hàm khởi tạo

XRSessionEvent()

Tạo và trả về một đối tượng XRSessionEvent mới.

Thuộc tính phiên bản

Ngoài các thuộc tính được kế thừa từ giao diện cha Event, XRSessionEvent cung cấp thêm:

session Read only

XRSession mà sự kiện tham chiếu đến.

Phương thức phiên bản

Mặc dù XRSessionEvent không định nghĩa phương thức nào, nó kế thừa các phương thức từ giao diện cha Event.

Các loại sự kiện phiên

Các sự kiện sau đây được đại diện bằng giao diện XRSessionEvent và là các giá trị hợp lệ cho thuộc tính type của nó.

end

Được kích hoạt trên phiên khi nó đã kết thúc, sau khi được chấm dứt bởi ứng dụng hoặc user agent.

visibilitychange

Được kích hoạt trên phiên bất cứ khi nào trạng thái hiển thị của nó thay đổi.

Ví dụ

Ví dụ này tạo một listener theo dõi sự thay đổi trạng thái hiển thị của phiên. Nó phản ứng bằng cách gọi hàm mySessionVisible() với giá trị Boolean cho biết phiên có hiển thị hay không; hàm này, chẳng hạn, có thể khởi động hoặc cấu hình lại một worker xử lý việc kết xuất cảnh.

js
xrSession.addEventListener("visibilitychange", (e) => {
  switch (e.session.visibilityState) {
    case "visible":
    case "visible-blurred":
      mySessionVisible(true);
      break;
    case "hidden":
      mySessionVisible(false);
      break;
  }
});

Thông số kỹ thuật

Specification
WebXR Device API
# xrsessionevent-interface

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