XRInputSource: gamepad 属性

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

只读 XRInputSource 属性 gamepad 返回一个 Gamepad 对象,描述 XR 输入源上的按钮和轴的状态,如果它是游戏手柄或类似设备。如果设备不是游戏手柄类设备,则此属性的值为 null

返回的 Gamepad 实例的行为如 Gamepad API 中所述。但是,需要注意以下几点

示例

使用游戏手柄输入源

js
for (const source of frame.session.inputSources) {
  const gamepad = source.gamepad;
  if (gamepad) {
    if (gamepad.buttons[2].pressed) {
      // do something
    }
  }
}

规范

规范
WebXR 游戏手柄模块 - 级别 1
# dom-xrinputsource-gamepad

浏览器兼容性

BCD 表仅在浏览器中加载