大网数据广告活动
Web 标准与前端开发

XRInputSource: gamepad property

· 52CE 我爱测

The read-only XRInputSource property **`gamepad`** returns a Gamepad object describing the state of the buttons and axes on the XR input source, if it is a gamepad or comparable device. If the device isn't a gamepad-like device, this property's value is `null`.

WebXR Device API

The read-only XRInputSource property gamepad returns a Gamepad object describing the state of the buttons and axes on the XR input source, if it is a gamepad or comparable device. If the device isn't a gamepad-like device, this property's value is null.

The Gamepad instance returned behaves as described by the Gamepad API. However, there are a few things to note:

  • Gamepad instances belonging to XRInputSource are not included in the array returned by navigator.getGamepads(). Gamepads are strictly associated with the WebXR hardware and are not general-purpose gaming devices.
  • Gamepad.id is an empty string ("")
  • Gamepad.index is -1
  • Gamepad.connected is true until the XRInputSource is removed from the list of active XR input sources or the XRSession is ended.
  • If an axis reported by Gamepad.axes represents an axis of a touchpad, the value is 0 when the associated GamepadButton.touched property is false.
  • Gamepad.mapping returns "xr-standard".

Examples

Using a gamepad input source

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

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。