GamepadEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Gamepad API 的 GamepadEvent 接口包含对连接到系统的控制器的引用，这也是 gamepad 事件 events Window.gamepadconnected 与 Window.gamepaddisconnected 被触发时响应的内容。

构造函数

GamepadEvent()

返回一个新的 GamepadEvent 对象。

属性

GamepadEvent.gamepad 只读

返回一个 Gamepad 对象，提供触发事件的控制器数据的访问。

示例

在触发的 Window.gamepadconnected 事件上调用控制器属性。

js
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,
  );
});

与 Window.gamepaddisconnected 事件上的。

js
window.addEventListener("gamepaddisconnected", function (e) {
  console.log("控制器已从 %d 位断开：%s", e.gamepad.index, e.gamepad.id);
});

规范

Specification
Gamepad
# gamepadevent-interface

浏览器兼容性

BCD tables only load in the browser

参见

使用 Gamepad API