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 设备 API
# dom-xrinputsourcearray-length

浏览器兼容性

BCD 表仅在浏览器中加载