GamepadEvent

Baseline 广泛可用 *

此特性已得到良好确立,可跨多种设备和浏览器版本使用。自 2017 年 3 月起,所有浏览器均支持此特性。

* 此特性的某些部分可能存在不同级别的支持。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

Gamepad API 的 GamepadEvent 接口包含对连接到系统的游戏手柄的引用,gamepadconnectedgamepaddisconnected 事件就是响应这些游戏手柄而触发的。

Event GamepadEvent

构造函数

GamepadEvent()

返回一个新的 GamepadEvent 对象。

实例属性

GamepadEvent.gamepad 只读

返回一个 Gamepad 对象,提供对所触发事件的相关游戏手柄数据的访问。

示例

在触发 gamepadconnected 事件时调用的 gamepad 属性。

js
window.addEventListener("gamepadconnected", (e) => {
  console.log(
    "Gamepad connected at index %d: %s. %d buttons, %d axes.",
    e.gamepad.index,
    e.gamepad.id,
    e.gamepad.buttons.length,
    e.gamepad.axes.length,
  );
});

gamepaddisconnected 事件中调用的 gamepad 属性。

js
window.addEventListener("gamepaddisconnected", (e) => {
  console.log(
    "Gamepad disconnected from index %d: %s",
    e.gamepad.index,
    e.gamepad.id,
  );
});

规范

规范
Gamepad
# gamepadevent-interface

浏览器兼容性

另见

使用游戏手柄 API