XRInputSourceArray: length 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

只读的 length 属性返回一个整数值,指示 XRInputSourceArray 对象所表示的输入源列表中的项目数。

一个整数值,指示数组中包含的代表 WebXR 输入源的 XRInputSource 对象的数量。

示例

在此示例中,一个需要至少一个输入源的游戏使用 length 在继续允许用户玩游戏之前进行检查。

js
let sources = xrSession.inputSources;

if (sources.length === 0) {
  showAlertDialog(
    "You need to have at least one controller to play Super Duper Shark Jump Fest 9000.",
    [
      { label: "Shop Now", url: "https://www.example.com/shop/controllers" },
      { label: "Quit", handler: quitGame },
    ],
  );
}

在这里,如果 length 为 0,则会调用一个假设的 showAlertDialog() 函数,该函数带有一个解释需要控制器的提示字符串,以及一个对象数组,每个对象描述一个按钮及其单击时应发生的操作。第一个会将用户带到 Amazon.com 搜索 VR 控制器的页面,第二个将调用 quitGame() 函数来开始关闭游戏程序。

规范

规范
WebXR Device API
# dom-xrinputsourcearray-length

浏览器兼容性