如何在瀏覽器中測試遊戲手把？

透過 USB 或 Bluetooth 連接控制器，然後按任何按鍵。測試透過 Gamepad API 自動偵測手把並即時顯示所有按鍵、搖桿和板機狀態。

支援哪些控制器？

瀏覽器可識別的任何控制器：Xbox（One、Series X/S）、PlayStation（DualShock 4、DualSense）、Nintendo Switch Pro，以及大多數具有標準對映的通用 USB/Bluetooth 手把。

連接後按控制器上的按鍵 — 瀏覽器需要按鍵才能啟動 Gamepad API。如仍未偵測到，嘗試不同 USB 連接埠、重新配對 Bluetooth，或檢查是否有其他應用獨佔。

不會。Gamepad API 完全在 JavaScript 中執行。輸入值透過 requestAnimationFrame 輪詢讀取，不會離開瀏覽器。

連接控制器並按任何按鍵開始。此測試即時讀取 Gamepad API — 顯示按鍵狀態、類比搖桿位置、板機值和振動支援。100% 瀏覽器端，零資料上傳。

透過 requestAnimationFrame 輪詢 Gamepad API，即時顯示所有按鍵、類比搖桿 X/Y 軸（±1.0 範圍）、板機壓力（0-1.0）和振動致動器支援。

Gamepad API 標準對映最多 17 個按鍵和 4 個軸；Xbox、PlayStation 和 Switch Pro 控制器都遵循標準對映。

Connect a gamepad and press any button

Supports Xbox, PlayStation, Switch, and generic controllers

Result	Range	Meaning
良好	所有按鍵和搖桿正常反應	每個輸入都對映到預期的按鍵索引，搖桿放開時回到中心（0, 0），板機報告完整 0-1.0 範圍 — 控制器完全正常。
警告	搖桿偏移或板機範圍不完整	搖桿靜止時不回到 0.0 表示搖桿偏移 — 電位器磨損。板機範圍不完整可能是機械止擋或校準問題。
不佳	按鍵無反應或未偵測到控制器	按鍵無反應表示接觸故障。未偵測到控制器，請檢查驅動程式、嘗試不同 USB 連接埠或重新配對 Bluetooth。

瀏覽器偵測不到控制器

連接後按任何按鍵 — Gamepad API 需要物理按鍵才能啟動。如仍未偵測到，嘗試其他 USB 連接埠、重新配對 Bluetooth，或關閉可能獨佔控制器的應用程式。

類比搖桿顯示偏移（靜止時非零值）

搖桿偏移是搖桿模組內電位器磨損造成的。在遊戲設定中增加死區作為變通方案，或更換搖桿模組以永久修復。