ゲームパッドテスト

ゲームパッドテストは、W3C Gamepad API を通じてゲームパッドからブラウザに送られる信号を読み取り、リアルタイムに表示します: ボタン押下、アナログスティックの位置、トリガーの押し込み量、十字キーの方向、振動モーターのすべてを可視化します。プレイ前にゲームパッドが正常か確認したい、反応が悪いボタンを診断したい、古いパッドのスティックドリフトを発見したい、両方の振動モーターが動くか検証したい、といった用途に最短で対応できます。ページは Xbox 風レイアウトで各入力をハイライトし、スティックとトリガーの生の数値を表示し、短いイベントログを保持します。Gamepad API はユーザーがゲームパッドのボタンを押した後にのみゲームパッドを公開するため、ページは最初に任意のボタンを押すよう促します - これはブラウザのセキュリティルールであり、パッドの故障ではありません。すべての処理はブラウザ内で完結し、入力データがデバイスから外に出ることはありません。

ブラウザは W3C Gamepad API を通じてゲームパッドを公開します。ゲームパッドは navigator.getGamepads() から取得する Gamepad オブジェクトで表され、この関数は最大 4 つのスロットを返します。各ゲームパッドは id 文字列（ベンダーと製品情報）、mapping フィールド（Xbox レイアウトのデバイスでは 'standard'、それ以外は空）、buttons 配列、axes 配列を持ちます。 標準マッピングでは、buttons は 17 要素です: 4 つのボタン（A/B/X/Y）、2 つのバンパー（LB/RB）、2 つのアナログトリガー（LT/RT）、Select/Start、2 つのスティック押し込み（L3/R3）、4 つの十字キー方向、Home/Guide ボタン。各ボタンは .pressed（真偽値）と .value（0 から 1、トリガーはアナログ、デジタルボタンは 0 または 1）を持ちます。axes 配列は -1 から 1 の範囲の 4 つの値を持ちます: 左スティック X/Y、続いて右スティック X/Y。 この API はイベント駆動ではなくポーリング方式であるため、ページは requestAnimationFrame ループを回し、毎フレーム新しいスナップショットを読み取ります。ゲームパッドが静止中の無駄な再レンダリングを避けるため、gamepad.timestamp が変化した時だけ状態を更新します - このタイムスタンプは新しい入力レポートが届くたびに進みます。接続と切断は window の gamepadconnected と gamepaddisconnected イベントとして届きます。 セキュリティ上、ゲームパッドオブジェクトはユーザーがそのパッドのボタンを押すまで null のままであり、ページは新しく挿したパッドを勝手に読み取れません。振動はオプション機能です: gamepad.vibrationActuator が存在する場合、playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) を呼ぶことで 2 つのモーターを駆動できます。Safari と一部の Chromium ビルドはこれを実装していないため、ページは機能検出を行い、対応していない場合はボタンを無効化します。

• navigator.getGamepads() は最大 4 つのスロットを返します。パッドが非 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 がスロットを識別します。