手把測試

手把測試透過 W3C Gamepad API 讀取控制器回傳給瀏覽器的訊號，並即時顯示：每一次按鍵、搖桿位置、扳機深度、十字鍵方向和震動馬達。它是開打前確認手把是否正常、排查面鍵連點、發現老手把搖桿漂移、驗證雙震動馬達是否都作動的最快方式。頁面會在 Xbox 風格的版面上高亮顯示每個輸入，呈現搖桿與扳機的原始數值，並保留簡短的事件紀錄。由於 Gamepad API 只在你按下手把上的按鍵後才會暴露控制器，頁面會先提示你按下任一按鍵——這是瀏覽器的安全規則，不是手把故障。所有操作都在瀏覽器本地完成，輸入資料不會離開你的裝置。

瀏覽器透過 W3C Gamepad API 暴露手把。一個控制器由從 navigator.getGamepads() 取得的 Gamepad 物件表示，該函式最多回傳四個插槽。每個 gamepad 帶有一個 id 字串（廠商與產品）、一個 mapping 欄位（Xbox 版面裝置為 'standard'，否則為空）、一個 buttons 陣列和一個 axes 陣列。 在標準映射下，buttons 有 17 項：四個面鍵（A/B/X/Y）、兩個肩鍵（LB/RB）、兩個類比扳機（LT/RT）、Select/Start、兩個搖桿按壓（L3/R3）、四個十字鍵方向和 Home/Guide 鍵。每個按鈕暴露 .pressed（布林）和 .value（0 到 1——扳機是類比量，數位按鍵為 0 或 1）。axes 陣列保存四個 -1 到 1 的值：左搖桿 X/Y，接著右搖桿 X/Y。 這個 API 採用輪詢而非事件驅動，因此頁面執行 requestAnimationFrame 迴圈，每幀讀取一份新快照。為避免手把靜止時無意義的重複渲染，只在 gamepad.timestamp 變化時才更新狀態——這個時間戳會在每份新輸入報告上遞增。連線與斷線透過 window 的 gamepadconnected 和 gamepaddisconnected 事件到達。 基於安全考量，gamepad 物件在使用者按下手把上的按鍵之前保持 null，因此頁面無法靜默讀取剛插上的手把。震動是選用功能：如果 gamepad.vibrationActuator 存在，呼叫 playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) 即可驅動兩顆馬達；Safari 和部分 Chromium 版本未實作此功能，這也是頁面做特性偵測、並在不支援時停用按鈕的原因。

• navigator.getGamepads() 最多回傳四個插槽；只有在按下手把按鍵後對應插槽才非 null。
• 標準映射：buttons[0-3] 面鍵、[4-5] 肩鍵、[6-7] 類比扳機、[8-9] Select/Start、[10-11] L3/R3、[12-15] 十字鍵、[16] Home。
• axes[0-1] 為左搖桿（X、Y），axes[2-3] 為右搖桿，數值範圍均為 -1 到 1。
• 輪詢模型：requestAnimationFrame 迴圈讀取快照；以 gamepad.timestamp 作為閘門，靜止幀不做任何更新。
• 震動透過 gamepad.vibrationActuator.playEffect('dual-rumble', ...) 驅動——需特性偵測，並非所有瀏覽器都支援。
• gamepadconnected / gamepaddisconnected 事件表示連線與斷線；手把的 .index 識別其插槽。