【Unity】Input Systemでスティックを十字キーのように扱う方法

ゲームパッドのスティックを十字キーとして使う方法を探してるの。これでメニューのカーソルを移動させたいの。

Input SystemにはこのようなControl Pathが存在するわ。標準機能だけで対応可能なの。

Input Systemのスティック入力を十字キー（D-pad）のように扱う方法の紹介です。

このような入力は、予め次のような上下左右の入力を表すControl Path として提供されています。

上下左右のControl Pathの例

<Gamepad>/leftStick/up – ゲームパッドの左スティック上入力
<Joystick>/stick/right – ジョイスティックの右入力

参考：Gamepad Support | Input System | 1.3.0

これらのControl Pathは十字キーなどのD-padの入力のような振る舞いをします。

また、Event Systemのナビゲーションにも対応可能なため、スティックで選択項目を移動させたりすることも可能です。

Event SystemやPlayer Inputが自動生成するInput Actionの設定ファイルでは既にこのような設定がなされていますが、一部注意しないといけない点があります。

本記事では、スティック入力を十字キーのように扱う方法を解説するとともに、Event Systemとの連携方法とその注意点についても触れていきます。

動作環境

Unity 2022.1.4f1
Input System 1.3.0

目次非表示

前提条件
実装の流れ
Player Inputが自動生成するデフォルトのInput Action
Event Systemと連携する場合
- 実行結果
さいごに
関連記事
参考サイト

前提条件

Input Systemがインストールされ、有効化されているものとします。ここまでの手順が分からない方は、以下記事をご覧ください。

【Unity】Input Systemの使い方入門

Unity公式の新しい入力システムパッケージInput Systemの入門者向け記事です。本記事では、Input Systemパッケージのインストール方法から、最低限使えるようにするところまでを解説していきます。また…

2021年11月29日

また、本記事ではPlayer Inputを通じて入力を受け取るものとします。Player Inputの使い方が分からない方は以下記事をご覧ください。

【Unity】Player InputでInput Systemの入力を取得する

Input Systemで提供されているPlayer Inputの使い方の解説です。 Player Inputは、Input Systemの入力を仲介するコンポーネントで、Input Actionの入力をスクリプト側に通…

2021年12月2日

実装の流れ

ゲームパッドの左右スティックとジョイスティックの４方向入力は、Control Path名の末尾に/up、/down、/left、/rightという文字列が追加されたControl Pathとして提供されています。

詳細は以下リファレンスのページにまとめられています。

参考：Gamepad Support | Input System | 1.3.0

参考：Joystick support | Input System | 1.3.0

４方向入力を受け取るActionとして定義できれば、参照元からはあたかもD-pad入力がなされているかのような振る舞いが実現できます。

本記事では、ゲームパッドの左スティックが倒された瞬間に押された通知（performedコールバックを発火）させることを例に解説します。

Actionの実装の流れ

2軸入力のActionを定義
2D Vector Composite Bindingを上記Actionに定義
上記Composite BindingにleftStickの4方向入力を定義
上記ActionにPress Interactionを適用

ここまでの手順を踏んでActionの実装ができれば、あとはPlayer Input等を通じて４方向入力を受け取る処理を実装すれば良いです。

２軸のAction定義

Input Actionのアセット側に方向入力のActionを定義していきます。

例ではUIマップの下にNavigateというActionを定義するものとします。

そして、Action TypeにValue、Control TypeにVector 2を指定します。

注意

もしAction TypeにPass Throughが指定されている場合、キーボードとゲームパッド等、複数コントローラーを併用するとEvent Systemとの連携などで誤動作する可能性があるので、基本的にValueを指定しておくのが安全です。

2D Vector Compositeの定義

前述のActionにComposite Bindingを追加します。Actionの右の＋アイコンからAdd Up\Down\Left\Right Compositeを選択してください。

Modeなどの設定は初期値のままで問題ありません。

4方向のControl Pathの追加

そして、追加したComposite Binding配下の各方向に以下のようにControl Pathを設定します。

Binding	追加するControl Path
Up	leftStick/Up
Down	leftStick/Down
Left	leftStick/Left
Right	leftStick/Right

Press Interactionの適用

このままでもD-padのように最低限機能はしますが、スティック入力の値が変化するたびにperformedイベントが発火してしまいます。

キーボード入力は基本的に押された瞬間しかperformedコールバックが発火しませんが、スティック入力の場合は値が変化するたびに連続でperformedコールバックが発火することがあるといった違いがあります。

キーボード側と足並みを揃えてスティックが倒された瞬間のみperformedコールバックを発火させたい場合は、PressというInteractionを適用すれば良いです。

【Unity】Input Actionの３種類のコールバック挙動

Input SystemのActionでは、スティックやボタン入力の変化などによって、次の３種類のコールバックが呼ばれるようになっています。これらのコールバックは、例えば次のように使います。コールバックが呼び出される…

2022年5月28日

該当するActionを選択し、Interactionsの右側の＋アイコンからPressを選択すると適用できます。

初期設定では押された瞬間のみperformedを発火するようになっているので、このままで問題ありません。

ここまでの手順を実施したら、Save AssetボタンをクリックしてInput Actionアセットの内容を保存しておきます。

入力受取の確認（必要ならば）

スティック入力があった時にデバッグログを出力するサンプルスクリプトです。本手順は確認用のため必須ではありません。

InputNavigationTest.cs

using UnityEngine;
using UnityEngine.InputSystem;

public class InputNavigationTest : MonoBehaviour
{
    // PlayerInputから通知されるコールバック
    public void OnNavigate(InputAction.CallbackContext context)
    {
        // performedコールバックだけをチェックする
        if (!context.performed) return;

        // スティックの2軸入力取得
        var inputValue = context.ReadValue<Vector2>();
        
        // 入力値をログ出力
        Debug.Log($"OnNavigate : value = {inputValue}");
    }
}