Gamepad: index property

Baseline 已广泛支持

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

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

Gamepad 接口的 Gamepad.index 属性返回一个整数,该整数会自动递增,以确保当前连接到系统的每个设备都具有唯一性。

这可用于区分多个控制器;断开连接后重新连接的手柄将保留相同的索引。

一个 number

示例

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

规范

规范
Gamepad
# dom-gamepad-index

浏览器兼容性

另见

使用游戏手柄 API