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 Gamepads Module - Level 1
# dom-xrinputsource-gamepad

浏览器兼容性