UE5 の Enhanced Input 入門｜IAとIMCの基本

Unreal Engine 5 (UE5) でキャラクターを動かそうとして、「解説どおりに Project Settings の Axis Mappings を設定したのに、テンプレートでは別の仕組みが使われていて話がかみ合わない」と戸惑った経験はないでしょうか。その正体が Enhanced Input です。この記事では、Enhanced Input が何を解決する仕組みなのか、中核となる Input Action と Input Mapping Context がそれぞれ何を担当しているのかを整理します。

1Enhanced Input とは何か

Enhanced Input は、Unreal Engine 5 で標準的に使われる入力システムです。プラグインとして同梱されており、UE5 のテンプレートから作成したプロジェクトでは最初から有効になっています。旧来の入力システム（Project Settings 内の Action Mappings / Axis Mappings）も残されていますが公式には非推奨で、新規プロジェクトは Enhanced Input が前提です。

従来の入力設定の困りごとは、「キーと処理が一対一で固く結びついてしまう」ことでした。「Fキーでドアを開ける」と設定した後で、乗り物に乗っている間だけ F の意味を変えたい、UI を開いている間は無効にしたい、といった要求が出ると、処理側に分岐を書き足すことになります。Enhanced Input はここにアセットによる仲介層を挟み、キーと処理を疎結合にします。

もうひとつの利点が、入力値の加工を設定側で完結できることです。「スティックの中央付近は無視したい」「符号を反転したい」といった調整を Modifier として宣言的に指定できるため、ブループリント (Blueprint) 側のグラフがすっきりします。

2登場人物は3つだけ

押さえるべき登場人物は次の3つです。この関係さえ頭に入れば、後の設定項目はすべて「どこに属する話か」で整理できます。

3Input Action は「意味」と「値の型」を決める

Input Action はコンテンツブラウザに作るアセットで、中身はシンプルです。もっとも重要な設定が Value Type、この入力がどんな型の値を運ぶかという指定です。ここを間違えると、受け取り側で値が常にゼロになったり、期待した軸に値が入ってこなかったりします。

命名は IA_Jump IA_Move のように接頭辞をそろえるのが一般的です。Input Action 自体にも Modifier と Trigger を持たせられ、その場合は「割り当てられた全キーに共通して効く設定」になります。特定のキーだけに効かせたい設定は Input Mapping Context 側に書きます。

4Input Mapping Context は「割り当て表」

Input Mapping Context も同じくアセットで、こちらは Input Action と物理キーの対応表です。1つの Input Action に複数のキーを割り当てられますし、同じキーを別々のコンテキストで別の Action に割り当てることもできます。

設計上いちばん効いてくるのが、この Mapping Context を実行中に着脱できる点です。徒歩用・車両用・メニュー用のコンテキストを作っておき、状況に応じて追加・削除するだけで入力体系ごと切り替えられます。

追加時には優先度（Priority）を数値で指定します。複数のコンテキストが同じキーを取り合った場合、優先度の高いコンテキストの割り当てが勝ちます。たとえば通常操作を優先度0で常時適用しておき、乗り物に乗ったときだけ優先度1のコンテキストを重ねる、といった運用ができます。

5Modifier：入力値を届く前に加工する

Modifier は、キーが生み出した生の値を Input Action に届ける前に変換する部品です。Input Mapping Context の各キー行、または Input Action 本体に、上から順に並べて適用します。並び順が結果を変える点は覚えておいてください。順序を入れ替えると符号や軸の割り当てが変わり、意図しない挙動になります。

もっとも混乱しやすいのが Swizzle Input Axis Values です。キーが生む値は既定で X 成分に入るため、W と S をそのまま Axis2D の Input Action に割り当てても、前後ではなく左右の成分として届いてしまいます。前後方向のキーには Swizzle を、逆向きのキーには Negate を、と組み合わせるのが定石です。

6Trigger：いつ発火させるかを決める

Trigger は「加工後の値がどうなったらアクションを発火させるか」を決める部品です。Modifier と同じく Input Mapping Context のキー行、または Input Action 本体に設定します。何も設定しない場合は、入力が有効な値を持っている間ずっと発火し続ける挙動になります。つまりキーを押しっぱなしにすると毎フレーム発火するということです。

ここが旧来の入力設定との大きな違いです。「長押しで拾う」といった仕様を、以前はタイマーやカウンタを自作して実現していましたが、Enhanced Input では Trigger を選ぶだけで済みます。

7受け取り側に届く5つのイベント

ブループリントで Input Action のイベントノードを置くと、実行ピンが複数並びます。これが Trigger の状態遷移に対応した通知です。単純なキーなら Triggered だけで足りますが、Hold のような時間のかかる Trigger では他のピンが意味を持ちます。

イベントノードには実行ピンのほかに、値の出力ピンもあります。Value Type が Digital なら真偽値、Axis2D なら Vector2D として取り出せます。Value Type と受け取り方が食い違うと値が常にゼロに見えるので注意してください。

8旧 Input Mappings との違いを整理する

9最初につまずきやすいところ

10UI と入力の関係にも注意する

Enhanced Input を正しく設定しても、ウィジェット (Widget) を画面に出した後だけ入力が効かなくなる、というトラブルはよく起こります。これは Enhanced Input の問題ではなく、プレイヤーの入力モードがどこに向いているかという別レイヤーの話です。入力モードの扱いについては 「Set Input Mode」の種類と使い方 と SetInputMode_UIOnlyを取り消す方法 が参考になります。ポーズメニューを閉じるキーで悩んだ場合は Blueprintで「Esc」キーを使ってイベントを発生させる方法 も併せて確認してください。