Window: gamepadconnected 事件

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

当浏览器检测到游戏手柄已连接,或者游戏手柄的第一个按钮/轴被使用时,会触发 gamepadconnected 事件。

如果文档的 gamepad 权限策略 禁止,则此事件不会触发。

此事件不可取消,也不会冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("gamepadconnected", (event) => { })

ongamepadconnected = (event) => { }

示例

要获知游戏手柄何时连接,您可以使用 addEventListener() 在 window 上添加一个处理程序,如下所示:

js
window.addEventListener("gamepadconnected", (event) => {
  // All buttons and axes values can be accessed through
  const gamepad = event.gamepad;
});

或者,您可以使用 window.ongamepadconnected 事件处理程序属性来为 gamepadconnected 事件建立一个处理程序。

js
window.ongamepadconnected = (event) => {
  // All buttons and axes values can be accessed through
  const gamepad = event.gamepad;
};

规范

规范
Gamepad
# event-gamepadconnected

浏览器兼容性

另见