ゲームパッド

ゲームパッドトリガー（gamepad trigger）を使うと、標準的なゲームパッド入力をゲームの機能に割り当てられます。ゲームパッド入力では、次の入力バインディング（input binding）を利用できます。

• 左右のスティック（方向とクリック）
• 左右のデジタルパッド。右側のパッドは通常、Xbox コントローラーの「A」「B」「X」「Y」ボタン、および Playstation コントローラーの「四角」「丸」「三角」「バツ」ボタンに対応します。
• 左右のトリガー
• 左右のショルダーボタン
• Start、Back、Guide ボタン

デジタルボタン

デジタルボタンは、pressed、released、repeated イベントを生成します。次の例は、デジタルボタンの入力（押された、または離された）を検出する方法を示しています。

function on_input(self, action_id, action)
    if action_id == hash("gamepad_lpad_left") then
        if action.pressed then
            -- start moving left
        elseif action.released then
            -- stop moving left
        end
    end
end

アナログスティック

アナログスティックは、ゲームパッド設定ファイル（後述）で定義されたデッドゾーンの外側へ動かすと、入力イベントを連続して生成します。次の例は、アナログスティックの入力を検出する方法を示しています。

function on_input(self, action_id, action)
    if action_id == hash("gamepad_lstick_down") then
        -- left stick was moved down
        print(action.value) -- a value between 0.0 an -1.0
    end
end

アナログスティックは、上下左右のいずれかの方向へ一定のしきい値を超えて動かすと、pressed イベントと released イベントも生成します。これにより、アナログスティックをデジタル方向入力としても簡単に使えます。

function on_input(self, action_id, action)
    if action_id == hash("gamepad_lstick_down") and action.pressed then
        -- left stick was moved to its extreme down position
    end
end

複数のゲームパッド

Defold は、ホストのオペレーティングシステムを通じて複数のゲームパッドをサポートします。アクションでは、action テーブルの gamepad フィールドに、入力元のゲームパッド番号が設定されます。

function on_input(self, action_id, action)
    if action_id == hash("gamepad_start") then
        if action.gamepad == 0 then
          -- gamepad 0 wants to join the game
        end
    end
end

接続と切断

ゲームパッドの入力バインディングには、Connected と Disconnected という2つの個別のバインディングもあり、ゲームパッドの接続（最初から接続されているものも含む）と切断を検出できます。

function on_input(self, action_id, action)
    if action_id == hash("gamepad_connected") then
        if action.gamepad == 0 then
          -- gamepad 0 was connected
        end
    elseif action_id == hash("gamepad_disconnected") then
        if action.gamepad == 0 then
          -- gamepad 0 was disconnected
        end
    end
end

ゲームパッドの生入力

ゲームパッドの入力バインディングには、Raw という個別のバインディングもあります。これにより、接続された任意のゲームパッドから、フィルターを適用していない（デッドゾーンを適用していない）ボタン、軸、ハット（hat）の入力を取得できます。

function on_input(self, action_id, action)
    if action_id == hash("raw") then
        pprint(action.gamepad_buttons)
        pprint(action.gamepad_axis)
        pprint(action.gamepad_hats)
    end
end

ゲームパッド設定ファイル

ゲームパッド入力の設定では、ゲームパッドの機種ごとに個別のマッピングファイルを使います。特定のゲームパッド機種用のマッピングは、gamepads ファイルで設定します。Defold には、一般的なゲームパッドの設定を収録した組み込みの gamepads ファイルが付属しています。

新しいゲームパッド設定ファイルを作成する必要がある場合に役立つ、簡単なツールを用意しています。

クリックして gdc.zip をダウンロード。

Windows、Linux、macOS 用のバイナリが含まれています。コマンドラインから実行します。

./gdc

このツールは、接続されているコントローラーのさまざまなボタンを押すように指示します。その後、コントローラーに適したマッピングを含む新しい gamepads ファイルを出力します。新しいファイルを保存するか、既存の gamepads ファイルに統合してから、game.project の設定を更新します。

識別されないゲームパッド

ゲームパッドを接続したときに、そのゲームパッド用のマッピングが存在しない場合、そのゲームパッドは connected、disconnected、raw アクションのみを生成します。この場合は、ゲームパッドの生データをゲーム内のアクションへ手動でマッピングする必要があります。

ゲームパッドの入力アクションが未知のゲームパッドからのものかどうかは、action の gamepad_unknown 値を読み取ることで確認できます。

function on_input(self, action_id, action)
    if action_id == hash("connected") then
        if action.gamepad_unknown then
            print("The connected gamepad is unidentified and will only generate raw input")
        else
            print("The connected gamepad is known and will generate input actions for buttons and sticks")
        end
    end
end

HTML5 のゲームパッド

ゲームパッドは HTML5 ビルドでサポートされ、ほかのプラットフォームと同じ入力イベントを生成します。ゲームパッドのサポートは、ほとんどのブラウザーがサポートする Gamepad API に基づいています（対応状況の表を参照）。ブラウザーが Gamepad API をサポートしていない場合、Defold はプロジェクト内のすべてのゲームパッドトリガーを通知せずに無視します。ブラウザーが Gamepad API をサポートしているかどうかは、navigator オブジェクトに getGamepads 関数が存在するかを調べることで確認できます。

local function supports_gamepads()
    return not html5 or (html5.run('typeof navigator.getGamepads === "function"') == "true")
end

if supports_gamepads() then
    print("Platform supports gamepads")
end

ゲームが iframe 内で実行される場合は、その iframe に gamepad 権限が追加されていることも確認する必要があります。

<iframe allow="gamepad"></iframe>

標準ゲームパッド

接続されたゲームパッドがブラウザーによって標準ゲームパッドとして識別された場合、ゲームパッド設定ファイルの Standard Gamepad のマッピングを使います（Standard Gamepad のマッピングは、/builtins 内の default.gamepads ファイルに含まれています）。標準ゲームパッドは、16個のボタンと2本のアナログスティックを備え、PlayStation または Xbox コントローラーに似たボタン配置を持つものと定義されています（詳しくは、W3C の定義とボタン配置をご覧ください）。接続されたゲームパッドが標準ゲームパッドとして識別されない場合、Defold はゲームパッド設定ファイルから、そのゲームパッドの機種に一致するマッピングを探します。

Windows のゲームパッド

Windows では、現在 XBox 360 コントローラーのみがサポートされています。360 コントローラーを Windows マシンに接続するには、正しく設定されていることを確認してください。

Android のゲームパッド

ゲームパッドは Android ビルドでサポートされ、ほかのプラットフォームと同じ入力イベントを生成します。ゲームパッドのサポートは、キーイベントとモーションイベントを扱う Android の入力システムに基づいています。Android の入力イベントは、前述したものと同じ gamepad ファイルを使って、Defold のゲームパッドイベントに変換されます。

Android でゲームパッドのバインディングを追加するときは、次の対応表を使って Android の入力イベントを gamepad ファイルの値に変換できます。

（Android の KeyEvent の定義）

（Android の MotionEvent の定義）

この対応表を Google Play Store のゲームパッドテストアプリと組み合わせて使い、ゲームパッドの各ボタンがどのキーイベントにマッピングされているかを調べます。