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 贡献者贡献。