Gamepad: id 属性

Baseline 已广泛支持

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

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

Gamepad 接口的 Gamepad.id 属性返回一个包含控制器信息的字符串。

具体的语法并没有严格规定，但在 Firefox 中，它会包含三部分信息，用破折号 (-) 分隔：

包含控制器 USB 供应商 ID 和产品 ID 的两个 4 位十六进制字符串
驱动程序提供的控制器名称。

例如，一个 PS2 控制器返回 810-3-USB Gamepad。

这些信息旨在允许您查找设备上控件的映射，以及向用户显示有用的反馈。

值

字符串原始类型。

示例

window.addEventListener("gamepadconnected", () => {
  const gp = navigator.getGamepads()[0];
  gamepadInfo.textContent = `Gamepad connected at index ${gp.index}: ${gp.id}.`;
});

规范

规范
Gamepad # dom-gamepad-id

浏览器兼容性

另见

使用游戏手柄 API

帮助改进 MDN

了解如何贡献

此页面最后修改于 2024年2月5日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的某个问题