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