XRInputSourcesChangeEvent

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 XRInputSourcesChangeEvent của WebXR Device API được dùng để biểu diễn sự kiện inputsourceschange gửi đến một XRSession khi tập hợp các bộ điều khiển đầu vào WebXR có sẵn thay đổi.

Event XRInputSourcesChangeEvent

Hàm khởi tạo

XRInputSourcesChangeEvent()

Tạo và trả về một đối tượng XRInputSourcesChangeEvent mới. Loại được chỉ định phải là inputsourceschange, là sự kiện duy nhất sử dụng giao diện này.

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

added Read only

Mảng gồm không hoặc nhiều đối tượng XRInputSource, mỗi đối tượng biểu diễn một thiết bị đầu vào vừa được kết nối mới hoặc được bật để sử dụng.

removed Read only

Mảng gồm không hoặc nhiều đối tượng XRInputSource biểu diễn các thiết bị đầu vào vừa bị ngắt kết nối hoặc bị vô hiệu hóa.

session Read only

XRSession mà sự kiện thay đổi nguồn đầu vào này được gửi đến.

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

Trong khi XRInputSourcesChangeEvent không định nghĩa phương thức nào của riêng mình, nó kế thừa các phương thức từ giao diện cha, Event.

Các loại sự kiện

inputsourceschange

Được gửi đến XRSession khi tập hợp các thiết bị đầu vào có sẵn với nó thay đổi.

Ví dụ

Ví dụ sau đây cho thấy cách thiết lập trình xử lý sự kiện sử dụng các sự kiện inputsourceschange để phát hiện các thiết bị trỏ mới có sẵn và tải mô hình của chúng để chuẩn bị hiển thị trong khung hình hoạt ảnh tiếp theo.

js
xrSession.addEventListener("inputsourceschange", onInputSourcesChange);

function onInputSourcesChange(event) {
  for (const input of event.added) {
    if (input.targetRayMode === "tracked-pointer") {
      loadControllerMesh(input);
    }
  }
}

Bạn cũng có thể thêm trình xử lý cho các sự kiện inputsourceschange bằng cách đặt trình xử lý sự kiện oninputsourceschange:

js
xrSession.oninputsourceschange = onInputSourcesChange;

Thông số kỹ thuật

Specification
WebXR Device API
# xrinputsourceschangeevent-interface

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