按鍵映射檢測

未連接控制器

如何使用： 按下控制器上的任意實體按鍵。觀察畫面上亮起的區塊及其對應的邏輯編號 (Index)。如果亮起的區塊與您按下的實體按鍵不符，代表有軟體修改了映射，或是驅動程式判定有誤。

即時事件紀錄

等待輸入...

原始軸向數據

軸向 00.00000

軸向 10.00000

軸向 20.00000

軸向 30.00000

Standard Gamepad：統一的網頁標準

W3C 如何透過 17 個按鍵與 4 個軸向，定義跨平台控制器的未來？

W3C 標準

Standard Gamepad 按鍵佈局

Gamepad API 規定了一套固定的「標準控制器 (Standard Gamepad)」版面：4 個正面面板按鍵 (Index 0-3，對應 ABXY)、4 個肩鍵/扳機 (Index 4-7，對應 LB/RB/LT/RT)、系統鍵 (Index 8-9) 等。

按鍵編號快速對照

0-3: A/B/X/Y (正面面板)

10-11: LS/RS (搖桿下壓)

4-5: LB/RB (肩鍵)

12-15: 十字鍵 (D-Pad)

6-7: LT/RT (扳機)

16+: Home/Share (擴充鍵)

軸向數據 (Axes)

0/1: 左搖桿 X/Y 軸　2/3: 右搖桿 X/Y 軸 (數據範圍 -1.0 到 1.0)

Standard Gamepad API

為什麼我的手把映射是錯的？

DirectInput、XInput、不同驅動程式... 揭開按鍵錯亂背後的真相

DirectInput 的混亂

舊版的 DirectInput 並沒有規定按鍵順序，各家廠商可自由定義。PS 手把的 "×" 鍵可能是 Index 0，也可能是 Index 1。這意味著：相同的實體按鍵，在不同驅動程式下會有完全不同的編號。

驅動層級的映射修改

像 DS4Windows 或 BetterJoy 這樣的工具，會將您的手把「偽裝」成 Xbox 控制器。這會強制修改按鍵映射以符合 Standard Gamepad 的規範。這是預期中的正常行為，並非故障。

常見問題 (FAQ)

關於控制器按鍵配置的所有疑問

Q為什麼我的十字鍵 (D-Pad) 顯示在 Axes 裡而不是 Buttons？

某些舊款手把 (例如使用原廠驅動的 Xbox 360 控制器) 會將十字鍵實作為類比軸向 (Axis 6/7) 而非四個獨立的按鍵。這是硬體設計與驅動的雙重結果，瀏覽器只是如實反映系統接收到的狀態。

Q為什麼 LT/RT 有時是按鍵，有時是軸向？

這取決於驅動模式。在 XInput 模式下，LT/RT 通常是按鍵 6/7。但在 DirectInput 模式下，它們可能會合併成一個類比軸。Standard Gamepad 規範要求將扳機定義為按鍵 (但會同時回報壓力值)。

Q我可以自己修改網頁中的按鍵映射嗎？

不行。瀏覽器的 Gamepad API 是唯讀的。解決方案：① 使用系統層級工具 (如 AntiMicro、JoyToKey)；② 在遊戲內自訂按鍵；③ 更換驅動程式軟體 (例如 DS4Windows)。

Q為什麼我的手把顯示有 20 幾個按鍵？

部份進階控制器 (如飛行搖桿、賽車方向盤) 擁有多達數十個實體按鍵。瀏覽器會嘗試列出所有按鍵，但 Standard Gamepad 僅定義了前 17 個。第 18 個之後的按鍵就沒有標準的對應名稱了。

了解手把按鍵映射

為什麼按下 A 畫面上卻顯示 B？透過線上測試工具來揭開底層驅動邏輯的面紗。這是在 PC 上檢測按鍵問題及排除按鍵映射錯誤的最佳方法。

XInput 標準協定

多數 PC 遊戲與瀏覽器皆遵循 Xbox 360 手把佈局標準。只要連接至系統，無論您的手把是何種品牌，系統都會自動將按鍵對應至 0-16 的標準索引值。

按鍵 0: A (底部)

按鍵 1: B (右側)

按鍵 2: X (左側)

按鍵 3: Y (上方)

常見的映射問題

任天堂佈局衝突: Switch 手把硬體上是「右 A，底 B」，但 PC 的系統預設會讀成「底 A，右 B」。如果測試時覺得按鍵被反轉了，是因為協定差異所致，可透過 Steam Input 修正。
背鍵/巨集檢測: 如果您使用了背鍵映射或巨集功能，此工具會顯示重新映射後的邏輯按鍵。例如，若將背鍵綁定為 A，按下它時工具就會亮起按鍵 0 (Button 0)。

關於 API 索引 (Indices)

索引 0-3: 傳統功能按鍵 (ABXY)

索引 4-5: 肩鍵 (LB/RB)

索引 6-7: 扳機 (LT/RT)

索引 8-9: 選擇/開始鍵 (Select/Start)

索引 10-11: 搖桿下壓鍵 (L3/R3)

索引 12-15: 十字鍵 (D-Pad)

索引 16: 首頁鍵 (Home)

索引 17: 分享/觸控鍵 (Share/Touch)