Unity6 環境における PlayerControler スクリプト実行手順

2025年3月16日

はじめに

本資料では、Unity6 で Input System がインストールされ、デフォルトの Input Actions アセットが設定済みの状態において、
PlayerControler スクリプトを利用してシーン内のオブジェクト（Cube）をプレイヤーとして移動させる手順を説明します。

必要な環境と前提条件

• Unity6 環境
• Input System パッケージのインストール済み（Unity6ではインストール済み）
• デフォルトの Input Actions アセットの設定済み（Unity6ではインストール済み）

手順 1: 新規 Unity プロジェクトの作成

1. Unity Hub の起動
   Unity Hub を開き、「New Project（新規プロジェクト作成）」をクリックします。
2. テンプレートの選択
   「Universal 3D」テンプレートを選択し、プロジェクト名（例: PlayerMovementTutorial）を入力します。
3. プロジェクトの作成
   「プロジェクトを作成」をクリックしてプロジェクトを作成します。

手順 2: PlayerControler スクリプトの作成

1. スクリプト作成
   • 「Project」ウィンドウ内の Assets フォルダを右クリックし、
   • 「Create > MonoBehaviour Script」 を選択します。
   • スクリプト名を PlayerControler に変更します。
2. スクリプトの編集
   作成した PlayerControler.cs をダブルクリックしてエディタ（例: Visual Studio）で開き、以下のコードに置き換えます：

using UnityEngine;
using UnityEngine.InputSystem;

public class PlayerControler : MonoBehaviour
{
    // プレイヤーの移動入力値を保存する変数（x: 横方向、y: 前後方向）
    private Vector2 moveInput;
    
    // プレイヤーの移動速度（1秒あたりの移動距離）
    public float moveSpeed = 5f;

    // Unity の毎フレーム更新メソッド
    void Update()
    {
        // 入力に基づく移動処理を実行
        Move();
    }

    // Input System により、移動入力が発生した際に自動的に呼び出されるコールバックメソッド
    // InputValue の内容を Vector2 型に変換し、moveInput に保存する
    void OnMove(InputValue value)
    {
        moveInput = value.Get<Vector2>();
    }

    // プレイヤーの移動処理を実装するメソッド
    void Move()
    {
        // 入力値から移動ベクトルを計算
        // - moveInput.x が左右の移動、moveInput.y が前後の移動に対応
        // - y 軸は水平移動のため常に 0（上下の移動は行わない）
        // - moveSpeed を掛けることで速度を調整
        // - Time.deltaTime を掛けることでフレームレートに依存しない移動を実現
        Vector3 move = new Vector3(moveInput.x, 0, moveInput.y) * moveSpeed * Time.deltaTime;
        
        // 計算された移動ベクトル分、プレイヤーオブジェクトをワールド空間内で移動する
        transform.Translate(move, Space.World);
    }
}

using UnityEngine;
using UnityEngine.InputSystem;

public class PlayerControler : MonoBehaviour
{
    // プレイヤーの移動入力値を保存する変数（x: 横方向、y: 前後方向）
    private Vector2 moveInput;

    // プレイヤーの移動速度（1秒あたりの移動距離）
    public float moveSpeed = 5f;
    ...
}

void Update()
{
    // 入力に基づく移動処理を実行
    Move();
}

// Input System により呼び出されるコールバック
void OnMove(InputValue value)
{
    moveInput = value.Get<Vector2>();
}

void Move()
{
    // 入力値から移動ベクトルを計算
    // - moveInput.x が左右の移動、moveInput.y が前後の移動に対応
    // - y 軸は水平移動のため常に 0（上下の移動は行わない）
    // - moveSpeed を掛けることで速度を調整
    // - Time.deltaTime を掛けることでフレームレートに依存しない移動を実現
    Vector3 move = new Vector3(moveInput.x, 0, moveInput.y) * moveSpeed * Time.deltaTime;

    // 計算された移動ベクトル分、プレイヤーオブジェクトをワールド空間内で移動する
    transform.Translate(move, Space.World);
}

3. 保存
   VisualStudioエディタ上でスクリプトを保存します（Ctrl+S または Command+S）。

手順 3: プレイヤーオブジェクトの作成とスクリプトのアタッチ

1. プレイヤーオブジェクトの追加
   メニューから 「GameObject > 3D Object > Cube」 を選択して、シーンに Cube を配置します。
   ※ Cube をプレイヤーオブジェクトとして使用します。
2. スクリプトのアタッチ
   Cube を選択し、Inspector ウィンドウで「Add Component」をクリック。
   「PlayerControler」を検索し、スクリプトをアタッチします。
   作成したスクリプトをインスペクターにドラッグ&ドロップでもアタッチできます

手順 4: Player Input コンポーネントの設定

1. Player Input の追加
   Cube の Inspector で「Add Component」をクリックし、「Player Input」 を検索して追加します。
2. 送信メッセージの設定
   Player Input コンポーネント内の Behavior を「Send Messages」に設定します。（Unity6ではデフォルトです）
   ※ この設定により、デフォルトで設定済みの Input Actions アセットに基づき、入力が発生すると自動で OnMove メソッドが呼び出されます。
3. Input Actions アセットの確認
   ※ 既にデフォルトの Input Actions アセットが設定されているため、追加の作業は不要です。
   ※ Inspector 上で、アクション「Move」に対応するバインディング（WASD、矢印キー、ゲームパッドなど）が正しく割り当てられているか確認してください。

Player Inputコンポーネント

Input Action Assetファイル

手順 5: シーンの保存と実行

1. シーンの保存
   メニューの 「File > Save Scene」 からシーンを保存します。
   ※ シーン名は Main など任意の名前で保存してください。
2. 実行
   エディタ上部の「Play」ボタンをクリックしてシーンを実行します。
3. 動作確認
   実行中にキーボードの WASD または矢印キーを操作し、Cube（プレイヤーオブジェクト）が設定した移動速度で動くか確認してください。
   ※ 必要に応じて、Inspector 内の moveSpeed の値を調整しながらテストしてください。

まとめ

以上の手順に従って、Unity6 環境で Input System がインストールされた状態で、PlayerControler スクリプトによるプレイヤー移動機能を実装できます。
Cube が正しく入力に反応して動作することを確認したら、さらにシーンのカスタマイズや新たな機能の追加に挑戦してください。