XRInputSourceArray
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.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Giao diện XRInputSourceArray đại diện cho danh sách trực tiếp các nguồn đầu vào WebXR, và được sử dụng làm giá trị trả về của thuộc tính inputSources của XRSession. Mỗi mục là một XRInputSource đại diện cho một thiết bị đầu vào được kết nối với hệ thống WebXR.
Ngoài việc có thể truy cập các nguồn đầu vào trong danh sách bằng ký hiệu mảng chuẩn (tức là, với số chỉ mục bên trong dấu ngoặc vuông), các phương thức có sẵn để sử dụng iterator và phương thức forEach() cũng có sẵn.
Thuộc tính phiên bản
Các thuộc tính sau có sẵn trên các đối tượng XRInputSourceArray.
lengthRead only Experimental-
Số lượng đối tượng
XRInputSourcetrong danh sách.
Phương thức phiên bản
Các phương thức sau có sẵn trên các đối tượng XRInputSourceArray. Bạn cũng có thể sử dụng các tính năng của kiểu Symbol.
entries()Experimental-
Trả về một
iteratorbạn có thể sử dụng để duyệt danh sách các cặp key/value trong danh sách. Mỗi mục trả về là một mảng có giá trị đầu tiên là chỉ mục và giá trị thứ hai làXRInputSourcetại chỉ mục đó. forEach()Experimental-
Lặp qua từng mục trong danh sách, theo thứ tự từ đầu đến cuối.
keys()Experimental-
Danh sách các khóa tương ứng với các mục trong danh sách nguồn đầu vào.
values()Experimental-
Trả về một
iteratorbạn có thể sử dụng để duyệt qua tất cả các giá trị trong danh sách. Mỗi mục là một đối tượngXRInputSourceduy nhất.
Ngoài các phương thức này, bạn có thể sử dụng ký hiệu mảng để truy cập các mục trong danh sách theo chỉ mục. Ví dụ, đoạn code dưới đây gọi hàm handleInput(), truyền vào mục đầu tiên trong danh sách nguồn đầu vào, nếu danh sách không rỗng.
let sources = xrSession.inputSources;
if (sources.length > 0) {
handleInput(sources[0]);
}
Thông số kỹ thuật
| Specification |
|---|
| WebXR Device API # xrinputsourcearray-interface |