INDIE INDEX

レベル:入門

ゲームパッドが反応しない|UnityとGodotの設定と確認手順

公開 2026-11-03更新 2026-11-03

Unity の Input System では、Gamepad は2本のスティック・十字キー・4つの顔のボタンを持つ機器として狭く定義され、汎用の HID のゲームパッドは Gamepad ではなく汎用のジョイスティックとして作られます。Godot は何百ものコントローラーのモデルに標準で対応し、4.5 から Windows・macOS・Linux では SDL 3 を使います。

このページの目次
  1. ゲームパッドが反応しないときに確かめることを表で見る
  2. 反応しなくなる場所を図で見る
  3. Unity で確かめる手順
  4. Godot で確かめる手順
  5. 失敗を避ける注意
  6. 公式のページの版
  7. 次に読む
  8. 情報源

ゲームパッドが反応しないときに確かめることを表で見る

確かめることとして、入力の仕組み・機器の種類の認識・ボタンの名前・デッドゾーン・Windows での扱い・プラットフォームごとの違いを、Unity と Godot で並べます。

確かめることごとの、Unity と Godot の設定や呼び出し

確かめることUnity(Input System の 1.14 の版)Godot(stable)
入力の仕組み既定では、従来の Input Manager(`UnityEngine.Input`)が有効で、新しい Input System は無効です。パッケージを入れると、新しいバックエンドを有効にするかを聞かれ、Yes を押すと、新しいバックエンドが有効に、古いバックエンドが無効になって、Editor が再起動します。設定は「Edit > Project Settings > Player > Other Settings > Active Input Handling」にあり、この設定を変えたら、Editor を再起動しないと効きません。新旧の両方を有効にするときは、Both にしますGodot の入力アクションの仕組みでは、キーボードとコントローラーの入力を、別々のコードにせずに扱えます。Project Settings で作った入力アクションが、指定したキーとコントローラーの入力を指します
機器の種類の認識Gamepad は、2本のスティック・十字キー・4つの顔のボタンを持つ機器として狭く定義されます。汎用の HID のゲームパッドは Gamepad ではなく、汎用のジョイスティックとして作られます。Input System が明示的に対応している HID のゲームパッド(PS4 のコントローラーなど)だけが、Gamepad として出ます何百ものコントローラーのモデルに標準で対応します。コントローラーは Windows・macOS・Linux・Android・iOS・Web で使えます。4.5 から、Windows・macOS・Linux では SDL 3 を使います。機器がつながるか切れると、`joy_connection_changed(device, connected)` のシグナルが出ます
ボタンの名前4つの顔のボタンは、下が `buttonSouth`、上が `buttonNorth`、左が `buttonWest`、右が `buttonEast` です。`buttonSouth` は、Xbox のコントローラーでは「A」、PlayStation のコントローラーでは「Cross」と書かれたボタンです。Xbox 形と PS4 形の別名があり、`Gamepad.current[GamepadButton.Y]`・`Gamepad.current["Y"]`・`Gamepad.current[GamepadButton.Triangle]`・`Gamepad.current["Triangle"]` は、どれも同じ north のボタンを返します`Input.get_joy_name(device)` は、その device の番号のジョイパッドの名前を返します(例:PS4 Controller)。`Input.is_joy_known(device)` は、システムがその機器を知っている、つまりボタンと軸の番号がすべて設定されているときに true を返します。知らないジョイパッドは、それらの番号の定数に合うとは限りませんが、そこからイベントを得ることはできます
デッドゾーンデッドゾーンは、スティックが中心で止まる位置のわずかなずれによる意図しない入力を防ぎます。Gamepad のレイアウトには、stick deadzone Processor がすでに入っていて、min と max の値は `InputSettings.defaultDeadzoneMin` と `InputSettings.defaultDeadzoneMax` から取られます。Processor の書き方の例は `stickDeadzone(min=0.125,max=0.925)` ですデッドゾーンの仕組みが組み込まれていて、既定値は 0.5 です。Project Settings の Input Map タブで、アクションごとに変えられます。`Input.get_vector()` では、5番目の任意の引数でデッドゾーンを指定できます。指定しないと、vector に使うアクションのデッドゾーンの平均を計算します
Windows での扱いWindows と UWP では、Unity は XInput API で、対応している XInput コントローラーのどの種類にも接続します(Xbox One または Xbox 360 互換のコントローラーすべてを含みます)。Windows(XInput コントローラーのみ)・UWP・Switch では、ゲームパッドの更新をイベントで受け取らず、ポーリングで読みます。ポーリングの頻度の既定は 60 Hz で、`InputSystem.pollingFrequency` で取得・設定できますWindows では、Godot が XInput API を使い、その API は同時に4台までのコントローラーにしか対応しないので、Godot が同時に扱えるのは4台までです。この上限を超えたコントローラーは、Godot に無視されます
プラットフォームごとの違いMac で XInput コントローラーを使うには、現在は、Xbox Controller Driver for macOS を入れる必要があります。ドライバーを使うときのクラス `XboxGamepadMacOS` は、新しい版の macOS では通常は使われず、macOS 11.0 以降の Mac に USB でつないだ Xbox のゲームパッドは `XboxGamepadMacOSNative` として扱われます。このドライバーは USB の接続にだけ対応し、無線のドングルには対応しません。最新世代の Xbox One のコントローラーは Bluetooth に対応し、Bluetooth で接続すると、Mac は追加のドライバーなしで HID として扱います。Switch Pro コントローラーは、デスクトップでは Bluetooth で接続する必要があり、有線の USB では現在は動きません。WebGL(ブラウザで動かす書き出し先)では、PlayStation と Xbox のコントローラーを、一部のブラウザと OS の組み合わせで、基本的な Gamepad か Joystick として扱いますAndroid と Web では、4.5 より前の自前のコントローラー対応のコードが今も使われていて、そのために問題がその2つのプラットフォームにだけ出ることがあります。Web は、ブラウザによって対応の質が大きく変わる傾向があります。Linux では、udev 対応なしでビルドしたエンジンでもコントローラーは動くことがありますが、つながる・切れるの確認に定期的なポーリングを使うので、信頼性は下がります
表1

反応しなくなる場所を図で見る

コントローラーからゲームの動きまでの流れと、各段で反応しなくなる原因を並べます。

コントローラーからゲームの動きまでの流れと、各段の原因

コントローラーからゲームの動きまでの流れと、各段の原因1コントローラーGodot で認識されないときは、まず、コントローラーが他のアプリで認識されるかを確かめます2OS とドライバーWindows の Unity と Godot は XInput API を使います。Godot は Windows で4台までしか扱いません。Mac の Unity は、現在は、XInput コントローラーに Xbox Controller Driverfor macOS が要ります。macOS 11.0 以降の Mac に USB でつないだ Xbox のゲームパッドは`XboxGamepadMacOSNative` として扱われます。Linux の Godot は、udev 対応がないと信頼性が下がります3エンジンの入力Unity は、汎用の HID のゲームパッドを Gamepad ではなくジョイスティックとして作ります。Godot は、Windows・macOS・Linux では SDL 3 を使い、SDL のゲームコントローラーデータベースか Godot のゲームコントローラーデータベースの割り当てが誤っていると、ボタンが正しく割り当たらないことがあります4アクションUnity は、Active Input Handling で新しいInput System が有効かを確かめます。Godot は、Input Map のアクションが、指定したキーとコントローラーの入力を指しているかを確かめます5ゲームの動きスティックの値がデッドゾーンの内側にあると、入力は0として扱われます。Unity は、一般に、アプリが前面にないあいだ、機器が入力を受けません。エディターでは、Run In Background(前面にないあいだも動かし続ける設定)が常に有効として扱われます
図1

Unity で確かめる手順

  1. Window > Package Manager で Input System を選び、Install を押します。新しいバックエンドを有効にするかを聞かれたら、Yes を押すと、Editor が再起動します。あとで、「Edit > Project Settings > Player > Other Settings > Active Input Handling」で設定を確かめます。この設定を変えたら、Editor を再起動します。新旧の両方を有効にするときは、Both にします。

  2. 接続されている機器は、InputSystem.devices で読めます。ゲームパッドとジョイスティックをすべて Console に出す断片は、次のとおりです。

    var devices = InputSystem.devices;
    for (var i = 0; i < devices.Count; ++i)
    {
        var device = devices[i];
        if (device is Joystick || device is Gamepad)
        {
            Debug.Log("Found " + device);
        }
    }
    

    機器が追加された・外れたときに知らせを受けるには、InputSystem.onDeviceChange を使います。

    InputSystem.onDeviceChange += (device, change) =>
    {
        if (change == InputDeviceChange.Added || change == InputDeviceChange.Removed)
        {
            Debug.Log($"Device '{device}' was {change}");
        }
    };
    
  3. ゲームパッドをつないだのに、一覧に Gamepad ではなく Joystick として出たときは、汎用の HID のゲームパッドとして扱われています。機器が作られたときの説明は InputDevice.description で取れ、interfaceName(HID・RawInput・XInput など)や product などの欄があります。Joystick は、Input System が HID descriptor の情報から Control を割り出そうとしますが、いつも正確とは限りません。こうした機器は、プレイヤーが Control を手動で割り当て直せるようにしたときに、いちばんよく動くことが多くあります。特定の機器だけの割り当てを自分で用意することもできます。割り当て直しの機能は、キーコンフィグのページにあります。

  4. Gamepad のボタンは、「Gamepad.current[GamepadButton.LeftShoulder]」のように指せます。ボタンは浮動小数点の軸でもあり、たとえば左右のトリガーは、ボタンとしても、浮動小数点の軸としても働きます。leftStick と rightStick は、デッドゾーンが付いた正規化された2Dのベクトルで、X は左から右へ、Y は下から上へ、それぞれ -1 から 1 の値です。ボタンを押す前と押したあとの値、スティックを倒す前と倒したあとの値を Debug.Log で Console に出して見比べます。

Godot で確かめる手順

  1. Godot で認識されないときは、先に、コントローラーが他のアプリで認識されるかを確かめます。

  2. Project Settings で入力アクションを作ります。アクションは、指定したキーとコントローラーの入力を指します。アクションの入力は、イベントで受け取る方法と、Input シングルトンで状態を調べる方法があります。

    func _input(event):
        if event.is_action_pressed("jump"):
            jump()
    
    func _physics_process(delta):
        if Input.is_action_pressed("move_right"):
            # Move as long as the key/button is pressed.
            position.x += speed * delta
    

    スティックのように2つの軸を1つの入力として読むときは、Input.get_vector() を使います。

    var velocity = Input.get_vector("move_left", "move_right", "move_forward", "move_back")
    

    velocity は、Vector2(-1.0, -1.0) から Vector2(1.0, 1.0) のあいだの Vector2 で、デッドゾーンは円形になります。トリガーのように、1つの方向だけを強さで読むときは、Input.get_action_strength() を使い、0.0 から 1.0 の値を返します。

  3. Input の joy_connection_changed(device, connected) のシグナルにつなぐと、ジョイパッドがつながったか切れたかを知れます。つながったときに、Input.get_joy_name(device) で名前を、Input.is_joy_known(device) でシステムが知っている機器かを出力に出して見ます。いまつながっているジョイパッドの device の番号は、Input.get_connected_joypads() が配列で返します。この順番は、プロジェクトかエディターを再起動したあとも同じとは限りません。Godot は、ジョイパッドがつながった順番を保存しないからです。

  4. 割り当てが違うボタンがあるときは、Input.get_joy_info(device)["raw_name"] の値を見ます。汎用のコントローラー(raw_name に「USB Gamepad」の字が入ることが多い)の注意は、下の注意にあります。

失敗を避ける注意

  • Unity は、汎用の HID のゲームパッドを Gamepad にしません。HID の段階では、ボタンと軸の正しい対応の情報がなく、Input System が正しい対応を保証できないためです。
  • Unity の Active Input Handling を変えたら、Editor の再起動が要ります。
  • Unity では、一般に、入力はアプリのフォーカスに結びついています。アプリが前面にないあいだは、機器が入力を受けず、どの Action も入力を受けません。アプリがフォーカスに戻ると、機器に現在の状態を送る sync request が送られます。アプリが前面にないあいだも動かし続ける設定(Run In Background)にしたときの入力の扱いは、機器ごとの対応と、Input Settings の設定で変わります。エディターでは、Run In Background は常に有効として扱われます。
  • Unity で機器が外れると、その機器は devices の一覧から外れます。外れた機器の Control から値を読もうとすると、例外になります。
  • Unity は、PlayStation のコントローラーを、DualShock 4 USB Wireless Adaptor でデスクトップにつなぐ接続に対応しません。USB か Bluetooth で接続します。
  • Godot は Windows で、4台を超えた分のコントローラーを無視します。
  • Godot でボタンの割り当てが違うのは、Godot が使う SDL のゲームコントローラーデータベースか、Godot のゲームコントローラーデータベースの、誤った割り当てが原因のことがあります。このときは、そのコントローラーの割り当てを自分で作ります。割り当てを作る方法はいくつかあり、Steam を Big Picture モードで起動してコントローラーを設定し、Steam のインストール先の config/config.vdf にある SDL_GamepadBind の項目を見る方法や、SDL の testcontroller を使う方法があります。使える割り当てができたら、Godot を起動する前に、環境変数 SDL_GAMECONTROLLERCONFIG に入れて試せます。Windows のコマンドプロンプトでは、「set SDL_GAMECONTROLLERCONFIG=your:mapping:here」のあとに、godot.exe を起動します。
  • Godot の汎用のコントローラー(raw_name に「USB Gamepad」の字が入ることが多い)は、同じチップセットを使っていても、ボタンの配置が違うことがあります。エンジンには同じチップセットのコントローラーを区別する方法がないので、1つのコントローラーの割り当てを作ると、ほかのコントローラーの割り当てとぶつかる可能性が高いです。
  • Godot では、デッドゾーンがないと、スティックを触っていないのに、軸の強さが 0.0 にならず、たとえば 0.062 のような低い値に留まります。これは drifting と呼ばれ、古いコントローラーや故障したコントローラーでは目立つことがあります。
  • Godot のコントローラーのボタンは、たとえば D-pad の方向を押し続けても、キーボードのような一定の間隔の繰り返しの入力イベント(echo イベント)を出しません。OS が、コントローラーの入力に echo イベントを送らないためです。
  • Godot のコントローラーの入力は、既定では、フォーカスのないウィンドウも含む、OS のすべてのウィンドウに見えます。プロジェクトにフォーカスがないときにコントローラーの入力を無視するには、「ProjectSettings.input_devices/joypads/ignore_joypad_on_unfocused_application」か「Input.ignore_joypad_on_unfocused_application」を true にします。
  • Godot の Android と Web は、4.5 より前の自前のコードを使うため、Android ではデスクトップより信頼性が低いことがあります。Web では、コントローラーが動かないときに、プレイヤーに別のブラウザを使うよう伝える必要が出ることがあります。Web の書き出しの制限は、Web に書き出すときの制限にあります。

公式のページの版

Unity の項目は Input System の 1.14 の版のもの(ページの見出しは 1.14.2)です。Godot の項目は stable の版のもの(ページの見出しは 4.7)です。

次に読む

コントローラーの既定の設定の項目は、Steam 向けの実装の項目にあります。

情報源

このページに出た言葉

このページの内容の誤りは、問い合わせの窓口で受け付けています。