DOM

インターフェイス

GamepadButton インターフェイス

  編集:2022.04.06 by T.A.

MS

このインタフェースは、ゲームパッドやその他のコントローラーの各ボタンを定義します。このインタフェースによって、コントローラー上で使用できるボタンの状態を確認することができます。

GamepadButton オブジェクトは、Gamepad インタフェースの buttons プロパティから取得できます。

注釈: これは Firefox Gecko 28 以降の場合の説明であり、Chrome と以前の Firefox のバージョンでは、浮動小数点数の配列が返されます。

プロパティ
GamepadButton.value 読取専用
多くのモダンなゲームパッドにあるトリガーなどのアナログボタンの現在の状態を示す浮動小数点数です。この値は 0.0 から 1.0 までの値に正規化されており、0.0 はボタンが押されていない状態で、1.0 はボタンが完全に押されている状態を示します。
GamepadButton.pressed 読取専用
ボタンが押されているかどうかを示す boolean 型の値です。ボタンが押されている場合は true、押されていない場合は false になります。
次のコードは、Gamepad API ボタンのデモです。Chromeでは、Navigator.getGamepadsにはwebkitプレフィックスが必要であり、各ボタンの値は浮動小数点数の配列として格納されます。Firefoxでは、Navigator.getGamepads にはプレフィックスは不要で、各ボタンの値は GamepadButton オブジェクトの配列に格納されます。使用するプロパティはこのオブジェクトの GamepadButton.value (en-US)または GamepadButton.pressed (en-US)プロパティのどちらかであり、どちらを使用すればいいかはボタンの種類に依存します。この例ではどちらにも対応しています。
function gameLoop() {
  if(navigator.webkitGetGamepads) {
    var gp = navigator.webkitGetGamepads()[0];

    if(gp.buttons[0] == 1) {
      b--;
    } else if(gp.buttons[1] == 1) {
      a++;
    } else if(gp.buttons[2] == 1) {
      b++;
    } else if(gp.buttons[3] == 1) {
      a--;
    }
  } else {
    var gp = navigator.getGamepads()[0];

    if(gp.buttons[0].value > 0 || gp.buttons[0].pressed == true) {
      b--;
    } else if(gp.buttons[1].value > 0 || gp.buttons[1].pressed == true) {
      a++;
    } else if(gp.buttons[2].value > 0 || gp.buttons[2].pressed == true) {
      b++;
    } else if(gp.buttons[3].value > 0 || gp.buttons[3].pressed == true) {
      a--;
    }
  }

  ball.style.left = a*2 + "px";
  ball.style.top = b*2 + "px";

  var start = rAF(gameLoop);
};

Obj¶.touched
ボタンがタッチされた状態を指示する。取得子は、次を走らすものとする:

[当のボタンにはタッチを検出する能力はある]ならば:

当のボタンは現在タッチされて[いるならば true いないならば false]を返す

[当のボタンにはアナログ値を報告する能力はある]ならば:

これ°の value が返す値に応じて返す:
0 でないならば true/
0 ならば false

これ°の pressed 属性が返す値を返す

GamepadMappingType 列挙
""
空文字列は、このゲーム・パッド用に利用中にある対応付けは無いことを指示する。
"standard"
ゲーム・パッドを成す各コントロールは、標準ゲーム・パッド・レイアウトに対応付けられている。
"xr-standard"
ゲーム・パッドを成す各コントロールは、"xr-standard" ゲーム・パッド対応付け に対応付けられている。この対応付けは、WebXR ゲーム・パッド・モジュール の利用用に予約されている。getGamepads() が返す Gamepad たちは、"xr-standard" の対応付けを報告してはならない。

テスト
HTML:

ここに表示
スクリプト組み込み:



スクリプト:


スクリプト:



表示内容:
表示内容: