Gamepad: id 屬性

Baseline 已廣泛支援

此特性已得到良好確立,可跨多種裝置和瀏覽器版本使用。自 2017 年 3 月起,所有瀏覽器均支援此特性。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

Gamepad 介面的 Gamepad.id 屬性返回一個包含控制器資訊的字串。

具體的語法並沒有嚴格規定,但在 Firefox 中,它會包含三部分資訊,用破折號 (-) 分隔:

  • 包含控制器 USB 供應商 ID 和產品 ID 的兩個 4 位十六進位制字串
  • 驅動程式提供的控制器名稱。

例如,一個 PS2 控制器返回 810-3-USB Gamepad

這些資訊旨在允許您查詢裝置上控制元件的對映,以及向用戶顯示有用的反饋。

字串原始型別。

示例

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

規範

規範
Gamepad
# dom-gamepad-id

瀏覽器相容性

另見

使用遊戲手柄 API