XRInputSourceArray

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

XRInputSourceArray 介面表示一個即時的 WebXR 輸入源列表，並用作 XRSession 屬性 inputSources 的返回值。列表中的每個條目都是一個 XRInputSource，代表一個連線到 WebXR 系統的輸入裝置。

除了可以使用標準的陣列表示法（即使用方括號內的索引號）來訪問列表中的輸入源之外，還可以使用方法來使用迭代器，並且還提供了 forEach() 方法。

例項屬性

XRInputSourceArray 物件具有以下屬性。

XRInputSourceArray 物件具有以下方法。您也可以使用 Symbol 型別的特性。

entries() 實驗性: 返回一個 iterator，您可以使用它來遍歷列表中鍵/值對。返回的每個項都是一個數組，其第一個值是索引，第二個值是該索引處的 XRInputSource。
forEach() 實驗性: 按順序（從第一個到最後一個）遍歷列表中的每個項。
keys() 實驗性: 輸入源列表中對應條目的鍵的列表。
values() 實驗性: 返回一個 iterator，您可以使用它來遍歷列表中的所有值。每個項都是一個單獨的 XRInputSource 物件。

除了這些方法之外，您還可以使用陣列表示法按索引訪問列表中的項。例如，下面的程式碼片段呼叫函式 handleInput()，並將輸入源列表中的第一個項傳遞給它，前提是列表不為空。

let sources = xrSession.inputSources;
if (sources.length > 0) {
  handleInput(sources[0]);
}

規範
WebXR Device API # xrinputsourcearray-interface

此頁面最後修改於 2025年3月11日，由 MDN 貢獻者貢獻。