unity-input-system

Unity Input System（新）

Unity の Input System パッケージ（com.unity.inputsystem、1.x）を使って入力を読み取ります。アクションベースで、デバイスに依存せず、再バインド可能です。対象は Unity 6.3 LTS です。従来の Input.GetAxis／Input.GetKey Input Manager に代わる最新のシステムです。

使用する場面

• 移動／ジャンプ／射撃の入力を設定するとき、アクションマップとコントロールスキームを含む .inputactions アセットを定義するとき、PlayerInput コンポーネントを接続するとき、Vector2 のスティック／WASD 値を読み取るとき、またはゲームパッド＋キーボード＋タッチを一組のアクションで扱うときに使用します。
• Packages/manifest.json に com.unity.inputsystem が含まれている場合、またはプロジェクトに *.inputactions アセットがある場合に使用します。

使用しない場面： エンジンをまたいだ再バインド可能な操作の設計には、input-systems を使用します（このスキルは Unity 固有の API です）。入力ベクトルを取得した後のキャラクター移動には、unity-physics／unity-csharp-scripting を使用します。

基本的なワークフロー

1. Active Input Handling を確認します（Project Settings → Player）。パッケージが入力を受け取るのは、この設定が Input System Package (New) または Both の場合のみです。古い Input.GetAxis コードが残っている場合は、Both が必要です。
2. .inputactions アセットを作成します。 アクションマップ（例：Gameplay）を追加し、アクション（Move = Value/Vector2、Jump = Button、Fire = Button）を追加して、コントロールと複合バインディング（WASD = 2D Vector composite）にバインドします。
3. 入力の読み取り方法を選択します。
   • PlayerInput コンポーネント（デザイナー向け）— プレイヤーに追加してアセットを指定し、Behavior（Send Messages / Broadcast / Invoke Unity Events / Invoke C# Events）を選択します。1 人またはローカル協力プレイのプレイヤーに最適です。
   • コードから直接読み取る（InputActionReference／InputActionAsset）— 最も細かく制御できます。アクションを Enable() して読み取ります。システムやツールに最適です。
4. 読み取るアクション／マップを有効にします。 PlayerInput はデフォルトのマップを自動的に有効にします。自分で参照するアクションは .Enable() する必要があります（終了時には無効にします）。
5. すべてのハンドラーで条件分岐する代わりに、状況に応じてアクションマップを切り替えます（gameplay ↔ UI/menu）。
6. Input Debugger（Window → Analysis → Input Debugger）でデバイスとアクションの発火を確認します。

パターン

1. PlayerInput の「Send Messages」（同じ GameObject 上のハンドラー）

using UnityEngine;
using UnityEngine.InputSystem;

// PlayerInput (Behavior = Send Messages) calls On<ActionName>(InputValue) by name.
public class PlayerInputReceiver : MonoBehaviour
{
    private Vector2 _move;

    private void OnMove(InputValue value) => _move = value.Get<Vector2>();   // Move action
    private void OnJump(InputValue value) { if (value.isPressed) Jump(); }   // Button action

    private void Update() { /* drive movement from _move */ }
    private void Jump() { }
}

2. コードからアクションを直接読み取る（値のポーリング）

using UnityEngine;
using UnityEngine.InputSystem;

public class DirectMover : MonoBehaviour
{
    [SerializeField] private InputActionReference moveAction;  // assign the Move action

    private void OnEnable()  => moveAction.action.Enable();    // REQUIRED or it reads zero
    private void OnDisable() => moveAction.action.Disable();

    private void Update()
    {
        Vector2 move = moveAction.action.ReadValue<Vector2>(); // continuous value
        transform.Translate(new Vector3(move.x, 0, move.y) * (5f * Time.deltaTime));
    }
}

3. イベントコールバック＋アクションマップの切り替え（gameplay ↔ UI）

[SerializeField] private InputActionAsset actions;

private void OnEnable()
{
    actions.FindAction("Gameplay/Fire").performed += OnFire;  // edge event: fires once
    actions.FindActionMap("Gameplay").Enable();
}
private void OnDisable() => actions.FindAction("Gameplay/Fire").performed -= OnFire;

private void OnFire(InputAction.CallbackContext ctx) => Shoot();  // ctx.ReadValue<T>() if needed

private void OpenPauseMenu()                       // change context, don't sprinkle if-checks
{
    actions.FindActionMap("Gameplay").Disable();
    actions.FindActionMap("UI").Enable();
}
private void Shoot() { }

注意点

• 入力がまったくない → Active Input Handling がまだ Input Manager (Old) になっているか、アクション／マップを Enable() し忘れています。PlayerInput は自動的に有効にしますが、生の InputActions は有効にしません。
• 古い入力バックエンドに関する InvalidOperationException が発生する → Active Input Handling が New のときに、いずれかのスクリプトがまだ Input.GetAxis／Input.GetKey を呼び出しています。コードを移行するか、Both に設定します。
• ReadValue でボタンが 0 として読み取られる → ボタンの押下はエッジイベントです。トリガーに対してフレームごとに ReadValue を使うのではなく、performed コールバック（または WasPressedThisFrame()）を使用します。
• Send Messages のハンドラーがまったく呼び出されない → 受信側のスクリプトは PlayerInput と同じ GameObject 上に置く必要があります。Broadcast Messages なら子オブジェクトにも届きます。
• サブスクリプションが解除されずに残る → OnDisable で購読を解除します（-=）。購読を解除せずに OnEnable で再購読すると、ハンドラーが重複します。
• タッチ／ゲームパッドが検出されない → 対応するコントロールスキームを有効にして、Input Debugger でデバイスを確認します。Vector2 複合バインディングには、4 つすべてのバインディング設定が必要です。

参考資料

• インタラクティブな操作の再バインド（PerformInteractiveRebinding）、バインディングの JSON 形式での保存／読み込み、PlayerInputManager を使ったローカルマルチプレイヤーについては、references/rebinding.md を参照してください。
• 主なドキュメント：Unity Manual「Input System」 （https://docs.unity3d.com/Manual/com.unity.inputsystem.html）。

関連スキル

• input-systems — エンジンに依存しない入力アーキテクチャ（再割り当て、バッファリング、複数デバイス）。
• unity-csharp-scripting — これらのハンドラーが配置される MonoBehaviour。
• unity-physics — 入力ベクトルを Rigidbody に適用する方法。