游戏手柄：displayId 属性

已弃用：此功能不再推荐。虽然一些浏览器可能仍然支持它，但它可能已被从相关 Web 标准中删除，可能正在被删除，或者可能只保留用于兼容性目的。避免使用它，如果可能，更新现有代码；请参阅此页面底部的兼容性表来指导您的决策。请注意，此功能可能随时停止工作。

非标准：此功能是非标准的，并且不在标准跟踪中。不要在面向 Web 的生产网站上使用它：它不会对每个用户都起作用。实现之间也可能存在很大差异，并且行为可能会在将来发生变化。

Gamepad 接口的 displayId 只读属性返回关联的VRDisplay.displayId - 游戏手柄控制其显示场景的 VRDisplay。

如果游戏手柄报告的姿态与显示姿态在同一个空间中，则认为该游戏手柄与VRDisplay相关联，请参阅VRDisplay.getPose()。

注意：此属性是旧的WebVR API的一部分。它已被WebXR 游戏手柄模块取代。

此属性没有直接替代品。可以使用XRInputSource.gamepad 属性获取与XRInputSource 关联的Gamepad 对象。

值

表示关联的VRDisplay.displayId 的数字。如果数字为 0，则游戏手柄与 VR 显示无关联。

示例

window.addEventListener("gamepadconnected", (e) => {
  if (!e.gamepad.displayId) {
    console.log("Gamepad connected");
  } else {
    console.log(
      `Gamepad connected, associated with VR display ${e.gamepad.displayId}`,
    );
  }
});

规范

此属性是旧的WebVR API的一部分，它已被WebXR 游戏手柄模块取代。它不再处于成为标准的轨道上。

在所有浏览器都实现新的WebXR API 之前，建议依赖框架（如A-Frame、Babylon.js 或Three.js），或者依赖polyfill，来开发将在所有浏览器中运行的 WebXR 应用程序[1]。

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

WebVR API