Gamepad API

Baseline 广泛可用 *

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

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

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

Gamepad API 是一种允许开发者以简单、一致的方式访问和响应游戏手柄及其他游戏控制器信号的方式。它包含三个接口、两个事件和一个专用函数，用于响应游戏手柄的连接和断开，以及访问有关游戏手柄本身以及当前按下的按钮和其他控件的信息。

接口

Gamepad: 表示连接到计算机的游戏手柄/控制器。
GamepadButton: 表示连接的控制器上的一个按钮。
GamepadEvent: 代表与游戏手柄相关的事件的事件对象。

实验性的 Gamepad 扩展

GamepadHapticActuator: 表示控制器中为用户提供触觉反馈（如果可用）的硬件，最常见的是振动硬件。
GamepadPose: 表示控制器在 3D 空间中的姿态（例如位置和方向），适用于 WebVR 控制器。较新的 WebXR 标准不使用此功能。

其他接口的扩展

Navigator

Navigator.getGamepads(): 对 Navigator 对象的扩展，该对象返回一个 Gamepad 对象数组，每个连接的游戏手柄对应一个对象。

窗口事件

gamepadconnected: 当游戏手柄连接时会触发的事件。
gamepaddisconnected: 当游戏手柄断开连接时会触发的事件。

教程和指南

规范

规范
Gamepad # gamepad-interface
Gamepad 扩展 # partial-gamepad-interface

浏览器兼容性

另见

The Gamepad API by Ted Mielczarek and Robert Nyman
Simple API demo page (source)

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年4月3日，作者为 MDN 贡献者。

在 GitHub 上查看此页面 • 报告此内容的笔误