游戏手柄 API

安全上下文：此功能仅在安全上下文（HTTPS）中可用，并且在某些或所有支持的浏览器中可用。

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

接口

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

实验性游戏手柄扩展

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

对其他接口的扩展

导航器

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

窗口事件

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

教程和指南

规范

规范
游戏手柄 # gamepad-interface
游戏手柄扩展 # partial-gamepad-interface

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅

游戏手柄 API 由 Ted Mielczarek 和 Robert Nyman 编写
简单的 API 演示页面 (源代码)