Unity InputSystemを用いたPlayerController実装ガイド（ポーリング方式からイベント駆動型へ）

2025年4月1日2025年4月2日

この資料では、Unityの新しいInputSystemを使用してプレイヤーキャラクターの移動やジャンプ処理を実装する方法について解説します。従来のポーリング方式での入力取得から、イベント駆動型の入力処理への移行方法を具体例とともに紹介します。

1. 背景と目的

背景

UnityのInputSystemは、従来のInput.GetAxis()などを使用した方法に比べ、イベント駆動型のコールバックを利用することで、より直感的で効率的な入力管理が可能となっています。

目的

• キャラクターの移動およびジャンプ処理を実装する
• InputSystemのイベント駆動型（OnMove、OnJumpコールバック）を活用して入力を取得する
• キャラクターが地上にいる場合のみジャンプ処理を実行する

2. コード例

2.1 従来のポーリング方式による実装例

以下のコードは、PlayerInputコンポーネントからアクションを取得し、Update内で常に入力値を読み取る従来の実装例です。

using UnityEngine;
using UnityEngine.InputSystem;

[RequireComponent(typeof(CharacterController))]
[RequireComponent(typeof(PlayerInput))]
public class PlayerController : MonoBehaviour
{
    [SerializeField] private float moveSpeed = 3; // 移動速度
    [SerializeField] private float jumpPower = 3; // ジャンプ力
    private CharacterController _characterController; // CharacterControllerのキャッシュ
    private Transform _transform; // Transformのキャッシュ
    private Vector3 _moveVelocity; // キャラの移動速度情報
    private InputAction _move; // Moveアクションのキャッシュ
    private InputAction _jump; // Jumpアクションのキャッシュ

    private void Start()
    {
        _characterController = GetComponent<CharacterController>(); // 毎フレームアクセスするので、負荷を下げるためにキャッシュしておく
        _transform = transform; // Transformもキャッシュすると少しだけ負荷が下がる

        var input = GetComponent<PlayerInput>();
        // PlayerInputの「Default Map」で指定されているアクションマップを有効化
        input.currentActionMap.Enable();
        // アクションマップからアクションを取得するには FindAction() を使う
        _move = input.currentActionMap.FindAction("Move");
        _jump = input.currentActionMap.FindAction("Jump");
    }

    private void Update()
    {
        Debug.Log(_characterController.isGrounded ? "地上にいます" : "空中です");

        // Moveアクションを使った移動処理（慣性を無視しているので、キビキビ動く）
        var moveValue = _move.ReadValue<Vector2>();
        _moveVelocity.x = moveValue.x * moveSpeed;
        _moveVelocity.z = moveValue.y * moveSpeed;

        // 移動方向に向く
        _transform.LookAt(_transform.position + new Vector3(_moveVelocity.x, 0, _moveVelocity.z));

        if (_characterController.isGrounded)
        {
            if (_jump.WasPressedThisFrame())
            {
                // ジャンプ処理
                Debug.Log("ジャンプ！");
                _moveVelocity.y = jumpPower; // ジャンプの際は上方向に移動させる
            }
        }
        else
        {
            // 重力による加速
            _moveVelocity.y += Physics.gravity.y * Time.deltaTime;
        }

        // オブジェクトを動かす
        _characterController.Move(_moveVelocity * Time.deltaTime);
    }
}

🎓 Unityにおけるキャラクターの重力挙動と物理法則の関係

〜 CharacterController.Move() と運動方程式の対応 〜 📘 概要 Unityでキャラクターを動かす際に用いる ...

 https://soft-rime.com/post-22998/

Character Controller コンポーネントのリファレンス - Unity マニュアル

Character Controller は、主に Rigidbody による物理特性を使用しない、一人称や三人称のプレイヤー制 ...

 https://docs.unity3d.com/ja/current/Manual/class-CharacterCo...

[SerializeField] private float rotationSpeed = 10f; // 回転速度

private void Update()
{
    // 入力から移動速度を計算（既存の処理）
    var moveValue = _move.ReadValue<Vector2>();
    _moveVelocity.x = moveValue.x * moveSpeed;
    _moveVelocity.z = moveValue.y * moveSpeed;

    // 移動方向が存在する場合にのみ回転処理を実行
    Vector3 moveDirection = new Vector3(_moveVelocity.x, 0, _moveVelocity.z);
    if (moveDirection != Vector3.zero)
    {
        // 目標の回転を計算
        Quaternion targetRotation = Quaternion.LookRotation(moveDirection);
        // 現在の回転から目標の回転に向かって補間
        _transform.rotation = Quaternion.Slerp(_transform.rotation, targetRotation, Time.deltaTime * rotationSpeed);
    }

    // ジャンプや重力処理など、残りの移動処理（既存の処理）
    if (_characterController.isGrounded)
    {
        if (_jump.WasPressedThisFrame())
        {
            Debug.Log("ジャンプ！");
            _moveVelocity.y = jumpPower;
        }
    }
    else
    {
        _moveVelocity.y += Physics.gravity.y * Time.deltaTime;
    }
    _characterController.Move(_moveVelocity * Time.deltaTime);
}

2.2 イベント駆動型による実装例

次に、InputSystemのイベント駆動型コールバック（OnMove、OnJump）を利用した実装例です。こちらは、PlayerInputコンポーネントが自動的に各イベントを呼び出す設定となっている前提です。

using UnityEngine;
using UnityEngine.InputSystem;

[RequireComponent(typeof(CharacterController))]
[RequireComponent(typeof(PlayerInput))]
public class PlayerController : MonoBehaviour
{
    [SerializeField] private float moveSpeed = 3f;   // 移動速度
    [SerializeField] private float jumpPower = 3f;     // ジャンプ力

    private CharacterController _characterController;
    private Vector3 _moveVelocity;
    private Vector2 _moveInput;
    private bool _jumpPressed;

    private void Awake()
    {
        _characterController = GetComponent<CharacterController>();
    }

    private void Update()
    {
        Debug.Log(_characterController.isGrounded ? "地上にいます" : "空中です");

        // Moveイベントで更新された入力値を利用した移動処理
        _moveVelocity.x = _moveInput.x * moveSpeed;
        _moveVelocity.z = _moveInput.y * moveSpeed;

        // 入力がある場合のみキャラクターの向きを更新
        if (_moveInput.sqrMagnitude > 0.01f)
        {
            transform.LookAt(transform.position + new Vector3(_moveVelocity.x, 0, _moveVelocity.z));
        }

        if (_characterController.isGrounded)
        {
            // ジャンプイベントで設定されたフラグが立っていたらジャンプ実行
            if (_jumpPressed)
            {
                Debug.Log("ジャンプ！");
                _moveVelocity.y = jumpPower;
                _jumpPressed = false;  // ジャンプフラグをリセット
            }
        }
        else
        {
            // 空中にいる場合は重力を適用
            _moveVelocity.y += Physics.gravity.y * Time.deltaTime;
        }

        _characterController.Move(_moveVelocity * Time.deltaTime);
    }

    // InputSystemからの移動入力を受け取るコールバック
    public void OnMove(InputValue value)
    {
        _moveInput = value.Get<Vector2>();
    }

    // InputSystemからのジャンプ入力を受け取るコールバック
    public void OnJump(InputValue value)
    {
        // 地上にいる場合のみジャンプフラグを立てる
        if (value.isPressed && _characterController.isGrounded)
        {
            _jumpPressed = true;
        }
    }
}

2.3 参考コード例

以下のコードは、InputSystemのイベントを利用した移動処理の簡単な例です。イベント駆動型の考え方をシンプルに理解するための参考としてご利用ください。

using UnityEngine;
using UnityEngine.InputSystem;

public class PlayerControllerSample : MonoBehaviour
{
    private Vector2 moveInput;
    public float moveSpeed = 5f;

    void Update()
    {
        Vector3 move = new Vector3(moveInput.x, 0, moveInput.y) * moveSpeed * Time.deltaTime;
        transform.Translate(move, Space.World);
    }

    void OnMove(InputValue value)
    {
        moveInput = value.Get<Vector2>();
    }
}

3. 実装のポイントと注意点

• キャッシュ処理:
  頻繁にアクセスするCharacterControllerやTransformの参照は、StartやAwakeでキャッシュすることでパフォーマンスの向上が期待できます。
• InputSystemの活用:
  PlayerInputコンポーネントを利用すると、アクションマップの有効化や各種イベント（OnMove, OnJumpなど）が自動的に呼び出され、コードがシンプルになります。
• イベント駆動型:
  イベント駆動型の入力処理は、ポーリング方式に比べて直感的に入力の変化を捉えやすく、また不要な処理が削減されるため、コードの可読性も向上します。
• ジャンプ処理:
  ジャンプ処理は、キャラクターが地上にいることを確認した上で実行する必要があります。イベント駆動型の実装では、入力時にフラグをセットし、Update内でそのフラグをチェックしてジャンプを実行する方法が効果的です。
• 重力の適用:
  キャラクターが空中にいる場合は、重力の影響を継続して適用することで、自然な落下運動を実現します。

4. まとめ

UnityのInputSystemを活用したイベント駆動型の入力処理は、従来のポーリング方式に比べて、コードのシンプル化や直感的な入力管理が可能となります。今回のサンプルコードを参考に、プロジェクトのニーズに合わせたカスタマイズや拡張を行い、より洗練されたプレイヤーコントローラーを実装してください。