UnityのInput ManagerからInput Systemへ操作を壊さずに移行する方法
要点まとめ
Unity 6のプロジェクトを旧Input ManagerからInput Systemへ、操作やUI、既存のInput呼び出しを壊さずに移行します。
Input Systemをインストールして再生ボタンを押すと、Unityがエラーを吐きます。UnityEngine.Inputクラスで入力を読み取ろうとしているのに、Active Input HandlingがすでにInput Systemパッケージを指しているというものです。あるいはPlay Modeが始まっても、ポーズメニューがクリックを一切受け付けなくなります。
この記事では、既存のUnity 6プロジェクトをInput ManagerからInput Systemへ、操作やUIを壊さずに安全な順序で移行する方法を紹介します。両方のバックエンドをオンにしたまま、Inputの呼び出しを置き換え、EventSystemを修正してから、すべてが正常に動作することを確認してから旧マネージャーをオフにします。手順は2026年11月20日時点の公式Input Systemドキュメントに従っています。Package Managerから最新のInput Systemパッケージをインストールしてください。この記事のパッケージバージョンを固定しないでください。新しいリリースが続くためです。
Unity 6で移行する理由
Unityのマニュアルは、現在、組み込みのInput Managerをレガシー機能として扱っています。非推奨であり、新規プロジェクトには推奨されず、Unityは将来のエディタバージョンで削除すると述べています。既存のプロジェクトが実行できるように旧マネージャーは引き続き利用可能です。将来のアップグレードで旧バックエンドが削除されるのを待つよりも、計画的な切り替えの方が良いでしょう。
移行中は両方のバックエンドをオンにする
プロジェクトにInput Systemが含まれていない場合は、Window > Package Managerを開き、Unity Registryに切り替えて、Input Systemパッケージをインストールします。Unity 6.1以降、一部のプロジェクトテンプレートはすでに追加されています。空のプロジェクトには含まれていないことが多いです。
インストール中、UnityはInput Systemバックエンドを有効にしてInput Managerバックエンドを無効にするかどうかを尋ねます。Yesを選択すると、エディタは新しいシステムのみがアクティブな状態で再起動します。残っているInput.GetAxisやInput.GetButtonの呼び出しはすべて失敗し、古い入力モジュールを使用しているuGUIメニューも一緒に失敗します。
代わりに自分でバックエンドを設定します。Edit > Project Settings > Playerに移動し、Other Settingsを開き、Active Input HandlingをBothに設定します。エディタが再起動します。このモードでは、UnityはENABLE_LEGACY_INPUT_MANAGERとENABLE_INPUT_SYSTEMの両方を定義するため、古いコードと新しいコードを並行して実行できます。
#if ENABLE_INPUT_SYSTEM
// New Input System backends are enabled.
#endif
#if ENABLE_LEGACY_INPUT_MANAGER
// Old Input Manager backends are enabled.
#endif
Bothはブリッジとして扱います。自分のスクリプト、EventSystem、サードパーティアセットがすべて移行するまでオンにしておきます。Play Modeとビルドが例外なく、UIが動作する状態で実行できるようになってから、**Input System Package (New)**に切り替えます。
GetAxisとGetButtonをActionsに置き換える
推奨されるワークフローは、生のデバイスボタンではなく、名前付きアクションを読み取ることです。複数のアクションアセットが必要でない限り、単一のアセットをプロジェクト全体のアクションとして割り当てます。
Edit > Project Settings > Input System Packageを開き、何も設定されていない場合はデフォルトのプロジェクト全体のアクションを作成または割り当てます。デフォルトにはPlayerマップとUIマップが含まれ、Move(Vector2値)やJumpなどのアクションがキーボード、マウス、gamepad、タッチ、XR用にすでにバインドされています。InputSystem.actionsを通じてアクセスできます。これらはデフォルトで有効になっており、起動時、およびエディタではPlay Modeに入るたびにプリロードされます。
各アクションを一度見つけてから、毎フレーム読み取ります。Input.GetAxis("Horizontal")のように毎回名前でアクションを検索することは、新しいAPIでは遅いパスです。
using UnityEngine;
using UnityEngine.InputSystem;
public class PlayerMovement : MonoBehaviour
{
InputAction moveAction;
InputAction jumpAction;
void Start()
{
moveAction = InputSystem.actions.FindAction("Move");
jumpAction = InputSystem.actions.FindAction("Jump");
}
void Update()
{
Vector2 move = moveAction.ReadValue<Vector2>();
if (jumpAction.WasPressedThisFrame())
{
// jump
}
}
}
UnityEngine.InputSystem名前空間の名前は、旧呼び出しに次のようにマッピングされます。
Input.GetAxis("Horizontal")とInput.GetAxis("Vertical")はmoveAction.ReadValue<Vector2>()になりますInput.GetButton("Jump")はjumpAction.IsPressed()になりますInput.GetButtonDownはWasPressedThisFrame()になりますInput.GetButtonUpはWasReleasedThisFrame()になりますInput.GetKey(KeyCode.Space)はKeyboard.current.spaceKey.isPressedになりますInput.GetMouseButton(0)はMouse.current.leftButton.isPressedになりますInput.mousePositionはMouse.current.position.ReadValue()になります
操作が同じように感じられるようにするには、2つの詳細が重要です。デフォルトのMoveアクションは2D値なので、旧HorizontalとVertical軸は2つのfloatではなく1つのベクトルになります。そしてReadValueは旧GravityとSensitivityのスムージングを適用しないため、キーまたはボタンは即座に最大値に達します。移動がそのランプに依存していた場合は、意図的に再作成する必要があります。Input.GetAxisRawに直接相当するものはありません。ReadUnprocessedValue()は、アクションにプロセッサがアタッチされている場合にのみReadValueと異なります。
Keyboard.currentなどの直接デバイス読み取りは手早い代替手段であり、長期的なワークフローではありません。また、そのハードウェアが欠けているときはcurrentデバイスがnullになる可能性があります。
一部の古いInput Manager機能はUnityのバージョンに依存します。Unity 6.4以降、OnMouseDownなどのMonoBehaviourマウスイベント関数はInput Systemで動作します。Unity 6の以前のリリースでは、新しいバックエンドのみがアクティブになると何も行わない可能性があります。プロジェクトが位置情報、コンパス、デバイスの向きを使用している場合は、旧マネージャーをオフにする前にエディタのInput Systemドキュメントを確認してください。IMGUI(OnGUI)はInput Systemと互換性がないため、その方法で構築されたデバッグメニューはBothのままにする必要がある場合があります。
UIを動作させ続ける
Unity UI(uGUI)を使用する場合、Input SystemをUIにフィードするためには常にEventSystemに入力モジュールが必要です。古いStandaloneInputModuleは依然としてレガシーのInput Managerと通信します。Active Input Handlingが新しいパッケージのみに設定されている場合、このモジュールはUnityEngine.Input例外の頻繁な原因となります。
シーン内のEventSystemを選択します。Input Systemパッケージがインストールされている場合、InspectorはStandaloneInputModuleをInputSystemUIInputModuleに置き換えるボタンを提供します。新しいモジュールには、デフォルトのUIアクションがあらかじめ設定されています。Active Input Handlingがすでに新しいパッケージまたはBothに設定されている場合、Unityはシーンに新しいuGUI要素を配置すると、新しいモジュールも自動的に追加します。
UI Toolkitは異なります。Unity 6を含むUnity 2023.2以降、UI Toolkitは追加のモジュールなしでプロジェクト全体のアクションからUIアクションを読み取ることができます。UI ToolkitとuGUIが同じシーンを共有する場合は、InputSystemUIInputModuleとEventSystemが必要です。
PlayerInputコンポーネントも使用する場合は、PlayerInputとInputSystemUIInputModuleに同じアクションアセットを割り当て、PlayerInputでUI Input Moduleフィールドを設定します。これにより、同じデバイス割り当てがプレイヤーとUIの両方を駆動します。PlayerInputを使用中にスクリプトでアクションを読み取る場合は、InputSystem.actionsではなくPlayerInput.actionsを読み取ります。PlayerInputは各プレイヤーのデバイス用にフィルタリングされたコピーを保持しているためです。
例外と残ったInputの呼び出し
ランタイムエラーは通常、InvalidOperationException: You are trying to read Input using the UnityEngine.Input class, but you have switched active Input handling to Input System package in Player Settings.と表示されます。Active Input Handlingが**Input System Package (New)**に設定されていて、何かがまだUnityEngine.Inputを呼び出している場合に表示されます。
ランダムにスクリプトを変更する前に、スタックトレースを読んでください。多くの場合、移動クラスではなく、StandaloneInputModuleまたはBaseInput.GetButtonDownから始まります。EventSystemを修正した後、自分のコードでInput.GetAxis、Input.GetButton、Input.GetKey、Input.GetMouseButton、Input.mousePositionを検索します。次に、サードパーティアセットとプラグインを確認します。Active Input HandlingをBothに戻すことは有効な一時的な手順です。恒久的な修正は、呼び出し元を移行するか、プラグインを更新することです。
PlayerInputが役立つ場合
PlayerInputコンポーネントはオプションです。Send Messages(OnJump、OnMove(InputValue value))、Invoke Unity Events、またはローカルマルチプレイヤー用のPlayerInputManagerが必要な場合に追加します。すでにUpdateでポーリングしているシングルプレイヤーゲームは、FindActionとReadValueのままで問題ありません。
移行チェックリスト
- Package Managerから最新のInput Systemパッケージをインストールし、Active Input HandlingをBothに設定します。
- デフォルトのプロジェクト全体のアクションを作成または割り当てます。
- 自分の
Input呼び出しを置き換えます。各アクションを一度見つけてから、毎フレーム読み取ります。 - uGUIを使用する場合は、
StandaloneInputModuleをInputSystemUIInputModuleに置き換え、キーボードとgamepadでメニューをクリックします。 - Unityのバージョンに対して、
OnMouseイベント、タッチ、位置情報、コンパス、IMGUIを確認します。 - まだ
UnityEngine.Inputを呼び出しているプラグインを更新するか、修正が存在するまでBothをオンのままにします。 - Play Modeとビルドが例外なく、UIが動作する状態で実行される場合、Active Input Handlingを**Input System Package (New)**に設定します。
最後のスイッチを切り替える前に、移動、メニュー、オンスクリーンボタンを一通りプレイしてください。入力はクライアント側のエンジントピックです。horizOnは、アカウント、クラウドセーブ、リーダーボード、ゲーム内ニュース用のUnity SDKを備えたゲームバックエンドです。Input Systemの移行は、そのSDKの使用方法を変更せず、Unityの入力スタックを置き換えたりラップしたりすることもありません。