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

Gamepad

· 52CE 我爱测

Gamepad API 的 `Gamepad` 接口,定义了一个独立的游戏手柄或其他控制器,允许访问控制器的信息,譬如按钮按下的状态、坐标输入的位置。游戏手柄或其他控制器,允许访问如按钮按下,和 ID 等信息。

Gamepad API

Gamepad API 的 Gamepad 接口,定义了一个独立的游戏手柄或其他控制器,允许访问控制器的信息,譬如按钮按下的状态、坐标输入的位置。游戏手柄或其他控制器,允许访问如按钮按下,和 ID 等信息。

Gamepad 对象有两种方式返回值:通过 gamepadconnected 和 gamepaddisconnected 事件的 gamepad 属性,或者在任意位置抓取 Navigator.getGamepads() 方法返回的数组。

属性

  • Gamepad.axes
    • : 一个表示控制器设备上存在的坐标轴的数组 (比如控制器摇杆)。
  • Gamepad.buttons
    • : 一个 gamepadButton 对象的数组,表示设备上的按键的数组。
  • Gamepad.connected
    • : 一个表示控制器是否仍然连接着系统的布尔值。
  • Gamepad.displayId
    • : 返回与 VRDisplay 相关的 VRDisplay.displayId (如果有相关) — 控制器所控制的 VRDisplay 场景。
  • Gamepad.id
    • : 一个包含着控制器标识信息的 String。
  • Gamepad.index
    • : 一个自增的整形数字,对于当前连接到系统的每一个设备是唯一的。
  • Gamepad.mapping
    • : 一个指示浏览器是否被映射到某个已知布局的字符串。
  • Gamepad.timestamp
    • : 一个表示上次控制器数据更新时间的 DOMHighResTimeStamp 。
  • Gamepad.hand
    • : 一个枚举项,定义了控制器是用哪只手拿着的,或最可能是哪只手拿着的。
  • Gamepad.hapticActuators
    • : 一个包含 GamepadHapticActuator 对象的数组,其中表示控制器上可用的触觉反馈硬件。
  • Gamepad.pose
    • : 一个表示 WebVR 控制器姿态方位信息的 GamepadPose 对象 (比如其在 3D 空间中的位置和方向)。

示例

window.addEventListener("gamepadconnected", function (e) {
  console.log(
    "控制器已连接与 %d 位:%s. %d 个按钮,%d 个坐标方向。",
    e.gamepad.index,
    e.gamepad.id,
    e.gamepad.buttons.length,
    e.gamepad.axes.length,
  );
});

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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