XRInputSourceArray

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在部分或全部支持的浏览器中可用。

实验性:这是一项实验性技术
在生产环境中使用之前,请仔细查看浏览器兼容性表格

XRInputSourceArray 接口表示 WebXR 输入源的实时列表,用作XRSession 属性inputSources的返回值。每个条目都是一个XRInputSource,表示连接到 WebXR 系统的一个输入设备。

除了能够使用标准数组表示法(即,在方括号中使用索引号)访问列表中的输入源之外,还可以使用方法来允许使用迭代器,并且forEach() 方法也可用。

实例属性

以下属性可用于 XRInputSourceArray 对象。

length 只读 实验性

列表中XRInputSource 对象的数量。

实例方法

以下方法可用于 XRInputSourceArray 对象。您也可以使用Symbol 类型的功能。

entries() 实验性

返回一个迭代器,您可以使用它来遍历列表中键/值对的列表。返回的每个项目都是一个数组,其第一个值是索引,其第二个值是该索引处的XRInputSource

forEach() 实验性

按顺序遍历列表中的每个项目,从第一个到最后一个。

keys() 实验性

与输入源列表中的条目相对应的键的列表。

values() 实验性

返回一个 迭代器,您可以使用它遍历列表中的所有值。每个项目都是一个单独的XRInputSource 对象。

除了这些方法之外,您还可以使用数组表示法按索引访问列表中的项目。例如,以下代码段调用一个名为 handleInput() 的函数,如果列表不为空,则将输入源列表中的第一个项目传递给它。

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

示例

规范

规范
WebXR 设备 API
# xrinputsourcearray-interface

浏览器兼容性

BCD 表格仅在浏览器中加载