矢印キーで2Dプレイヤーをタイル1マスずつ動かし、長押しでの連続移動と、進む方向に合わせた向きの画像の切り替えができるようになります。

昔のRPGのように、キャラクターがマス目にそってカクカクと動く移動するゲームは3Dゲームよりも制作の負担もなく現在もレトロゲームや同人ゲームとして人気が強いです。

Tilemapでマップを作ったあと、「プレイヤーを1マスずつ動かすにはどうすればいいの？」とつまずく人も多いはずです。

本記事では、2dキャラクターの実装として、Input.GetKeyを使ったキー入力から1マスずつの移動・向きの切り替えまでを解説します。キーを押しっぱなしにしたときの連続移動や、2つのキーを同時に押したときの優先順位など、実際に遊ぶと気になる動きにも対応しています。

【Unity】Rigidbody+CapsuleColliderを用いたプレイヤー移動

UnityでCharacterControllerからRigidbody+CapsuleColliderへ移動処理を移行する方法を解説。カメラ相対移動、FixedUpdateでの速度制御、移行の判断基準まで紹介します。

alicia-ing.com

2026.07.13

Input.GetKey（キー入力）

Input.GetKeyは、キーボードのキーが押されているかどうかを調べる関数です。矢印キーでキャラクターを動かす、スペースキーでジャンプする、Escキーでメニューを開くなど、キーボードで操作するゲームのほとんどで使われます。

使い方は、調べたいキーをKeyCodeで指定するだけです。矢印キーはそれぞれ次のKeyCodeに対応しています。

if (Input.GetKey(KeyCode.RightArrow))
{
    // →キーが押されている間、毎フレーム実行される
}

キー入力の処理は、毎フレーム呼ばれるUpdate()の中に書きます。

参考：Input.GetKey – Unity スクリプトリファレンス

GetKey・GetKeyDown・GetKeyUpの違い

キー入力を調べる関数は3種類あり、trueを返すタイミングが違います。

1マスずつ動かしたい場合、GetKeyだけを使うと毎フレーム1マス進んでしまい、一瞬で画面の端まで飛んでいってしまいます。反対にGetKeyDownだけを使うと、押すたびに1マスしか進まず、長い距離を歩くときにキーを何度も叩くことになります。

そこで本記事のコードでは、2つを組み合わせています。

• GetKeyDown： どのキーが「新しく押されたか」を調べる
• GetKey： そのキーが「まだ押され続けているか」を調べ、一定の間隔で連続移動する

event Action（C#のイベント）で処理をつなぐ

eventは、「何かが起きたこと」を他のスクリプトに知らせるためのC#の仕組みです。Actionと組み合わせると、知らせるときに値（移動方向など）も一緒に渡せます。

例えば「キーが押された」ことを入力のスクリプトが知らせ、それを受け取った移動のスクリプトがプレイヤーを動かす、という使い方をします。

// 知らせる側
public event Action<Vector3> MoveRequested;   // Vector3（方向）を一緒に渡すイベント
MoveRequested?.Invoke(Vector3.up);            // 登録されている処理をまとめて呼ぶ

// 受け取る側
input.MoveRequested += OnMoveRequested;       // 登録
input.MoveRequested -= OnMoveRequested;       // 解除

イベントを使うと、入力・移動・画像の切り替えを別々のスクリプトに分けられます。それぞれのスクリプトはお互いの中身を知らなくてよいため、後から「NPCにも同じ移動を使いたい」「入力をゲームパッドに変えたい」となったときに、一部だけを差し替えられます。

なお、UnityにはInspectorから登録できるUnityEventもあります。本記事ではコードの中だけで完結させるため、C#のeventを使っています。

参考：イベント – C# プログラミング ガイド（Microsoft Learn）

SpriteRenderer.spriteで画像を差し替える

SpriteRendererは、2Dの画像（スプライト）を画面に表示するコンポーネントです。
spriteプロパティに別のスプライトを代入すると、表示している画像をその場で差し替えられます。

playerRenderer.sprite = spriteUp;   // 上向きの画像に切り替える

キャラクターの向きを変える方法には、ほかにAnimatorでアニメーションを切り替える方法もあります。

歩きのアニメーションまで作り込みたい場合はAnimatorが向いていますが、上下左右の4枚の画像を切り替えるだけなら、spriteを差し替える方法の方が設定が少なく済みます。

【Unity】2D/3Dオブジェクトが表示されない原因と対処方法

2D/3Dオブジェクトが表示されない原因は、カメラワークの不具合が考えられます。「Screen Space - Camera」にして、MainCameraをアタッチすると正しく表示されます。

alicia-ing.com

2024.11.10

参考：SpriteRenderer.sprite – Unity スクリプトリファレンス

矢印キーで1マスずつ動く2Dプレイヤー移動

ここまでに説明したInput.GetKey・event Action・SpriteRenderer.spriteを組み合わせて、Tilemapの上を1マスずつ歩く2Dプレイヤーを作ります。実装する動きは次のとおりです。

• 1マスずつ移動： 矢印キーを押すと、上下左右に1マス分だけ移動する
• 長押しで連続移動： キーを押しっぱなしにすると、少し待ってから一定の間隔で進み続ける
• 同時押しの優先： 2つのキーを押したときは、後から押したキーの方向へ進む（斜めには進まない）
• 向きの切り替え： 進む方向に合わせて、キャラクターの画像を上下左右に切り替える
• 止まったときの表示： キーを離したら「待機画像」か「最後に向いた方向」のどちらかを表示する

処理は役割ごとに5つのスクリプトに分けています。

ソースコード

PlayerInput.cs

using System;
using System.Collections.Generic;
using UnityEngine;

/// <summary>
/// 矢印キーから移動の要求
/// </summary>
public class PlayerInput : MonoBehaviour
{
    [SerializeField] private float repeatDelay = 0.2f;     
    [SerializeField] private float repeatInterval = 0.1f;  
    private float repeatTimer;      

    public event Action<Vector3> MoveRequested; 
    public event Action Released;              
    //入力キーと方向を対応させる
    private static readonly (KeyCode key, Vector3 direction)[] bindings =
    {
        (KeyCode.UpArrow, Vector3.up),
        (KeyCode.DownArrow, Vector3.down),
        (KeyCode.RightArrow, Vector3.right),
        (KeyCode.LeftArrow, Vector3.left),
    };

    // 押された順に並べたbindingsの添字。最後が現在有効なキー
    private readonly List<int> heldKeys = new List<int>();
    private const int None = -1;  // キーを押していない
    private int CurrentIndex => heldKeys.Count > 0 ? heldKeys[heldKeys.Count - 1] : None;

    private void Update()
    {
        int previousIndex = CurrentIndex;

        heldKeys.RemoveAll(i => !Input.GetKey(bindings[i].key));
        for (int i = 0; i < bindings.Length; i++)
        {
            if (Input.GetKeyDown(bindings[i].key) && !heldKeys.Contains(i))
                heldKeys.Add(i);
        }
        
        int currentIndex = CurrentIndex;
        if (currentIndex == None)
        {
            if (previousIndex != None) Released?.Invoke();
            return;
        }

        if (currentIndex != previousIndex)
        {
            repeatTimer = repeatDelay;
            MoveRequested?.Invoke(bindings[currentIndex].direction);
            return;
        }

        repeatTimer -= Time.deltaTime;
        if (repeatTimer <= 0f)
        {
            repeatTimer = repeatInterval;
            MoveRequested?.Invoke(bindings[currentIndex].direction);
        }
    }
}

GridMover.cs

using System;
using UnityEngine;

/// <summary>
/// 対象を1マスずつ動かす。向き・移動の通知を行う
/// </summary>
public class GridMover : MonoBehaviour
{
    [SerializeField] private Transform target;
    [SerializeField] private float gridSize = 1f;

    public event Action<Vector3> MoveAttempted;
    public event Action<Vector3, Vector3> Moved;

    //移動処理
    public bool TryMove(Vector3 direction)
    {
        if (direction == Vector3.zero || target == null) return false;

        MoveAttempted?.Invoke(direction);

        Vector3 nextPos = target.position + direction * gridSize; //移動先

        target.position = nextPos;  //位置更新
        Moved?.Invoke(nextPos, direction);
        return true;
    }
}

PlayerDirectionSprite.cs

using UnityEngine;

/// <summary>
/// プレイヤーの進行で画像差し替え
/// </summary>
public class PlayerDirectionSprite : MonoBehaviour
{
    //止まっているときの状態
    private enum IdleFacingMode
    {
        IdleSprite, //待機
        LastDirection //最後に向いている方向
    }

    [SerializeField] private SpriteRenderer playerRenderer;
    [SerializeField] private Sprite spriteIdle;
    [SerializeField] private Sprite spriteUp;
    [SerializeField] private Sprite spriteDown;
    [SerializeField] private Sprite spriteLeft;
    [SerializeField] private Sprite spriteRight;
    [SerializeField] private IdleFacingMode idleFacingMode = IdleFacingMode.LastDirection;

    private Vector3 lastFacingDirection = Vector3.zero;

    //指定した方向を向く
    public void Face(Vector3 direction)
    {
        if (direction == Vector3.zero) return; 

        lastFacingDirection = direction;
        SetSprite(GetSpriteForDirection(direction));
    }

    //止まったときの画像にする
    public void ShowIdle()
    {
        bool hasLastFacing = lastFacingDirection != Vector3.zero;
        bool keepLastFacing = idleFacingMode == IdleFacingMode.LastDirection && hasLastFacing;

        SetSprite(keepLastFacing ? GetSpriteForDirection(lastFacingDirection) : null);
    }

    //画像の差し替え
    private void SetSprite(Sprite sprite)
    {
        if (playerRenderer == null) return;

        Sprite nextSprite = sprite ?? spriteIdle;
        if (nextSprite != null && playerRenderer.sprite != nextSprite)
            playerRenderer.sprite = nextSprite;
    }

    //対応する画像を呼び出す
    private Sprite GetSpriteForDirection(Vector3 direction)
    {
        if (direction == Vector3.up && spriteUp != null) return spriteUp;
        if (direction == Vector3.down && spriteDown != null) return spriteDown;
        if (direction == Vector3.left && spriteLeft != null) return spriteLeft;
        if (direction == Vector3.right && spriteRight != null) return spriteRight;
    
        return null;
    }
}

PlayerSpawner.cs

using UnityEngine;

/// <summary>
/// シーン開始時のプレイヤーの位置と向きを決める
/// </summary>
public class PlayerSpawner : MonoBehaviour
{
    [SerializeField] private Transform target;
    [SerializeField] private Vector3 startPosition = new Vector3(0.5f, 0.5f, 0f); 

    // 開始位置に置き、開始時の向きを startFacing に入れる
    public void Spawn(out Vector3 startFacing)
    {
        if (target == null) target = transform;

        target.position = startPosition;
        startFacing = Vector3.zero;
    }
}

PlayerController.cs

using UnityEngine;

/// <summary>
/// プレイヤーの各コンポーネントの接続
/// 入力 → 移動 → 向きの画像
/// </summary>
public class PlayerController : MonoBehaviour
{
    [SerializeField] private PlayerInput input;
    [SerializeField] private GridMover mover;
    [SerializeField] private PlayerSpawner spawner;
    [SerializeField] private PlayerDirectionSprite directionSprite; // 向きスプライト制御

    // イベントの登録/解除
    private void OnEnable()
    {
        if (input != null)
        {
            input.MoveRequested += OnMoveRequested; 
            input.Released += OnReleased;
        }
        if (mover != null)
        {
            mover.MoveAttempted += OnMoveAttempted;
        }
    }

    private void OnDisable()
    {
        if (input != null)
        {
            input.MoveRequested -= OnMoveRequested;
            input.Released -= OnReleased;
        }
        if (mover != null)
        {
            mover.MoveAttempted -= OnMoveAttempted;
        }
    }

    private void Start()
    {
        Vector3 startFacing = Vector3.zero;
        if (spawner != null) spawner.Spawn(out startFacing);

        if (directionSprite == null) return;
        if (startFacing == Vector3.zero) directionSprite.ShowIdle();
        else directionSprite.Face(startFacing);
    }

    ///イベントを受け取る
    private void OnMoveRequested(Vector3 direction) => mover?.TryMove(direction);
    private void OnReleased() => directionSprite?.ShowIdle();
    private void OnMoveAttempted(Vector3 direction) => directionSprite?.Face(direction);
}

解説

• 名前空間（モジュール）

• イベント

処理の流れをまとめると、次のようになります。

[PlayerInput] 矢印キーを押す → MoveRequested
      ↓
[PlayerController] OnMoveRequested → GridMover.TryMove()
      ↓
[GridMover] MoveAttempted → 1マス移動 → Moved
      ↓
[PlayerController] OnMoveAttempted → PlayerDirectionSprite.Face()（画像を切り替え）

[PlayerInput] キーを離す → Released → PlayerDirectionSprite.ShowIdle()

キー長押しで連続移動する（repeatDelay・repeatInterval）

PlayerInputのUpdate()では、キーを押したときと、押し続けているときで処理を分けています。

// 有効なキーが変わった：即移動
if (currentIndex != previousIndex)
{
    repeatTimer = repeatDelay;
    MoveRequested?.Invoke(bindings[currentIndex].direction);
    return;
}

//同じキーを押し続ける
repeatTimer -= Time.deltaTime;
if (repeatTimer <= 0f)
{
    repeatTimer = repeatInterval;
    MoveRequested?.Invoke(bindings[currentIndex].direction);
}

キーを押した瞬間はすぐに1マス進み、タイマーにrepeatDelay（0.2秒）をセットします。そのまま押し続けると、タイマーが0になったところで次の1マスに進み、以降はrepeatInterval（0.1秒）ごとに進みます。

パソコンでキーを押しっぱなしにしたとき、1文字目のあとに少し間が空いてから文字が連続で入力されるのと同じ仕組みです。最初に少し待つことで、「1マスだけ動きたかったのに2マス進んでしまった」という誤操作を防げます。

Time.deltaTime（前のフレームからの経過時間）を引いているため、フレームレートが変わっても同じ速さで進みます。歩く速さを変えたいときは、InspectorでRepeat Intervalの値を調整してください。値を小さくするほど速く歩きます。

キー同時押しの優先度

2つの矢印キーを同時に押したときにどちらへ進むかは、heldKeysリストで決めています。

//リスト更新（離されたキーを外し、新しく押されたキーを末尾に追加）
heldKeys.RemoveAll(i => !Input.GetKey(bindings[i].key));
for (int i = 0; i < bindings.Length; i++)
{
    if (Input.GetKeyDown(bindings[i].key) && !heldKeys.Contains(i))
        heldKeys.Add(i);
}

1. RemoveAllで、もう押されていないキーをリストから外す
2. GetKeyDownで新しく押されたキーを見つけ、リストの末尾に追加する

リストの末尾が「一番最後に押したキー」になり、CurrentIndexはこの末尾のキーを返します。

private int CurrentIndex => heldKeys.Count > 0 ? heldKeys[heldKeys.Count - 1] : None;

例えば、→キーを押しながら↑キーを押すと↑方向へ進みます。そのあと↑キーだけを離すと、リストには→キーが残っているため、すぐに→方向へ戻って進みます。

入力をif文で上から順に調べる書き方だと、「↑と→を同時に押すと、いつも↑が勝つ」「同時に押すと斜めに進む」といった動きになりがちです。押した順番を覚えておくことで、プレイヤーの操作に素直に反応する移動になります。

実装

5つのスクリプトは、プレイヤーのオブジェクトと、画像を表示するオブジェクトにアタッチします。

各スクリプトは[RequireComponent]を使っていないため、必要なコンポーネントは自動で追加されません。SpriteRendererの追加と、PlayerControllerの参照の設定は、忘れずに手動で行ってください。

まとめ

本記事では、Tilemapの上で2Dプレイヤーを矢印キーで1マスずつ動かす方法として、次の内容を解説しました。

• Input.GetKeyとGetKeyDownを組み合わせて、押した瞬間の移動と長押しの連続移動を作る
• 押したキーの順番をListで覚えて、同時押しでは後から押したキーを優先する
• SpriteRenderer.spriteを差し替えて、進む方向に合わせて画像を切り替える

スクリプトを役割ごとに分けているため、ここから機能を足していくのも簡単です。次のステップとして、GridMoverに壁の判定を加えて「壁の方を向くだけで進めない」動きにしたり、Movedイベントを使ってマップの端で別のシーンへ切り替えたりすると、RPGのマップ移動らしくなります。

Input SystemのInputActionReferenceを使って、ゲームパッドでキャラクターの移動とジャンプを操作できるようになります。

Unityでプレイヤー操作実装する際に、キーボード操作だけでなく「ゲームパッド（コントローラー）にも対応したい」という場面が出てきます。

特にアクションゲームやプラットフォーマーでは、スティックでの移動とボタンでのジャンプはほぼ必須の操作です。

本記事では、Unityの新しいInput SystemとInputActionReferenceを使い、移動・ジャンプという最小構成でゲームパッド対応を実装する方法を分かりやすく解説します。

Gamepad.currentを直接参照する方法やPlayerInputコンポーネントに依存する方法とは違う、疎結合で使い回しやすい設計です。

【Unity】マウス操作をゲームに導入する画面クリックで処理

UnityでCSVのテキストをマウスクリックで１つずつ進めるには、if文でメソッド「Input.GetMouseButtonDown(0)」を使用します。ノベルゲームは画面のクリック回数に応じてテキストを表示するシステムに近づきます。

alicia-ing.com

2025.08.11

Input System

Input Systemは、キーボード・マウス・ゲームパッドなどの入力をまとめて扱える、Unityの新しい入力の仕組みです。

XboxコントローラーやPlayStationコントローラー（DualSense）などのゲームパッドに対応したいときや、同じ操作をキーボードとゲームパッドの両方で行えるようにしたいときに使います。

従来のInput.GetAxis()などを使う古い入力システム（Input Manager）でもある程度のゲームパッド対応は可能でしたが、デバイスごとの差異を吸収しづらく、コードが複雑になりがちでした。

Input Systemでは、実際の入力デバイスと、ゲーム内の意味（「移動する」「ジャンプする」）をInput Actionという単位で分けられます。そのため、デバイスが変わってもコード側を変更せずに済みます。

Input Systemを使うには、パッケージの導入と、入力を定義するInput Actionsアセットの作成が必要です。

参考：Input System – Unity マニュアル

Input Systemパッケージの導入

Unity Input Systemは標準では有効になっていないため、Package Managerからインストールする必要があります。

1. メニューから Window > Package Manager を開きます
2. 検索欄で「Input System」を検索し、Install をクリックします
3. インストール後、「新しい入力システムに切り替えますか？」という確認ダイアログが表示されるので Yes を選択します（Unityの再起動が必要です）

Input Actionsアセットとゲームパッドのバインディング設定

次に、実際の入力を定義するInput Actionsアセットを作成します。

1. Projectウィンドウで右クリックし、Create > Input Actions を選択してアセットを作成します
2. 作成したアセットをダブルクリックしてエディタを開きます
3. Action Mapsに「Player」などの名前でマップを作成します

各アクションの+ボタンからバインディングを追加し、Listen機能を使って実際にゲームパッドを操作するとバインディング候補が自動検出されるので、それを選択すると設定が楽になります。

設定が終わったら忘れずにSave Assetをクリックしてください。

InputActionReference

InputActionReferenceは、Input Actionsアセットの中にある特定のInput Actionを、Inspectorから参照するための型です。スクリプトにアクション名を文字列で書かずに、「どのアクションを使うか」をInspectorで選べます。

InputActionReferenceは、同じ入力ハンドラークラスを別のキャラクターやプレハブで使い回したり、テスト用に別のInput Actionsアセットへ差し替えたりしやすくなります。

参考：InputActionReference – Input System ドキュメント

InputActionReferenceで実装する移動・ジャンプ入力

本記事では、InputActionReferenceを使って、ゲームパッドの移動（左スティック）とジャンプ（ボタン）を取得する入力ハンドラーを実装します。

入力の取得だけを専用クラス（PlayerInputHandler）に切り出し、実際の移動処理・ジャンプ処理からはMoveInput・JumpWasPressedThisFrameという2つのプロパティを参照するだけで済むようにすることで、キーボードやマウスなど他の入力方式にも差し替えやすい設計を目指します。

F310r-Windows11で使えるゲームパッド実機レビュー

Logicool F310ゲームパッドの実機レビュー。Windows 11対応の設定方法やドライバ情報を解説。スペックや操作手順を紹介。

alicia-ing.com

2025.03.28

Logicool G ゲームパッド F310r ゲーム コントローラー 有線 USB 接続 FF14 steam PC PS5 PS4 windows F310 国内正規品 【 ファイナルファンタジー XIV 推奨モデル 】

¥2,527 （2026/09/26 19:01時点 | Amazon調べ）

Amazon

楽天市場

Yahooショッピング

ポチップ

ソースコード

using UnityEngine;
using UnityEngine.InputSystem;

public class PlayerInputHandler : MonoBehaviour
{
    [SerializeField] private InputActionReference moveAction;
    [SerializeField] private InputActionReference jumpAction;

    public Vector2 MoveInput { get; private set; }
    public bool JumpWasPressedThisFrame { get; private set; }

    private void OnEnable()
    {
        moveAction.action.Enable();
        jumpAction.action.Enable();
    }

    private void OnDisable()
    {
        moveAction.action.Disable();
        jumpAction.action.Disable();
    }

    private void Update()
    {
        MoveInput = moveAction.action.ReadValue<Vector2>();
        JumpWasPressedThisFrame = jumpAction.action.WasPressedThisFrame();
    }
}

解説

• 名前空間

• フィールド・プロパティ

MoveInput・JumpWasPressedThisFrameは{ get; private set; }としているため、ほかのスクリプトからは読み取りだけができ、書き換えはできません。

InputActionReferenceでアクションを参照

InputActionReferenceは、Input Actionsアセット内の特定のInput ActionをInspector上から参照できる型です。

[SerializeField] private InputActionReference moveAction;
[SerializeField] private InputActionReference jumpAction;

コード内に直接アクション名を文字列で書く必要がなく、Inspectorから見た目でどのアクションを使っているか確認できます。

Gamepad.currentを直接参照する実装と違って、キーボード用のInput ActionsアセットとゲームパッドMap用のアセットを差し替えるだけで入力元を切り替えられます。

同じPlayerInputHandlerを別のプレハブで使い回す際にも、参照先のアクションを変えるだけで対応できる点が疎結合設計のメリットです。

移動入力をVector2で取得する

MoveInput = moveAction.action.ReadValue<Vector2>();

MoveアクションはAction TypeをValue（Vector2）に設定しているため、ReadValue()でスティックの傾き具合をVector2として取得できます。x軸が左右、y軸が上下の入力値（-1〜1の範囲）です。

取得したMoveInputは、別のスクリプト（プレイヤーの移動処理を担うクラスなど）からplayerInputHandler.MoveInputとして参照し、transform.TranslateやRigidbody.linearVelocityなどに渡してキャラクターを動かすといった使い方をします。

【Unity】Rigidbody+CapsuleColliderを用いたプレイヤー移動

UnityでCharacterControllerからRigidbody+CapsuleColliderへ移動処理を移行する方法を解説。カメラ相対移動、FixedUpdateでの速度制御、移行の判断基準まで紹介します。

alicia-ing.com

2026.07.13

ジャンプ入力を1フレームだけ検知する（WasPressedThisFrame）

JumpWasPressedThisFrame = jumpAction.action.WasPressedThisFrame();

WasPressedThisFrame()は、そのボタンが「このフレームで押された瞬間」かどうかを返すメソッドです。

ジャンプのように「押した瞬間に1回だけ処理を実行したい」動作には、このWasPressedThisFrame()を使うのが適切です。

【Unity】キャラクターをジャンプさせる自然な動きを実装

本記事を読むと以下の実行ができますRigidbodyを使ったキャラクターのジャンプ実装と、SphereCastによる正確...

alicia-ing.com

2026.09.20

isPressedにしない理由

InputActionにはisPressed（現在押されているかどうか）とWasPressedThisFrame()（このフレームで押された瞬間かどうか）という似た名前のプロパティ・メソッドがあります。

ジャンプ処理をisPressedで判定してしまうと、ボタンを押し続けている間、毎フレーム「押されている」と判定され続けてしまいます。その結果、Update()が呼ばれるたびにジャンプ処理が実行され、意図せず連続ジャンプしてしまうバグにつながります。

// 悪い例：ボタンを押している間ずっとtrueになる
if (jumpAction.action.IsPressed())
{
    Jump(); // 毎フレーム呼ばれてしまう
}

// 良い例：押した瞬間の1フレームだけtrueになる
if (jumpAction.action.WasPressedThisFrame())
{
    Jump(); // 1回だけ呼ばれる
}

ジャンプやポーズメニューの開閉など、「1回の入力につき1回だけ処理したい」動作では、必ずWasPressedThisFrame()を使うようにしましょう。

逆に、ダッシュのように「押している間だけ継続する」動作にはisPressedが向いています。用途によって使い分けることが重要です。

実演

空のGameObject、またはプレイヤーオブジェクトにアタッチします。

設定が完了すると、他のスクリプトからplayerInputHandler.MoveInput・playerInputHandler.JumpWasPressedThisFrameを参照するだけで、ゲームパッドからの入力を取得できるようになります。

まとめ

本記事では、Unity Input SystemのInputActionReferenceを使い、ゲームパッドでの移動とジャンプを実装する方法を解説しました。

• InputActionReferenceをInspectorで参照することで、入力元を差し替えやすい疎結合な設計にできる
• 移動はReadValue()、ジャンプはWasPressedThisFrame()で取得する
• ジャンプなど「1回だけ処理したい」入力はisPressedではなくWasPressedThisFrame()を使う

今回紹介したPlayerInputHandlerは移動とジャンプの最小構成ですが、同じ考え方でダッシュ・攻撃・ポーズメニューの開閉など他のアクションにも応用できます。

まずはこの最小構成で「ゲームパッドで動くもの」を作り、そこから少しずつアクションを増やしていくと理解が深まるのでおすすめです。

Rigidbodyを使ったキャラクターのジャンプ実装と、SphereCastによる正確な接地判定を組み合わせて、二段ジャンプや無限ジャンプを起こさない自然なジャンプ動作

Unityでキャラクターをジャンプさせることはゲーム開発での基礎ですが、「ボタンを押しても反応しない」「空中で何度もジャンプできてしまう」といった問題によくぶつかります。

これは多くの場合、接地判定（キャラクターが地面に着いているかどうかの判定）が不十分なことが原因です。

本記事では、RigidbodyとPhysics.SphereCastを使い、CapsuleColliderの実際のサイズに連動した接地判定と、目標到達高さから逆算したジャンプ初速の計算方法をあわせて解説します。

ジャンプ実装に必要な要素（SphereCast）とは？

Unityでジャンプ実装を検索すると、「unity rigidbody ジャンプ」「unity 接地判定」といったキーワードで多くの記事がヒットしますが、実装方式は大きく2つの系統に分かれます。

1. ジャンプそのものの実装（AddForceやvelocityでY方向に力・速度を加える）
2. 接地判定の実装（タグ判定・Raycast・CheckSphere・SphereCast・isGroundedなど）

この2つは別々に解説されがちですが、実際に「ちゃんと動くジャンプ」を作るには両方を組み合わせる必要があります。

特に接地判定が甘いと、空中にいるのにジャンプ入力を受け付けてしまい、二段ジャンプ・無限ジャンプというよくあるバグにつながります。

本記事で採用するPhysics.SphereCastは、球（Sphere）を指定方向に飛ばして衝突を検出するUnityの物理判定です。

単純なRaycast（線を1本飛ばすだけ）と違い、球という「太さ」を持つ判定なので、地面のわずかな段差や傾斜でも安定して接地を検出できます。

SphereCastを使ったジャンプ処理

今回のジャンプ実装は、以下の4ステップで構成されています。

ソースコード

using UnityEngine;

[RequireComponent(typeof(Rigidbody), typeof(CapsuleCollider), typeof(PlayerInputHandler))]
public class PlayerJump : MonoBehaviour
{
    [SerializeField] private float jumpHeight = 1.5f;
    [SerializeField] private LayerMask groundMask = ~0;

    private Rigidbody rb;
    private CapsuleCollider capsule;
    private PlayerInputHandler input;
    private bool jumpRequested;

    private void Awake()
    {
        rb = GetComponent<Rigidbody>();
        capsule = GetComponent<CapsuleCollider>();
        input = GetComponent<PlayerInputHandler>();
    }

    private void Update()
    {
        if (input.JumpWasPressedThisFrame)
        {
            jumpRequested = true;
        }
    }

    private void FixedUpdate()
    {
        Vector3 velocity = rb.linearVelocity;

        if (jumpRequested && IsGrounded())
        {
            velocity.y = Mathf.Sqrt(jumpHeight * -2f * Physics.gravity.y);
        }
        jumpRequested = false;

        rb.linearVelocity = velocity;
    }

    private bool IsGrounded()
    {
        Vector3 origin = transform.TransformPoint(capsule.center);
        float castRadius = capsule.radius * 0.9f;
        float castDistance = capsule.height * 0.5f + 0.15f;
        return Physics.SphereCast(origin, castRadius, Vector3.down, out _, castDistance, groundMask, QueryTriggerInteraction.Ignore);
    }
}

解説

• 入力の検知とFixedUpdateでの物理処理を分離する設計

ジャンプボタンの入力検知をUpdate、実際の速度変更をFixedUpdateに分けています。

• Updateはフレームごとに呼ばれる（フレームレートに依存する）ため、入力の取りこぼしを防ぐのに向いています。
• FixedUpdateは一定の時間間隔で呼ばれる（物理エンジンの更新タイミングに同期する）ため、Rigidbodyを操作する処理はここで行うのが基本です。

Update内で直接Rigidbodyの速度を書き換えてしまうと、フレームレートによって物理挙動が不安定になることがあります。そこで、UpdateではjumpRequestedというフラグを立てるだけにとどめ、実際の速度変更はFixedUpdateでまとめて行うように設計しています。

FixedUpdateの先頭でjumpRequestedを判定した後、必ずfalseにリセットしている点もポイントです。これにより、1回のボタン入力に対してジャンプが1回だけ発生するようになります。

• SphereCastでCapsuleColliderに連動した接地判定を行う

IsGrounded()メソッドが接地判定の中心部分です。単純に固定の半径・距離を指定するのではなく、CapsuleColliderのプロパティから動的に計算しています。

Vector3 origin = transform.TransformPoint(capsule.center);
float castRadius = capsule.radius * 0.9f;
float castDistance = capsule.height * 0.5f + 0.15f;

• origin：capsule.center（ローカル座標）をTransformPointでワールド座標に変換し、キャラクターの中心からキャストを開始します。
• castRadius：コライダーの半径そのままだと壁際でわずかに引っかかることがあるため、0.9fを掛けて少し小さめに設定しています。
• castDistance：カプセルの半分の高さ（中心から底面まで）に、地面との間に余裕を持たせる0.15fを加えています。

この値をキャラクターのサイズ（CapsuleCollider）から計算する設計にしておくことで、キャラクターモデルを差し替えてCapsuleColliderのサイズが変わっても、接地判定のコードを書き直す必要がありません。

• ジャンプの初速を目標到達高さから逆算する

ジャンプの高さを「なんとなくの数値」で調整すると、意図した高さにならず何度も微調整することになります。本実装では、到達させたい高さ（jumpHeight）から必要な初速を逆算しています。

velocity.y = Mathf.Sqrt(jumpHeight * -2f * Physics.gravity.y);

これは物理の等加速度運動の公式 v0 = √(2gH) をそのままコードにしたものです。Physics.gravity.yは通常マイナスの値（デフォルトは-9.81）なので、符号を合わせるために-2fを掛けています。

• H：到達させたい高さ（jumpHeight、インスペクターで調整可能）
• g：重力加速度（Physics.gravity.yの絶対値）
• v0：地面を離れる瞬間に必要な初速（Y方向の速度）

インスペクター上でjumpHeightの値を1.5から2.0に変えるだけで、「ちょうど2m飛び上がるジャンプ」を数値ベースで作れるようになります。感覚での調整に頼らず、狙った高さを確実に再現できるのがこの計算式の利点です。

• レイヤーマスクとQueryTriggerInteraction.Ignoreで誤検知を防ぐ

SphereCastはデフォルトのままだと、地面以外のコライダー（アイテムの当たり判定やエフェクト用のトリガーなど）にも反応してしまうことがあります。これを防ぐために2つの仕組みを併用しています。

• groundMask（レイヤーマスク）： SphereCastの判定対象を、あらかじめ設定した「地面」レイヤーのみに絞り込みます。プレイヤー自身や敵、アイテムなどのレイヤーを対象外にできます。
• QueryTriggerInteraction.Ignore： IsTriggerが有効なコライダー（当たり判定はあるが物理的にすり抜けるコライダー）を接地判定の対象から除外します。これを指定しないと、トリガーに触れただけで「地面に着地した」と誤判定されることがあります。

この2つを組み合わせることで、地面用のコライダーだけを確実に検出できるようになります。レイヤーマスクの活用に触れていない競合記事も多いため、意図しない誤検知を防ぎたい場合は必ず設定しておきましょう。

実演

Rigidbody・CapsuleCollider・PlayerInputHandlerを設定済みのプレイヤーオブジェクトにアタッチします（RequireComponentにより、この3つが未設定のオブジェクトにはアタッチできません）。

まとめ

本記事では、Rigidbodyを使ったUnityのジャンプ実装を、以下の4つのポイントに分けて解説しました。

• 入力検知（Update）と物理処理（FixedUpdate）を分離する設計
• CapsuleColliderの実サイズに連動したSphereCast接地判定
• 目標到達高さから初速を逆算するv0 = √(2gH)の計算式
• レイヤーマスクとQueryTriggerInteraction.Ignoreによる誤検知防止

これらを組み合わせることで、二段ジャンプ・無限ジャンプといった典型的なバグを防ぎつつ、狙った高さに正確に跳ぶジャンプ処理を作れます。

まずは本記事のコードをそのまま自分のプロジェクトに組み込み、jumpHeightやgroundMaskの値を自分のキャラクターに合わせて調整するところから始めてみてください。

接地判定の考え方は壁ジャンプや二段ジャンプなど、他のアクションを追加する際の土台にもなります。

プレイヤーの後ろから滑らかに追従する、カクつきのない三人称カメラの実装

3人称視点（TPS/TPP）のゲームを作っていると、カメラをプレイヤーにそのまま追従させただけではカクついたり、キャラクターの動きに機械的に張り付いてしまったりして、なめらかさに欠ける映像になってしまうことがあります。

本記事では、位置はVector3.Lerp、回転はQuaternion.Slerpという2つの異なる補間関数を組み合わせて、自然な三人称カメラの追従処理を実装する方法を解説します。

followSpeedやrotationSpeedなどのパラメータ調整方法や、カメラの動きが不自然になったときのチェックポイントまで、実際に手を動かしながら理解できる内容になっています。

三人称カメラの追従処理とは？

三人称カメラ（TPS/TPPカメラ）とは、プレイヤーが操作するキャラクターの背後や斜め上から映すカメラのことです。アクションゲームやオープンワールドゲームなど、多くの3Dゲームで採用されている視点です。

三人称カメラの追従処理を作るとき、意識すべきポイントは大きく分けて2つあります。

transform.positionをそのままキャラクターの位置に代入するだけでは、カメラが一瞬でキャラクターの真後ろにワープしたような、機械的で不自然な映像になってしまいます。

そこで、位置と回転それぞれに補間（インターポレーション）をかけることで、カメラがワンテンポ遅れてついてくるような、滑らかな追従感を演出します。

このとき重要なのが、位置の補間にはVector3.Lerp、回転の補間にはQuaternion.Slerpという異なる関数を使うという点です。

位置は直線的な移動なので線形補間（Lerp）で十分ですが、回転は「角度」を扱うため、球面線形補間（Slerp）を使わないと不自然な回転になってしまいます。

この違いについてはコードを解説するセクションで詳しく説明します。

Vector3.LerpとQuaternion.Slerpで実装する三人称カメラ

三人称カメラの追従処理は、以下の3ステップで実装できます。

カメラをキャラクターの子オブジェクトにしてしまうと、キャラクターの回転がそのままカメラの回転に伝わってしまい、独立した滑らかな動きを付けられなくなります。

そのため、カメラはシーン上の独立したオブジェクトとして配置し、スクリプトで位置・回転を毎フレーム計算する構成にします。

ソースコード

using UnityEngine;

public class CameraFollow : MonoBehaviour
{
    [SerializeField] private Transform target;
    [SerializeField] private Vector3 offset = new Vector3(0f, 3.2f, -7f);
    [SerializeField] private float followSpeed = 5f;
    [SerializeField] private float rotationSpeed = 5f;
    [SerializeField] private float lookHeight = 1.5f;

    private void LateUpdate()
    {
        if (target == null)
        {
            return;
        }
        Vector3 desiredPosition = target.position + offset;
        transform.position = Vector3.Lerp(transform.position, desiredPosition, followSpeed * Time.deltaTime);

        Vector3 lookPoint = target.position + Vector3.up * lookHeight;
        Quaternion desiredRotation = Quaternion.LookRotation(lookPoint - transform.position);
        transform.rotation = Quaternion.Slerp(transform.rotation, desiredRotation, rotationSpeed * Time.deltaTime);
    }
}

解説

• 位置の追従処理（Vector3.Lerp）

Vector3 desiredPosition = target.position + offset;
transform.position = Vector3.Lerp(transform.position, desiredPosition, followSpeed * Time.deltaTime);

まずtarget.position + offsetで、「カメラが本来いるべき理想の位置（desiredPosition）」を計算します。

offsetは(0, 3.2, -7)のように、キャラクターから見て「上に3.2、後ろに7」といった相対位置を指定するベクトルです。

次にVector3.Lerp(現在位置, 理想位置, 割合)で、現在のカメラ位置から理想位置へ少しずつ近づけます。第3引数のfollowSpeed * Time.deltaTimeが「1フレームでどれだけ理想位置に近づくか」の割合です。

Time.deltaTimeを掛けることで、フレームレートが変わっても同じ速度で追従するようになります。

Vector3.Lerpは2点間を直線的に補間する関数なので、位置の移動には自然にマッチします。
これが、いきなりtransform.position = desiredPositionと代入せず、Lerpを使う理由です。

• 注視点の回転処理（Quaternion.Slerp）

Vector3 lookPoint = target.position + Vector3.up * lookHeight;
Quaternion desiredRotation = Quaternion.LookRotation(lookPoint - transform.position);
transform.rotation = Quaternion.Slerp(transform.rotation, desiredRotation, rotationSpeed * Time.deltaTime);

回転の処理も基本的な流れは位置と同じで、「理想の回転（desiredRotation）」を計算してから、現在の回転を少しずつ近づけます。

ただし、回転を補間する際はVector3.LerpではなくQuaternion.Slerp（球面線形補間）を使う点に注意してください。

回転は「角度」という性質上、直線的な補間（Lerp）をそのまま当てはめると、回転速度にムラが出たり、経由地点でおかしな姿勢を取ったりすることがあります。

Quaternion.Slerpは球面上を一定の角速度で補間するため、回転が常に自然な速さで進みます。位置はLerp、回転はSlerpという使い分けは、Unityのカメラ制御において基本となる考え方です。

【Unity】Vectorを使ったイージング、アニメーション動作

Vector2を使ったスクリプトでアニメーションを作成します。RectTransformで座標を決めて、線形補間「Leap」を実行します。本記事では、マウスのポインターの位置でアニメーションを稼働させるソースコードを公開・解説しています。

alicia-ing.com

2025.08.11

• LookRotationで注視点を計算する仕組み

Quaternion.LookRotation(方向ベクトル)は、指定した方向を向く回転（Quaternion）を返す関数です。

ここでは、lookPoint – transform.position（カメラから注視点への方向ベクトル）を渡すことで、「カメラから見て、注視点の方向を向いた回転」を計算しています。

lookPointはtarget.position + Vector3.up * lookHeight、つまりキャラクターの位置から少し上にずらした点です。

キャラクターの足元をそのまま注視点にすると、カメラが常に下向きになり圧迫感のある画になってしまうため、lookHeightで見上げるような角度にならないよう調整しています。

• LateUpdateを使う理由

このスクリプトでは、UpdateではなくLateUpdateを使っています。これは三人称カメラの実装において非常に重要なポイントです。

Unityでは、シーン内の複数のUpdateがどの順番で実行されるかは保証されていません。もしキャラクターの移動処理と、カメラの追従処理が両方ともUpdateに書かれていた場合、カメラのUpdateがキャラクターのUpdateより先に実行されてしまうことがあります。

それにより、カメラは「1フレーム前のキャラクター位置」を基準に追従することになり、映像がカクつく原因になります。

LateUpdateは、シーン内のすべてのUpdateが終わった後に必ず呼ばれることが保証されています。そのため、キャラクターの移動処理が確実に終わった後の最新位置を使ってカメラを更新でき、カクつきのない滑らかな追従が実現できます。

カメラ制御では「移動処理はUpdate、カメラ追従はLateUpdate」という役割分担を徹底しましょう。

実装

シーン上に独立して配置したカメラオブジェクトにアタッチします。

offset・followSpeed・rotationSpeed・lookHeightはデフォルト値のままでも動作しますが、キャラクターのモデルサイズやゲームのジャンルに応じて調整が必要になることがほとんどです。

値の目安は次の「パラメータ調整ガイド」を参照してください。

パラメータ調整ガイド

スクリプトには4つの調整用パラメータがあります。それぞれの値を変えたときに、どのような体感の変化があるかをまとめました。

【Unity】スライダーを特定の位置にスナップ（吸着）させる方法

UnityのSliderに任意の位置へのスナップ（吸着）機能を実装する方法を解説。IPointerUpHandlerとonValueChangedを組み合わせ、snapPointsとsnapThresholdで吸着位置・距離を自由に設定できます。

alicia-ing.com

2026.06.18

followSpeed（追従の重さ）

followSpeedは、カメラがキャラクターの理想位置にどれだけ速く近づくかを決める値です。値が大きいほど追従が速く（キャラクターに張り付くような動き）、値が小さいほど追従が遅く（ワンテンポ遅れてついてくる、重厚感のある動き）なります。

目安として、アクション性の高いゲームではfollowSpeed = 8〜10程度、じっくり見せたい探索系のゲームではfollowSpeed = 3〜5程度から調整を始めるとよいでしょう。

極端に小さくしすぎると、キャラクターが素早く動いたときにカメラが置いていかれ、画面外にキャラクターが消えてしまうことがあるので注意してください。

rotationSpeed（回転の追従感）

rotationSpeedは、カメラの向きが理想の回転にどれだけ速く追いつくかを決める値です。この値がfollowSpeedと極端に違うと、後述する「不自然な動き」の原因になりやすいため、基本的にはfollowSpeedと近い値からスタートするのがおすすめです。

lookHeight（注視点の高さ）

lookHeightは、カメラがキャラクターのどの高さを見つめるかを決める値です。キャラクターの頭上あたり（1.5前後）に設定すると自然な見下ろし角度になり、値を大きくしすぎるとカメラが必要以上に見下ろす形になります。

逆に0に近づけると、キャラクターの足元付近を注視点にすることになり、水平に近い圧迫感のある画角になります。

offset（カメラ距離・画角）

offsetはキャラクターから見たカメラの相対位置で、(左右, 上下, 前後)のベクトルで指定します。Y成分を大きくするとカメラの高さが上がり、Z成分（マイナス方向）を大きくするとキャラクターとの距離が離れて引きの画になります。

壁際でカメラがめり込まないようにする「衝突回避」は本記事のスコープ外としていますが、offsetの距離を調整するだけでも、狭い通路でのめり込みはある程度軽減できます。

まとめ

本記事では、Unityで三人称カメラの追従処理を実装する方法を解説しました。

• 位置の追従にはVector3.Lerp、回転の追従にはQuaternion.Slerpを使う（直線補間と球面補間の使い分け）
• Quaternion.LookRotationで注視点への方向を計算し、lookHeightで見上げ角度を調整する
• カメラの更新処理はUpdateではなくLateUpdateに書き、実行順序によるカクつきを防ぐ
• followSpeedとrotationSpeedは近い値に揃えることで、首振りのような不自然な動きを防げる

まずは本記事のパラメータの目安値から始めて、実際にゲームを動かしながらfollowSpeed・rotationSpeed・lookHeight・offsetの4つを少しずつ調整し、自分のゲームに合った「気持ちいい」カメラワークを探ってみてください。

壁のめり込み対策やCinemachineの活用など、さらに踏み込んだカメラ制御は次のステップとして挑戦してみるとよいでしょう。

Rigidbody＋CapsuleColliderだけでカメラ相対移動・回転・落下リスポーンに対応した3Dプレイヤー移動処理を実装できます。

Unityでキャラクター移動を実装する際、CharacterControllerが使われます。他の物理オブジェクトと自然に衝突させたい、坂道や段差の挙動を物理演算に任せたいといった場面では、CharacterControllerだと限界を感じることがあります。

本記事では、Rigidbody＋CapsuleColliderへの移動処理を、カメラ相対移動・回転処理・落下時のリスポーンまで含めて解説します。unity rigidbody 移動の実装で「Transformによるめり込み」や「カメラのカクつき」に悩んでいる人にも役立つ内容です。

CapsuleCollider

まず、プレイヤーの当たり判定に使うCapsuleCollider（カプセルコライダー）について説明します。

CapsuleColliderは、上下に半球が付いた円柱状の当たり判定です。人型キャラクターの当たり判定としてよく使われており、実はCharacterControllerも内部的にはカプセル形状の判定を使っています。

【Unity】Blenderで作った3Dモデルをインポートする

UnityでBlenderで作成した3Dモデルをインポートする方法を紹介します。FBXファイルやOBJ形式のimport、Unity内でのモデルアニメーションの読み込みなどを解説しています。

alicia-ing.com

2025.08.11

Hierarchyでプレイヤーのオブジェクトを選択し、InspectorのAdd ComponentからPhysics > Capsule Colliderを追加すると導入できます。

Rigidbody

Rigidbodyは、オブジェクトに物理演算（重力・衝突・力の伝達など）を適用するためのコンポーネントです。Add ComponentからPhysics > Rigidbodyを追加すると、そのオブジェクトはUnityの物理エンジンの管理下に置かれます。

今回紹介するPlayerMove.csのAwake()で設定している値を例に、代表的な設定項目を紹介します。

Rigidbodyのメリット

• 他のRigidbodyを持つオブジェクトと自然に衝突・押し合いができる
• 坂道や段差の挙動を物理演算にまかせられるため、個別にコードで実装しなくて済む
• velocity（速度）やAddForce（力）を使った移動ができ、慣性のある自然な動きを表現しやすい
• 動く床・爆風による吹き飛ばしなど、他の物理システムと組み合わせやすい

Rigidbodyが向かないケース

• ジャンプの高さや着地位置をフレーム単位で厳密に制御したいシビアなアクションゲーム
• ネットワーク対戦などで移動の再現性（決定論的な挙動）が必須な場合
• 物理演算特有の揺れ・めり込みを避けたい、シンプルな一方向移動のみのケース

こうしたケースでは、無理にRigidbodyへ移行せずCharacterControllerを使うほうが扱いやすいです。移行はあくまで手段であり、目的ではないことに注意してください。

CharacterControllerとRigidbody＋CapsuleColliderの違い

CharacterController rigidbody 違いで検索している人向けに、両者の特徴を比較します。

要するに、CharacterControllerは「移動処理に特化した専用コンポーネント」、Rigidbodyは「物理演算そのものを使って移動も実現するコンポーネント」という違いです。

なぜCharacterControllerではなくRigidbodyにする理由

CharacterControllerからRigidbodyへの移行を検討すべき代表的な判断基準は次の通りです。

• 動く床・押せるオブジェクトなど、他の物理オブジェクトとキャラクターを相互作用させたい
• 坂道・段差の挙動を、個別のコードではなく物理演算にまかせたい
• 爆風で吹き飛ばす、掴まれて引っ張られるなど、外力による移動を扱いたい
• ジャンプや落下の挙動を、他のコンポーネント（例：ジャンプ専用コンポーネント）とY軸だけ分担するような設計にしたい

逆に、移動の精密な制御を最優先するアクションゲームでは、CharacterControllerのままのほうが扱いやすい場合もあります。unity charactercontroller rigidbody 移行を検討するときは、プロジェクトで物理的な相互作用がどれだけ必要かを基準に判断してください。

3Dキャラクターの移動処理

本記事では、ここまで説明したRigidbodyとCapsuleColliderを組み合わせて、CharacterControllerを使わない3Dキャラクターの移動処理を実装します。単に位置を動かすだけでなく、以下の3つの動きを備えた、実践で使えるレベルのプレイヤーコントローラーを目指します。

• カメラ相対移動： カメラが向いている方向を基準に、入力方向を変換して移動する
• 移動方向への回転： キャラクターが移動している方向へ滑らかに向きを変える
• 落下時の自動リスポーン： マップの外や穴に落下した場合に、指定した位置へ自動的に戻す

これらはすべて、RigidbodyのFixedUpdate内での速度・回転操作として実装します。

ソースコード

using UnityEngine;

[RequireComponent(typeof(Rigidbody), typeof(PlayerInputHandler))]
public class PlayerMove : MonoBehaviour
{
    [SerializeField] private Transform cameraTransform;
    [SerializeField] private float moveSpeed = 4f;
    [SerializeField] private float rotationSpeed = 10f;
    [SerializeField] private float fallResetY = -50f;
    [SerializeField] private Vector3 respawnPosition = Vector3.zero;

    private Rigidbody rb;
    private PlayerInputHandler input;
    private Animator animator;

    private Vector3 moveDirection;
    private bool isMoving;

    private void Awake()
    {
        rb = GetComponent<Rigidbody>();
        input = GetComponent<PlayerInputHandler>();
        animator = GetComponentInChildren<Animator>();

        rb.useGravity = true;
        rb.interpolation = RigidbodyInterpolation.Interpolate;
        rb.collisionDetectionMode = CollisionDetectionMode.ContinuousDynamic;
        rb.constraints = RigidbodyConstraints.FreezeRotationX | RigidbodyConstraints.FreezeRotationZ;

        if (cameraTransform == null && Camera.main != null)
        {
            cameraTransform = Camera.main.transform;
        }
    }

    private void Update()
    {
        if (rb.position.y < fallResetY)
        {
            Respawn();
            return;
        }

        moveDirection = CameraRelativeDirection(input.MoveInput);
        isMoving = moveDirection.sqrMagnitude > 0.0001f;

        animator.speed = isMoving ? 1f : 0f;
    }

    private void FixedUpdate()
    {
        if (isMoving)
        {
            Quaternion targetRotation = Quaternion.LookRotation(moveDirection);
            rb.MoveRotation(Quaternion.Slerp(rb.rotation, targetRotation, rotationSpeed * Time.fixedDeltaTime));
        }

        Vector3 horizontalVelocity = moveDirection.normalized * moveSpeed;
        Vector3 velocity = rb.linearVelocity;
        velocity.x = horizontalVelocity.x;
        velocity.z = horizontalVelocity.z;
        rb.linearVelocity = velocity;
    }

    private Vector3 CameraRelativeDirection(Vector2 moveInput)
    {
        if (cameraTransform == null || moveInput.sqrMagnitude < 0.0001f)
        {
            return Vector3.zero;
        }

        Vector3 forward = cameraTransform.forward;
        forward.y = 0f;
        forward.Normalize();

        Vector3 right = cameraTransform.right;
        right.y = 0f;
        right.Normalize();

        return forward * moveInput.y + right * moveInput.x;
    }

    private void Respawn()
    {
        rb.linearVelocity = Vector3.zero;
        rb.angularVelocity = Vector3.zero;
        rb.position = respawnPosition;
        transform.position = respawnPosition;
    }
}

解説

• カメラ相対移動の仕組み

Vector3 forward = cameraTransform.forward;
forward.y = 0f;
forward.Normalize();

Vector3 right = cameraTransform.right;
right.y = 0f;
right.Normalize();

return forward * moveInput.y + right * moveInput.x;

カメラのforward（前方向）・right（右方向）ベクトルをそのまま使うと、カメラが下や上を向いているときにY成分が混ざってしまい、キャラクターが浮いたり沈んだりする移動方向になってしまいます。

そこで、forward.y = 0f・right.y = 0fとしてY成分を打ち消し、XZ平面（水平面）に投影してからNormalize()で正規化しています。こうすることで、カメラがどの角度を向いていても、キャラクターは常に水平方向にのみ移動します。

最後に、入力値moveInput.x（左右）・moveInput.y（前後）をそれぞれright・forwardに掛けて合成することで、「カメラの向きを基準にした移動方向」が完成します。この処理を扱った解説記事は少なく、三人称視点のゲームでスティック入力をそのままワールド座標として使ってしまい、カメラを回すと操作方向がズレるという不具合の原因にもなりやすいポイントです。

• FixedUpdateでの速度制御とY軸の分担設計

移動処理はFixedUpdate()の中で行っています。Unityの物理演算はFixedUpdateのタイミングで実行されるため、RigidbodyのvelocityやMovePositionを操作する処理は必ずFixedUpdateに書く必要があります。Updateで操作すると、フレームレートによって物理演算とのタイミングがズレて挙動が不安定になります。

Vector3 horizontalVelocity = moveDirection.normalized * moveSpeed;
Vector3 velocity = rb.linearVelocity;
velocity.x = horizontalVelocity.x;
velocity.z = horizontalVelocity.z;
rb.linearVelocity = velocity;

ここで注目したいのは、velocity.xとvelocity.zだけを書き換えて、velocity.yにはあえて触れていない点です。rb.linearVelocity（旧velocity）を丸ごと上書きしてしまうと、ジャンプや落下によるY方向の速度まで毎フレーム0にリセットされ、ジャンプ処理と競合してしまいます。

コード内のコメントにもある通り、PlayerMoveはX/Z軸（水平方向の移動）だけを担当し、Y軸（ジャンプ・落下）は別のコンポーネントに委ねる設計にしています。この役割分担により、PlayerMoveと別のジャンプ用コンポーネントのどちらが先にFixedUpdateで実行されても、お互いの担当軸を上書きし合わない安全な作りになります。AddForceではなくvelocityを直接操作しているのも、この分担を明確に保つためです。

• 移動方向への回転処理

Quaternion targetRotation = Quaternion.LookRotation(moveDirection);
rb.MoveRotation(Quaternion.Slerp(rb.rotation, targetRotation, rotationSpeed * Time.fixedDeltaTime));

キャラクターを移動方向へ滑らかに回転させる処理です。Quaternion.LookRotation(moveDirection)で「移動方向を向くための目標の回転」を求め、Quaternion.Slerpで現在の回転から目標の回転へ少しずつ補間しています。

ポイントは、transform.rotationを直接書き換えるのではなくrb.MoveRotation()を使っている点です。RigidbodyがアタッチされたオブジェクトをTransform経由で直接動かすと、物理演算のスレッドと描画のタイミングがズレて衝突判定が不安定になります。回転も移動と同様に、Rigidbody用のAPIを通して行うのが基本です。

• 落下時のリスポーン処理

private void Update()
{
    if (rb.position.y < fallResetY)
    {
        Respawn();
        return;
    }
    ...
}

private void Respawn()
{
    rb.linearVelocity = Vector3.zero;
    rb.angularVelocity = Vector3.zero;
    rb.position = respawnPosition;
    transform.position = respawnPosition;
}

マップの外や穴に落下してしまった場合に備えて、Y座標がfallResetYを下回ったら自動的にリスポーンする処理です。ジャンプ台の位置調整ミスやコライダーの隙間から落下してしまうことは実際の開発でもよく起きるため、あらかじめ用意しておくと安心です。

Respawn()では、位置をリセットするだけでなくlinearVelocity（速度）とangularVelocity（角速度）も必ずゼロに戻しています。速度をリセットせずに位置だけ戻すと、落下中に蓄積した速度がそのまま残り、リスポーン直後に想定外の方向へ吹き飛んでしまうため注意してください。

実演

3DモデルにPlayerMove.csをアタッチします。

この3DモデルはCapsuleColliderを追加してください。
アタッチした後に実行するとで冒頭で紹介した動作を実行できます。

よくあるハマりどころと対策

• Transform移動によるめり込み

Rigidbodyが付いたオブジェクトをtransform.position += …のように直接移動させると、物理演算とタイミングがズレて壁や地面にめり込んでしまうことがあります。これはunity rigidbody transform 移動でよく報告される不具合です。

本記事のコードのように、移動はFixedUpdate内でrb.linearVelocityまたはrb.MovePosition()を使って行います。Transformを直接書き換える処理を移動ロジックに混在させないことが重要です。

• カメラのカクつき

Rigidbodyの位置はFixedUpdate（物理演算のタイミング）で更新されますが、カメラの描画はUpdate（描画のタイミング）で行われます。この2つのタイミングにはズレがあるため、追従カメラがカクついて見えることがあります。

Awake()で設定しているrb.interpolation = RigidbodyInterpolation.Interpolate;が、このズレを補間して滑らかに見せる役割を持っています。加えて、追従カメラ側のスクリプトもUpdateではなくLateUpdateでプレイヤーを追従させることで、キャラクターの移動が反映された後にカメラが追従するようになり、カクつきをさらに抑えられます。

まとめ

CharacterControllerからRigidbody＋CapsuleColliderへの移動処理の移行手順として、以下を解説しました。

• CapsuleColliderとRigidbodyの基本的な役割と設定値
• CharacterControllerとの違いと、移行すべきかどうかの判断基準
• カメラ相対移動・FixedUpdateでのX/Z軸のみの速度制御・回転処理・落下リスポーンの実装
• Rigidbodyへの移行は、他の物理オブジェクトとの相互作用が必要になったときに大きな効果を発揮します。一方で、精密な移動制御が最優先の場合は無理に移行する必要はありません。プロジェクトの要件に合わせて、CharacterControllerとRigidbodyを使い分けてください。

次のステップとして、Y軸を分担しているジャンプ処理や、カメラ相対移動と組み合わせる三人称カメラの実装もあわせて検討してみると、より完成度の高いプレイヤー操作を作り込めます。

Unityのスライダーを、指定した任意の位置に自動で吸着（スナップ）させる

音量調整や設定画面のスライダーで、「キリのいい値にぴったり合わせたい」と感じたことはありませんか？そのような場面で役立つのがスナップ（吸着）機能です。特定の値に近づくと自動で吸い付くため、ユーザーが意図した値に合わせやすくなります。

本記事では、スナップさせたい位置と吸着距離を自由に設定できる実装方法を解説します。

Sliderのスナップとは？

スナップとは、ある値に近づいたときに自動でその値に吸い付く動作のことです。

Unityの標準Sliderコンポーネントにはスナップ機能が搭載されていません。スライダーをドラッグすると連続した値が取れるだけで、特定の値に吸着させるにはスクリプトで制御する必要があります。

Sliderの準備

UnityのHierarchyウィンドウからUI > Slider を追加してください。

【Unity】スライダー使い方｜制限時間ゲージ、HPバー、音量調整

Unityのスライダー（Slider）でHPバー・制限時間ゲージ・音量調整を作る方法を解説。Min Value・Max Valueの設定、HPバーをなめらかに減らすスクリプト、離したとき・押したときの処理まで紹介します。

alicia-ing.com

2026.10.12

また、スナップした値をテキストで表示するため、UI > Text – TextMeshPro も追加します。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

ソースコード

using UnityEngine;
using UnityEngine.UI;
using UnityEngine.EventSystems;
using TMPro;

public class SliderSnap : MonoBehaviour, IPointerUpHandler
{
    public Slider slider;
    public TextMeshProUGUI positionTMP;

    [Header("スナップ設定")]
    public float[] snapPoints = new float[] { 0.5f, 0.2f }; // 正規化値(0~1)
    public float snapThreshold = 0.02f;

    void Start()
    {
        slider.onValueChanged.AddListener(OnValueChanged);
        UpdatePositionDisplay();
    }

    void OnDestroy()
    {
        slider.onValueChanged.RemoveListener(OnValueChanged);
    }

    void OnValueChanged(float value)
    {
        float snapped;
        if (TryGetSnapPoint(value, out snapped))
        {
            slider.onValueChanged.RemoveListener(OnValueChanged);
            slider.value = snapped;
            slider.onValueChanged.AddListener(OnValueChanged);
        }

        UpdatePositionDisplay();
    }

    public void OnPointerUp(PointerEventData eventData)
    {
        float snapped;
        if (!TryGetSnapPoint(slider.value, out snapped)) return;

        slider.onValueChanged.RemoveListener(OnValueChanged);
        slider.value = snapped;
        slider.onValueChanged.AddListener(OnValueChanged);

        UpdatePositionDisplay();
    }

    bool TryGetSnapPoint(float value, out float snapped)
    {
        snapped = value;
        if (snapPoints == null || snapPoints.Length == 0) return false;

        float minDist = float.MaxValue;
        float nearest = value;

        foreach (float point in snapPoints)
        {
            float dist = Mathf.Abs(value - point);
            if (dist < minDist)
            {
                minDist = dist;
                nearest = point;
            }
        }

        if (minDist < snapThreshold)
        {
            snapped = nearest;
            return true;
        }
        return false;
    }

    public string GetPositionText(float value)
    {
        float rounded = Mathf.Round(value * 100f) / 100f;
        return rounded.ToString("0.##");
    }

    void UpdatePositionDisplay()
    {
        if (positionTMP == null) return;
        positionTMP.text = GetPositionText(slider.value);
    }
}

解説

• snapPoints と snapThreshold

snapPointsは、スナップさせたい位置を正規化値（0〜1）で指定する配列です。Sliderの最小値が0、最大値が1に対応します。例えば 0.5fはスライダーの中央、0.2fは左から20%の位置になります。

snapThresholdは吸着距離です。スライダーの値がスナップポイントからこの値以内に入ると、自動でスナップします。0.02fは全体の2%の範囲です。値を大きくするほど遠くからでも吸着するようになります。

どちらもInspectorから変更できるので、スクリプトを書き直さずに調整できます。

• OnValueChanged でのスナップ処理

ドラッグ中にスナップポイントへ近づいたとき、リアルタイムで吸着させる処理です。

• IPointerUpHandler でのスナップ処理

IPointerUpHandlerのOnPointerUpは、マウスボタンやタッチを離した瞬間に呼ばれます。

ドラッグを離した瞬間にもスナップ処理を走らせることで、「ドラッグ中はスナップしなかったが、離したときにスナップポイントの近くにいた」というケースも確実に吸着できます。OnValueChangedとの二重対応で、取りこぼしなくスナップが動作します。

IPointerUpHandlerを使うためには、クラス宣言に IPointerUpHandlerを追加し、スクリプトをスライダーと同じGameObjectにアタッチする必要があります。

• TryGetSnapPoint メソッド

スナップすべきかどうかを判定するメソッドです。out引数でスナップ先の値を返します。

処理の流れは以下の通りです。

1. すべてのsnapPointsとの距離を計算する
2. 最も近いポイントを探す
3. その距離がsnapThreshold未満であればスナップ対象と判定しtrueを返す
4. 閾値以上であれば何もせずfalseを返す

複数のスナップポイントがあっても、常に最も近い1点に吸着します。

• TextMeshPro での値表示

現在のスライダー値をTextMeshProのテキストに表示します。Mathf.Round で小数点2桁に丸めてから “0.##”フォーマットで表示しています。”0.##” は末尾の不要なゼロを省略してくれるので、0.50ではなく 0.5のようにすっきり表示されます。

positionTMPがnullの場合は何もしないようにしているので、テキスト表示が不要な場合はアタッチしなくても動作します。

実演

スクリプトができたら、Inspectorで以下の通り設定してください。

まとめ

Unityのスライダーに任意の位置へのスナップ機能を実装しました。

• snapPoints（float配列）でスナップ位置を自由に指定できます
• snapThresholdで吸着距離を調整できます
• onValueChangedと IPointerUpHandlerを併用することで、ドラッグ中・離した瞬間どちらにも対応できます
• – リスナーの二重発火を防ぐため、値変更前後で RemoveListener → AddListenerの順で処理します

音量調整や設定画面など、特定の値に合わせやすくしたいスライダーUIに活用してみてください。

Unityのビルドとは？

Unityにおける「ビルド」とは、開発中のゲームプロジェクトを実行可能なアプリケーションやデータに変換する作業のことです。エディタ上で動かしていたゲームを、Windows/Mac用の実行ファイルやWebブラウザで動作するデータ（WebGL）などに出力し、他のユーザーがプレイできる形にします。

Unityエディタでの再生は開発者ローカルのテストに過ぎず、完成したゲームを配布・公開するにはビルドして所定のプラットフォーム用ファイルを用意する必要があります。ビルドを行うことで、初めてUnityをインストールしていないPCでもゲームを起動できたり、Web上に公開して遊んでもらうことが可能になります。

ビルドの結果、例えばWindowsなら「.exe実行ファイルとデータフォルダ」、WebGLなら「index.htmlとUnityの生成したライブラリファイル群」など、プラットフォームごとに必要なファイル一式が出力されます。これらを配布・サーバーアップロードすることでユーザーがゲームをプレイできるようになります。

Unityでゲームをビルドする基本手順

基本的なビルド手順は「シーンの設定 → プラットフォームの選択 → ビルドの実行」という流れになります。

>>公式ページのビルド方法

シーン登録

初めにビルドに含めるシーンを指定します。Unityメニューから File > Build Profiles を開き、Scenes Listに現在のシーンを追加します（「Open Scene List」>「Add Open Scenes」ボタン）。複数シーンがある場合、すべて追加しましょう。

ボタンを押しても何も反応がない場合は、シーンが読み込めていません。
そこで、現在のシーンを変更してから「Add Open Scenes」ボタンを押すと認識できます。

シーンリスト番号「0」が、ゲーム起動時に最初にロードされるシーンになります。一般的にタイトルやメインメニューのシーンを先頭に置きます。ドラッグ＆ドロップで順序を並び替え、一番最初に実行したいシーンがトップに来るよう設定します。

チェックボックスでビルド対象に含めるか除外するかを制御できます。不要なシーンはチェックを外すことでビルドから除外可能ですが、基本的にはリストに追加したシーンはすべて有効にしておきます。Scene移動はスクリプトで制御しないと遷移できないですが、チェックボックスで除外しておく方が無難です。

【Unity】シーン切り替え演出｜フェイドイン・アウト

Unityのシーン切り替え演出の１つにフェイドイン・フェイドアウトがあります。シーン遷移は突然してしまうためフェイドを使い滑らかにすることでユーザビリティ―が向上します。本記事では、ボタンを押してフェイド演出を詳しく解説しています。

alicia-ing.com

2025.04.29

プラットフォームの選択

ビルド設定ウィンドウを開きます（ショートカット: Ctrl+Shift+B）。ここでプロジェクトのビルド対象プラットフォームを設定できます。

左側カラムのPlatformsからビルドしたいターゲットプラットフォームを選びます（ PC向けなら「Windows, MacOS, Linux」、Webブラウザ向けなら「WebGL」、スマホアプリなら「iOS、Android」など）。選択すると右下にビルド対象として表示され、現在のプラットフォームでない場合は「Switch Platform」ボタンが有効になります。

ビルド対象を選んだら、Switch Platformボタンをクリックしてプラットフォームを切り替えます。プラットフォーム切り替え時には必要なライブラリのインポート処理が走るため、完了するまで待ちましょう。切り替え後、選択したプラットフォーム名の右に「(Active)」と表示されます。

ビルドの実行

ビルド前に、必要に応じて右下のDevelopment Build（開発ビルド）やCompression Method（圧縮方式）などのオプションをチェックできます。開発ビルドにチェックを入れるとデバッグ情報付きでビルドされ、パフォーマンスは落ちますがデバッグに有用です。初学者の場合、基本はチェック不要で構いません。

著者の体験談

項目が多すぎるので、基本そのままでOK

ビルドには、Build か Build and Runどちらかを押すと処理されます。「Build」ボタンを押すとビルド処理が始まります（完了後、出力先フォルダを開いて自分で実行ファイルを起動）。「Build and Run」を押すとビルド完了後に自動的にアプリケーション（またはエミュレータ）が起動し、実行結果をすぐ確認できます。開発中はBuild and Runが便利です。

ビルド中はUnityエディタ下部の進行バーに進捗メッセージが表示されます。スクリプトのコンパイルやシーンのデータ書き出しなど、多少時間がかかる場合がありますが完了まで待ちましょう。Consoleウィンドウにエラーが出た場合、ビルドは失敗しています。

ビルドが成功すると、指定したフォルダ内に出力物が生成されます。Windowsは実行ファイル（.exe 等）とDataフォルダ、WebGLの場合はBuildフォルダとindex.html、Androidの場合はAPKファイル等ができています。それらを実行・配置することで実際にゲームが動作するか確認できます。

出品に向けた設定

いざ、ゲームをビルドしてもタイトルがそのままだったり、よくわからないファイルが同封されているなど問題だらけです。また、ゲーム作りはプロでも１年以上は費やして完成をさせます。しかし出品の際に、スクリプトなどを保護をしないと購入者に解析されてしまうことがあります。（逆コンパイル）

このように、個人情報や作品の保護などより質の高いビルドについて解説をします。まずは、Edit >ProjectSettingを開きます（ビルド設定ウィンドウのPlayerSettingからでもOKです。）。

Playerをいじれば基本的なゲーム設定は可能です。「Resolution and Presentation」は画面サイズや比率の設定は後述します。

名前変更

ゲームの主要情報はここで変えることができます。ここはユーザーが見えるところなのでしっかりと変更することが重要です。

• Company Name：会社名（セーブデータ格納とかでフォルダー名になる）
• Product Name：ゲーム名（ゲームファイルの名前になる）
• Verson：バージョン（1.2.3という命名がおすすめ。【ゲーム性】.【機能追加】.【バグ修正】）
• Default Icon：実行ファイルのアイコン。未設定ではUnityのロゴ
• Default Cursor：マウスカーソルの見た目変更。
• Default Hotspot：カーソルの位置、基本的にデフォルトでOK(x,y)=(0,0)

Splash Image（ゲーム開始時の企業ロゴ）

ゲームを開始するときに企業ロゴや注意事項などが出てくる作品がありますが、Unityでも再現ができます。基本初期のままで構いませんが、いくつか変更すると良いところがありますので私が良くする設定で紹介します。

• Splash Screen>Animation：Custom（ロゴのズームをしないように設定）
• Logos>Show Unity Logo：なし（Unityのロゴを非表示。Unity6から無料版でもチェックを外せるように！）

Splash StyleやBackground Colorなどはそれぞれのロゴに適したものを使うと良いでしょう。

Other Settings

その他なのに最も項目が多くてめんどくさいので、変えないといけない箇所だけ紹介します。

• Configuration>Scripting Backend：IL2CPP（スクリプト等の保護。MONOだと逆コンパイルでデータが盗まれる）

その他にも、使っていないスクリプトを削除して軽くする機能もありますが、予期せぬバグになるので省略します。

フォルダーの削除

ビルドを終えると、基本的に削除してはいけないファイルばかりですが、「BurstDebugInformation_DoNotShip」というフォルダーは削除しなければいけません。フォルダーの中身は、ビルド情報が載りますが、よく見ると自分のPC情報が記載されています。

Library: C:\Users\【username】\Desktop\UnityProject\Tile_RPG\Temp\BurstOutput\Data\Plugins\x86_64\lib_burst_generated
–platform=Windows
–backend=burst-llvm-18

Tile_RPG_BurstDebugInformation_DoNotShip/lib_burst_generated.txt

画面サイズと解像度の設定

PC向け（Standalone）ビルドでは、デフォルト設定のままだとゲーム起動時にディスプレイ全画面で表示されます。古いUnityでは起動時に解像度選択ダイアログが表示されることもありましたが、2020年以降のUnityでは初期挙動が自動でフルスクリーンとなる場合が多いです。

必要に応じて、ビルドされたゲームの画面モードや解像度を指定しましょう。

Unityエディタ上部メニューから Edit > Project Settingsを開き、左メニューから Player を選択します。その中の対象プラットフォームのResolution and Presentation セクションを展開してください。ここで画面モードや初期解像度に関する設定を変更できます。

Fullscreen Mode という設定項目があります。デフォルトでは「Fullscreen Window（全画面表示ウィンドウ）」もしくは「Exclusive Fullscreen（専用全画面）」になっています。これを 「Windowed（ウィンドウ表示）」 に変更すると、ビルド後のゲームがウィンドウモードで起動するようになります。フルスクリーンだと起動時にモニタ解像度で全面表示されますが、Windowedにすることでウィンドウ枠のある通常のウィンドウになります。

Default Screen Width（デフォルト幅）、Default Screen Height（デフォルト高さ）という項目で、ウィンドウモード時の初期画面サイズ（解像度）を指定できます。ただしこれらは Fullscreen Modeを「Windowed」にした場合のみ有効です。（フルスクリーン時はモニタ解像度に依存）。例えば幅1920×高さ1080にしたければ、それぞれ1920、1080と設定します。

Resizable Window オプションを true にすると、ユーザーがウィンドウの端をドラッグして自由にリサイズできるようになります。固定サイズで遊ばせたい場合は false に設定し、ウィンドウサイズ変更を禁止します。リサイズを許可する場合、画面比率が変わってUI配置が崩れないようCanvasの設定（UIのScale ModeやReference Resolution）にも注意が必要なので、許可しないことをおすすめします。

著者が実際にしている画面サイズ設定

私の設定では、FullScreenとWindowedモードのハイブリットにしています。

• Fulscreen Mode：Windowed
• Default Screen :幅1280×高さ720

このサイズにしておけば、ほとんどのユーザーのPCに納まるかと思います。

また、以下のスクリプトをゲームのタイトル画面に設置してフルスクリーンとウィンドウどちらにも対応できるようにしています。

    // ウィンドウモードに戻すときのサイズ
    [SerializeField] private int windowWidth = 1280;
    [SerializeField] private int windowHeight = 720;

    // UIボタンから呼ぶ関数
    public void ToggleFullscreen()
    {
        if (Screen.fullScreen)
        {
            // フルスクリーン → ウィンドウモード
            Screen.SetResolution(windowWidth, windowHeight, FullScreenMode.Windowed);
            Debug.Log("Switched to Windowed Mode");
        }
        else
        {
            // ウィンドウモード → フルスクリーン
            Screen.SetResolution(Display.main.systemWidth, Display.main.systemHeight, FullScreenMode.FullScreenWindow);
            Debug.Log("Switched to Fullscreen Mode");
        }
    }

WebGLビルドの方法とポイント

WebGLプラットフォームを選択すると、UnityのゲームをWebブラウザ上で実行できる形でビルドできます。HTML5/WebGL対応ゲームのビルド手順と注意点を解説します。

WebGLでビルドするには、まずUnityにWebGLビルドサポートモジュールがインストールされている必要があります。Unity Hubのインストール項目から現在使用中のUnityバージョンに対し「WebGL Build Support」を追加インストールしてください（未導入の場合、Build SettingsでWebGLプラットフォームを選ぶ際に自動で「Install with Unity Hub」というボタンが表示されます）。

Build Settings ウィンドウで Platform を「WebGL」に選択し、「Switch Platform」で切り替えます。切り替え後、「WebGL」がActiveプラットフォームになったことを確認してください。

WebGLビルド用のPlayer Settingsも確認しておきましょう。たとえば「Publishing Settings」内の Compression Format（圧縮形式）はデフォルトでは Brotli 圧縮が使われます。互換性のためGzip圧縮に変更するケースもあります（Unity公式のUnity Playや一部サーバーではBrotli未対応の場合があるため）。また Memory Size（デフォルト256MB）などWebGL固有の設定項目もありますが、必要に応じて調整します。初回は特に変更せずとも動作しますが、ビルドサイズや読み込み速度の最適化に関わる部分なので、公開時には検討するとよいでしょう。

Build and Run を使うと、ビルド完了後に自動でブラウザが起動しローカルホストでホスティングされたゲームが開きます。Buildのみ実行した場合、出力されたフォルダ（デフォルトでは Build フォルダと Template データ）が生成され、その中のindex.htmlをブラウザで開いても直接は動作しません。WebGLビルドはセキュリティ上、ファイルシステムから直接読み込めないためです。必ずBuild and Runで確認するか、簡易なローカルHTTPサーバーを立ててホスティングしてください。

WebGLのビルド結果として、index.html ファイルと Buildフォルダ（中に .jsonや.wasm、.dataファイルなどが入っています）が生成されます。これら一式をWebサーバー上に配置すれば、ユーザーはブラウザでindex.htmlにアクセスするだけでゲームをプレイできます。UnityRoom（日本国内向けのUnityゲーム投稿サイト）や itch.io, GitHub Pages などにアップロードするのも簡単です。Unity公式の Unity Play や Game Server Hosting なども選択肢になります。

ビルドできない時のトラブルシューティング

ビルド実行中にエラーが発生し「Build failed」となってしまうことがあります。ここでは、「Unityでビルドができない！」となった場合によくある原因と解決策を紹介します。最終的にはエラー文をChatGPTや検索してみるとQiitaやNoteに公開しているユーザーが多いので、これらで解決しましょう。

最初にチェックすべきは、スクリプトのコンパイルエラーです。Unityではスクリプトにエラーがある状態だとビルドは実行できません。エディタ下部のConsoleウィンドウに赤いエラーメッセージが出ていないか確認し、出ている場合は内容に従ってコードを修正してください。典型的には文法ミス（セミコロンの付け忘れ等）や参照切れ、型の不一致などが原因です。コンパイルエラーはビルド以前にエディタ実行中から検知できますので、まずここをゼロにしましょう。

または、ビルド対象プラットフォームのモジュールが入っていない場合、ビルド自体が開始できません（ビルド設定でビルドボタンが押せない状態になる）。例えば「WebGL Module」や「Android Build Support」などがUnityに追加されているかを確認し、入っていなければUnity Hubからインストールします。モジュール不足が原因の場合、エラーメッセージで指摘されることもあります。「Module not loaded」「SDK not found」等のログが出たら該当モジュール/SDKの導入を行ってください。

まとめ

Unityにおけるビルド手順と設定、そしてトラブル発生時の対処法について網羅的に解説しました。

開発途中でもこまめにビルドを行う習慣を付けましょう。Unityエディタ上では正常に動いていても、ビルドすると初めて表面化する不具合は少なくありません。大きな機能追加や変更をした際はその都度ビルドして、予期せぬエラーが出ないか確認することで、後になってエラーの山に悩まされるリスクを減らせます。

バージョン管理とバックアップ: ビルド前後で問題が発生した際に備え、Git等のバージョン管理システムでプロジェクトの変更履歴を残しておくことをお勧めします。特にビルド直前に入れた変更が原因でエラーになった場合、直前のコミットに戻すことで原因の切り分けが容易になります。

ビルドエラーに直面した場合、公式マニュアルのトラブルシューティングやUnityフォーラム、Qiita記事などコミュニティの情報も積極的に参考にしましょう。特にエラーメッセージで検索すると同様のケースに遭遇した開発者の知見が見つかることが多いです。英語で検索するとフォーラムの回答がヒットする場合もあります。

ビルドが無事完了したら、実際に他のPCやデバイスで動作確認をします。画面サイズ設定や挙動が開発機と異ならないか、想定通りフルスクリーン/ウィンドウ表示になるか、WebGLなら複数のブラウザで正常動作するか、といった点をチェックしましょう。問題があれば再度Unity側の設定を調整しビルドし直します。

時間計測を行い、ゲーム終了後にタイマーを停止してシーン切り替えて結果を表示

Unityでゲームを作成する際、時間管理やタイマーの導入はゲームの面白さを左右する重要な要素です。特にアクションゲームやパズルゲームなどでは、時間制限を設けたり、経過時間を計測したりすることでゲームプレイに緊張感や達成感を与えられます。

本記事では、unityで時間管理するメソッドを紹介して、時間計測やタイマーをゲーム内に導入します。

Unityで時間計測とタイマー

Unityでのゲーム開発において、時間計測やタイマー機能は非常に重要な位置を占めます。

ゲーム内で時間制限を明確に設定することにより、プレイヤーに対して緊張感や達成感を生み出し、ゲームのテンポを一定に保つことができるためです。

例えば、クイズゲームでは制限時間を設けることで迅速な判断を促し、制限時間内に答えられなければ不正解とする。カードゲームではプレイヤーが一定時間内に行動をしなければ自動的にターンが次のプレイヤーへと移る仕組みを作ることで、円滑な進行を促します。

【Unity】４択クイズゲームの作り方-アセットなしで作成する

Unityで4択クイズを作成します。ゲーム内では、アニメーションやランダム、BGMを導入して質の高い作品を作ることができます。

alicia-ing.com

2024.10.24

さらに、RPGゲームではクリアタイムを競うタイムアタック要素を設けることで、プレイヤーのモチベーションを維持したり、競争心を高めたりできます。また、時間制限がプレイヤーに明確に示されることで、プレイヤーがより戦略的にゲームを進めたり、瞬時の判断力が求められたりするため、ゲームへの没入感や興奮度を高めることにも繋がります。

こうした様々な側面から、時間管理はゲーム制作において不可欠な要素となっています。

以下で、Unityの時間計測やタイマー機能を実装するために必要な具体的メソッドを詳しく見ていきます。

Time.time

Time.timeはUnityにおける基本的な時間計測のプロパティで、ゲームの開始時から現在までの経過時間を秒単位で取得できます。

初心者でも簡単に利用でき、主にシンプルな経過時間表示や簡単なタイマー機能の実装に使えます。

実際のコードでは次のように書きます。

void Update()
{
    float elapsedTime = Time.time;
    Debug.Log("経過時間: " + elapsedTime + "秒");
}

毎フレームごとに経過時間をログに表示しています。素早く実装可能です。

ただし、この方法はあくまでも基本的な時間計測に向いており、細かい制御には不向きな場合があります。

Time.deltaTime

Time.deltaTimeは前フレームからの経過時間を取得する方法であり、特に動きのあるゲームや毎フレーム更新されるタイマーの実装に適しています。

実際のコードでは次のように書きます。

private float timer = 0f;
void Update()
{
    timer += Time.deltaTime;
    Debug.Log("累計時間: " + timer + "秒");
}

このコードはフレームレートに依存しないため、異なる端末や環境でも均一な動きを提供できます。移動速度の制御やアニメーションの時間管理にも非常に有効です。

Time.timeとTime.deltaTimeの違いは？

コード例を見ると、両者に違いがなくTime.timeの方が短く記述できるので、Time.deltaTimeの意味がなさそうに見えるでしょう。

Time.timeはゲーム開始からずっと加算される絶対時間ベースの処理です。タイマー、経過時間判定などに使えますが、リセットをすることができないので色々と不便です。

一方Time.deltaTimeは、前のフレームから今まで何秒経ったか。移動・回転・アニメーションなどをフレーム依存なしで進めることが可能です。

なお、Time.timeScaleを0にしてゲームを一時停止すると、Time.timeもTime.deltaTimeも止まります。一時停止中も時間を進めたいときは、Time.unscaledTimeやTime.unscaledDeltaTimeを使います。

Stopwatch

StopwatchはUnityで高精度の時間計測（ミリ秒単位）が可能なクラスです。これは主にベンチマークテストや処理の最適化を目的とした精密な処理時間の測定に使われます。

実際のコードでは次のように書きます。

using UnityEngine;
using System.Diagnostics;
using Debug = UnityEngine.Debug;

Stopwatch stopwatch = new Stopwatch();
stopwatch.Start();
// 計測したい処理
stopwatch.Stop();
Debug.Log("処理時間: " + stopwatch.ElapsedMilliseconds + " ms");

特定処理にかかる正確な時間をミリ秒単位で取得でき、パフォーマンス改善に役立ちます。特徴として、名前空間で「System.Diagnostics」が必要です。ただしUnityEngineにもDebugがあるため、そのままだとどちらのDebugか決まらずエラーになります。「using Debug = UnityEngine.Debug;」を足して、Unity側のDebugを使うと指定します。

ミリ秒のタイマー

Unityでミリ秒単位の高精度タイマーを導入する場合、Stopwatchが最も推奨されます。
特にリアルタイム性を求めるゲームや、処理精度を要求されるシミュレーションなどで有効です。

Stopwatch timer = new Stopwatch();
timer.Start();
// 時間を測る処理
timer.Stop();
long milliseconds = timer.ElapsedMilliseconds;
Debug.Log("経過時間: " + milliseconds + " ms");

Stopwatchは現実の時間で動くので、Time.timeScaleを0にして一時停止しても止まりません。ゲームの時間に合わせたいときは、Time.deltaTimeを加算するタイマーを使います。

番外編：Coroutine + WaitForSeconds

一定時間後に処理を行う際に役立つのが、CoroutineとWaitForSecondsです。これは遅延処理やクールタイムの実装で頻繁に利用されます。したがって、時間計測には向かないです。例えば、クイズゲームで解答表示3秒後に次の問題を出題するというときに使います。

【Unity】coroutine（コルーチン）で停止や再開を解説

Unityのコルーチン（Coroutine）の使い方を解説。yield returnでの待機、WaitUntilでの条件待ち、StopCoroutineでの停止と再開に加え、Invokeやasync/awaitとの違いも紹介します。

alicia-ing.com

2026.10.19

例として、3秒後に特定の処理を行うコードは以下です。

実際のコードでは次のように書きます。

IEnumerator DelayedAction()
{
    yield return new WaitForSeconds(3f);
    Debug.Log("3秒経過しました。");
}

void Start()
{
    StartCoroutine(DelayedAction());
}

このように、指定した時間経過後に処理を自動的に実行できるため、イベント制御やゲームロジックの調整に非常に便利です。

1秒待つときは、WaitForSeconds(1f)にします。WaitForSecondsはTime.timeScaleの影響を受けるので、一時停止中も待ちたいときはWaitForSecondsRealtimeを使います。

Unity 6では、Coroutineを使わずに「await Awaitable.WaitForSecondsAsync(1f);」と書いて待つこともできます（公式ドキュメント）。

ゲームクリア後、シーン遷移して時間計測結果を表示する

これまでの方法を踏まえて、実際のゲームでクリアタイムを分秒表示し、クリア後はタイマーを停止、シーンを移動して結果を表示する機能を作ります。

シーン移動やドラッグ＆ドロップは別記事で紹介していますので、本記事ではタイマーのみ解説をします。

【Unity】ドラックアンドドロップでゲームオブジェクトを動かす

ゲームオブジェクトをドラッグアンドドロップするには、Camera.main.ScreenToWorldPoint()か、イベントシステムでIPointerDownHandler, IDragHandler, IPointerUpHandlerを使います。

alicia-ing.com

2025.05.03

実装にはTime.deltaTimeを使った簡易タイマーを使います。それぞれのオブジェクトにドラッグ＆ドロップ機能をつけて、クリア時にタイマー停止後シーンを遷移し、結果表示します。

ソースコード1

using UnityEngine;
using TMPro;

public class Timer : MonoBehaviour
{
    [SerializeField] private TMP_Text timerText; // ゲーム中のタイマー表示用
    private float elapsedTime = 0f;
    private bool isRunning = true;

    // クリア時の最終時間を保持する static 変数
    public static float finalTime = 0f;

    void Update()
    {
        if (isRunning)
        {
            elapsedTime += Time.deltaTime;
            int minutes = Mathf.FloorToInt(elapsedTime / 60f);
            int seconds = Mathf.FloorToInt(elapsedTime % 60f);
            timerText.text = string.Format("{0:00}:{1:00}", minutes, seconds);
        }
    }

    // タイマー停止時に最終時間を保存する
    public void StopTimer()
    {
        isRunning = false;
        finalTime = elapsedTime;
    }
}

解説

• 名前空間

「UnityEngine」：Unityの基本機能を利用するために必要。GameObjectやMonoBehaviourクラス、Timeクラスなどが含まれる。
「TMPro」：TextMeshProコンポーネントを使用し、高品質なテキスト表示を実現するために必要。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

• フィールド（メンバ変数）

「timerText」：ゲーム画面に経過時間を表示するTextMeshProコンポーネントへの参照。
「elapsedTime」：ゲーム開始から経過した時間（秒）を保持するための変数。
「isRunning」：タイマーが現在動作中かどうかを示すフラグ（trueで動作中、falseで停止）。
「finalTime」：ゲームクリア時に計測した最終時間を保持するstatic変数。他のクラスからも参照可能。

• Updateメソッド

タイマーが動作中（isRunningがtrue）の場合、経過時間（elapsedTime）に前フレームからの経過時間（Time.deltaTime）を加算する。経過時間を分と秒に分解し、テキスト形式（MM:SS）でtimerTextに表示する処理を行う。

• StopTimerメソッド

タイマーを停止する際に呼ばれ、isRunningフラグをfalseに設定して計測を停止させる。同時に、計測された経過時間をfinalTimeに格納し、クリア時の最終時間として保持する。

実演

タイマースクリプトはゲームマネージャーなど共通管理用オブジェクトにアタッチします。

ゲームを再生すると、冒頭で紹介したような挙動が可能になります。

経過時間を画面上に表示（TMP_Textコンポーネント）ゴールした時点でTimerクラスのStopTimerメソッドを呼び、タイマーを止めます。

まとめ

本記事ではUnityの時間管理やタイマー機能を詳しく解説しました。

Time.time、Time.deltaTimeの基本的な使い方から、Stopwatchを利用した高精度タイマー、Coroutineを利用した時間制御の方法まで、幅広くカバーしました。

これらの技術を活用し、より質の高い、魅力的なゲームを作りましょう。

TextMeshProでテキストを一文字ずつ、文字送りする。

Unityでノベルゲームのような会話シーンを制作するとき、「文字を1文字ずつ表示したい！」ことがあると思います。

突然テキストが表示されるのではなく、まるでキャラクターが実際に話しているかのような演出があれば、プレイヤーの没入感も大きくアップさせることができます。

しかし、「実際にどうやって実装するの？」や「初心者でも簡単にできる方法はないの？」と悩んでいる方も多いでしょう。

本記事では、UnityのTextMeshPro（TMP）を使って1文字ずつ表示する方法を分かりやすく解説します。

具体的な実装例や注意点も挙げながら、初心者の方でも迷わず実践できる内容にしています。

文字送り表示

文字送りとは、テキストが一瞬で表示されるのではなく、1文字ずつ流れるように表示されるアニメーションのことを指します。

これはノベルゲームやアドベンチャーゲームなど、キャラクター同士が会話をするシーンでよく用いられています。

1文字ずつ表示されることによって、キャラクターが実際に言葉を話しているかのような臨場感を出すことができます。

プレイヤーの没入感を高める重要な要素なので、ゲームのクオリティを上げたいならぜひマスターしましょう。

また、RPGやチュートリアル表示など、幅広いジャンルのゲームにも応用可能です。

コルーチンで実装

Unityで1文字ずつの表示を効率的かつ簡単に実現するためには、
「コルーチン（Coroutine）」を使用します。

コルーチンとは、特定の処理を途中で待機（一定時間停止）させたり、
少しずつ処理を実行したりできるUnity特有の便利な機能です。

【Unity】coroutine（コルーチン）で停止や再開を解説

Unityのコルーチン（Coroutine）の使い方を解説。yield returnでの待機、WaitUntilでの条件待ち、StopCoroutineでの停止と再開に加え、Invokeやasync/awaitとの違いも紹介します。

alicia-ing.com

2026.10.19

似た機能にInvokeというものがありますが、Invokeは指定した関数を一度または定期的に呼び出すシンプルな仕組みであるのに対し、コルーチンは細かな処理の制御に適しています。

本記事のような単純に文字送りをするだけならInvokeでも良いですが、
文字送りの速度を微調整したり、特定の文字だけ遅らせたりする場合は、コルーチンをおすすめします。

【Unity】Invokeで引数を渡す、途中で停止・中断。

UnityのInvokeを使って引数を渡す方法や、処理を途中で停止するテクニックを解説。また、コールチンとの違いを紹介。

alicia-ing.com

2025.05.18

コルーチンを使った1文字ずつ表示する

今回紹介する方法は、TextMeshPro（テキストメッシュプロ）を使って、
簡単に実装できるシンプルな方法です。

ソースコードの大まかな流れは以下の通りです。

Unityでテキストを表示するのは多種ありますが、TextMeshProが主流です。
制御もしやすく、フォントを自由に使うことができます。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

stringを使用してスクリプト内のテキストで表示させる方法もありますが、
本記事では扱いやすくてより実践的なCSVファイルを読み込んで表示します。

【Unity】CSVファイルを読み込み、テキストを画面に表示する

UnityでのCSVファイルの読み込み方法を解説します。エクセルやGoogleスプレッドシートでcsvを作成し、データのインポート・読み書き・外部ファイル読み込みを簡単に実装する方法を紹介。

alicia-ing.com

2025.08.12

ソースコード

using System.Collections;
using UnityEngine;
using TMPro;
using System.IO;

public class typing : MonoBehaviour
{
    public TextMeshProUGUI LogText;
    public float typingInterval = 0.05f; // 文字表示の速度

    private string fullText;
    private bool isTyping = false;//タイピング開始

    void Start()
    {
        LoadCSV("Sample");
    }

    void LoadCSV(string fileName)
    {
        TextAsset csvFile = Resources.Load<TextAsset>(fileName);
        if (csvFile != null)
        {
            using (StringReader reader = new StringReader(csvFile.text))
            {
                fullText = reader.ReadLine();
            }
            StartCoroutine(TypeText());
        }
        else
        {
            Debug.LogError($"CSVファイル({fileName})が見つかりません。");
        }
    }

    IEnumerator TypeText()
    {
        isTyping = true;
        LogText.text = "";
        int i = 0;

        while (i < fullText.Length)
        {
            if (fullText[i] == '<') // タグ開始の処理
            {
                int tagEnd = fullText.IndexOf('>', i);
                if (tagEnd != -1)
                {
                    LogText.text += fullText.Substring(i, tagEnd - i + 1);
                    i = tagEnd + 1;
                }
            }
            else
            {
                LogText.text += fullText[i];
                i++;
                yield return new WaitForSeconds(typingInterval);
            }
        }

        isTyping = false;
    }
}

解説

• 名前空間

「System.Collections」：IEnumeratorとコルーチンを利用するために必要。
「UnityEngine」：MonoBehaviourを継承し、Unityの基本機能を使用するために必要。
「TMPro」：TextMeshProUGUIを使用し、UIにテキスト表示を行うために必要。
「System.IO」：文字列の読み込みや操作にStringReaderを使用するために必要。

• フィールド（メンバ変数）

「LogText」：画面に表示するテキスト（TMP）を格納し、逐次テキストを追加表示するためのUI要素。
「typingInterval」：1文字表示ごとの待機時間（秒数）を指定することで、テキスト表示の速度を調整する。
「fullText」：CSVファイルから読み込んだ表示対象の文字列を格納する。
「isTyping」：現在タイピング表示処理が進行中か否かを判定するフラグ（真偽値）。

• LoadCSVメソッド

引数として渡されたファイル名（Resources内にあるCSV形式のテキストファイル）を読み込む。

読み込みが成功すると、ファイルから取得した最初の行のテキストをfullTextに格納し、
TypeTextコルーチンを呼び出して文字列の逐次表示を開始する。

指定のファイルが存在しない場合は、エラーをログに表示する。

• TypeTextメソッド

コルーチンを用いて、fullTextに格納されているテキストを1文字ずつ表示する。

文字列内にHTMLタグなどの特殊タグ（<…>）があった場合はタグ全体をまとめて表示し、
タグが途切れないよう処理する。

タグではない通常の文字は、指定したインターバル（typingInterval）ごとに1文字ずつ追加表示される。

全ての文字を表示し終えると、isTypingフラグをfalseに戻し、処理を完了する。

実演

作成したスクリプトをInspectorウィンドウにアタッチして実行すると、
以下のような挙動を確認できます。

CSVはResourcesフォルダーに入れて管理しますが、現在は非推奨です。

【Unity】Resourcesフォルダの使い方と非推奨な理由

UnityのResourcesフォルダは、アセットを動的に管理できる機能ですが、非推奨とされる。ビルドサイズの増加やメモリ管理の難しさ、アセット参照の追跡が困難になることなどで、「アドレッサブルシステム」を利用することが推奨とされる。

alicia-ing.com

2025.04.29

文字送り中に、右クリックで全表示する

さらに快適なユーザー体験を提供するために、応用機能として「右クリックすると瞬時に全テキストが表示される機能」も追加してみましょう。

これによりプレイヤーが待ち時間を自由にコントロールでき、ストレスを軽減できます。

void Update()
{
    if (Input.GetMouseButtonDown(1) && isTyping)
    {
        StopAllCoroutines();
        LogText.text = fullText;
        isTyping = false;
    }
}

右クリックでコルーチンを途中停止することで、処理の完了を即時化します。

左クリックで全文を表示し、もう一度で次の行へ進む

会話を読み進めるゲームでは、文字の表示中に左クリックすると全文が出て、もう一度左クリックすると次の行へ進む、という動きがよく使われます。

private Coroutine typingCoroutine;   // 動いているコルーチンを覚えておく

void ShowLine(string text)
{
    fullText = text;
    if (typingCoroutine != null) StopCoroutine(typingCoroutine);
    typingCoroutine = StartCoroutine(TypeText());
}

void Update()
{
    if (!Input.GetMouseButtonDown(0)) return;

    if (isTyping)
    {
        // 1回目のクリック：全文を表示するだけ
        StopCoroutine(typingCoroutine);
        LogText.text = fullText;
        isTyping = false;
    }
    else
    {
        // 2回目のクリック：次の行へ
        NextLine();   // 次の行の文字をShowLineに渡す処理
    }
}

StopAllCoroutines()は、そのスクリプトで動いているすべてのコルーチンを止めます。自動送りなど別のコルーチンも同じスクリプトで動かしている場合は、上のようにStartCoroutineの戻り値を覚えておき、StopCoroutineでそれだけを止めます。

著者の体験談

左クリックで「全文表示→次の行」、右クリックでバックログを開く、という分け方にしています。オート再生も別のコルーチンで動かしているので、StopAllCoroutines()だとオートまで止まってしまいました。

閉じていない「<」でゲームが固まるのを防ぐ

本記事のTypeTextは、閉じていない「<」（「>」が無いもの）がセリフにあると、読む位置が進まずにゲームが固まります。タグの終わりが見つからないときは、「<」を普通の文字として1文字進める処理を足しておくと安全です。

if (tagEnd != -1)
{
    LogText.text += fullText.Substring(i, tagEnd - i + 1);   // タグはまとめて追加
    i = tagEnd + 1;
}
else
{
    LogText.text += fullText[i];   // 閉じていない < はそのまま表示
    i++;
}

まとめ

この記事では、UnityのTextMeshProを使った1文字ずつ表示する方法を解説しました。

キャラクターが実際に会話しているような演出を実現することで、
ゲームのクオリティやプレイヤーの没入感が大幅に向上します。

また、「右クリック即時表示」機能を導入すれば、
ユーザーがさらに快適にゲームを楽しめます。

次のステップとして以下の記事もチェックして、さらなるスキルアップを目指しましょう！

音程を高くすることなく、再生速度だけ変える。

Unityでゲームやアプリケーションを制作する際、
音声の再生速度を変更することは演出や操作感の向上に非常に有効です。

しかし、再生速度を単純に上げると、音の高さも一緒に上がってしまい、
思い通りのサウンドにならないケースが多々あります。

本記事では、AudioSourceのピッチ設定を利用しつつ、
AudioMixerのPitch Shifterを併用することで、再生速度だけを変更し、
音程はそのまま維持する方法について詳しく説明します。

Pitch（AudioSource）

AudioSourceのピッチ（Pitch）は、音声の再生速度と周波数を決定する重要なパラメータです。

ピッチの値を上げると再生速度が速くなり、同時に音の高さ（周波数）も上昇します。
ピッチを上げるとこのサンプルレートが相対的に高くなり、
波形の周期が短縮されることで音程が上昇します。

たとえば、以下のようにピッチを1.5に設定すると、
元の再生速度よりも50％速く再生され、音程も高く聞こえるようになります。

ピッチの変更は、InspectorウィンドウのAudioSourceで操作できますが、
スクリプトを使うことでも制御可能です。

// AudioSourceのピッチを1.5に変更する例
audioSource.pitch = 1.5f;

PitchShifter

PitchShifterは、AudioMixer上で動作するオーディオエフェクトの一種です。
このエフェクトは、再生速度を変更した際に生じる音程の変化を補正するために利用されます。

音の高さを変えないためには、AudioSourceのピッチ操作によって速くなった再生速度に合わせ、
逆数の値を用いてPitch Shifterを調整することで、音程を元の状態に近づけることが可能となります。

AudioSourceのピッチ操作と同様にInspectorウィンドウからだけではなく、
スクリプト制御が可能です。

// AudioMixerのPitch Shifterパラメータを設定する例（パラメータ名："PitchShifter"）
audioMixer.SetFloat("PitchShifter", 0.75f);

PitchShifterの作成方法

PitchShifterを利用するためには、Unityエディタ内でAudioMixerを正しく設定し、
Pitch Shifterエフェクトを適用する必要があります。

作成したAudioMixerをダブルクリック、あるいはUnityエディタ上部のメニューから「Window」＞「AudioMixer」を選択し、新規または既存のAudioMixerを開きます。

AudioMixerは複数のオーディオグループをまとめて管理できるため、
エフェクトの適用や音量調整が容易になります。

作成したAudioMixer内の適用対象となるミキサーグループを選択します。
本記事では、「Master」を使用します。
「Add…」ボタンをクリックし、リストから「Pitch Shifter」エフェクトを追加します。

Pitch Shifterエフェクトは、AudioSourceのピッチ変更に伴う音程のズレを補正する機能です。

エフェクトパラメータのExpose

Pitch Shifterエフェクトを導入して、ゲームを再生すると警告文が出てきます。

警告文の内容は、PitchShifterがないというもの。

Exposed name does not exist: PitchShifter
UnityEngine.StackTraceUtility:ExtractStackTrace ()

エフェクト追加後、Pitch Shifterのパラメータをスクリプトから操作できるようにExposeします。

InspectorウインドウのPitch Shifterエフェクトでパラメータ名を右クリックします。

「Expose pitch to script」でスクリプト制御を可能にします。
さらに、「Exposed Parameters」で名前を「PitchShifter」に変更します。

この設定でスクリプト側からAudioMixer.SetFloat(“PitchShifter”, 補正値)を利用して、
エフェクトのパラメータにアクセス可能となります。

再生速度だけ上げて高さはそのまま

再生速度だけを上げて音程（高さ）は変えないように、
AudioSourceとAudioMixerの両方を連動させる設定を行ってきました。

そこで、スライダーを操作して再生速度だけ上げる機能を作成します。

【Unity】スライダー使い方｜制限時間ゲージ、HPバー、音量調整

Unityのスライダー（Slider）でHPバー・制限時間ゲージ・音量調整を作る方法を解説。Min Value・Max Valueの設定、HPバーをなめらかに減らすスクリプト、離したとき・押したときの処理まで紹介します。

alicia-ing.com

2026.10.12

方法はAudioSourceのpitchプロパティを変更して、再生速度を調整する。
同時に、AudioMixer上のPitchShifterパラメータに、AudioSourceのpitch値の逆数を設定する。

【Unity】csvファイルから画像と音声をパスで読み込み

Unityでcsvに書いたパスから画像と音声を読み込む方法を解説。Resourcesフォルダの使い方と非推奨な理由、立ち絵・ボイスの表示に加えて、背景・BGMをcsvで切り替える方法も紹介します。

alicia-ing.com

2026.10.19

ソースコード

using UnityEngine;
using UnityEngine.UI;
using TMPro;
using UnityEngine.Audio;

public class AudioPitchController : MonoBehaviour
{
    public AudioSource audioSource;  // 操作対象の AudioSource
    public Slider pitchSlider;       // スライダー
    public TMP_Text pitchText;       // 再生速度表示用の TMP
    public AudioMixer audioMixer;    // AudioMixer（Pitch Shifterを制御するため）

    private const string PitchShifterParam = "PitchShifter"; // Audio Mixer の Pitch パラメータ

    void Start()
    {
        if (pitchSlider != null)
        {
            pitchSlider.minValue = 0.5f; // スライダーの最小値を0.5
            pitchSlider.maxValue = 2.0f; // スライダーの最大値を2.0
            pitchSlider.value = 1.0f;    // 初期値を1.0
            pitchSlider.onValueChanged.AddListener(UpdatePitch);
        }

        UpdatePitch(pitchSlider.value); // 初期値の設定
    }

    void UpdatePitch(float value)
    {
        // AudioSource の pitch を変更
        if (audioSource != null)
        {
            audioSource.pitch = value; // 再生速度変更
            Debug.Log($"AudioSource.pitch = {audioSource.pitch}");
        }
        else
        {
            Debug.LogWarning("AudioSource が設定されていません！");
        }

        // AudioMixer の Pitch Shifter を調整
        if (audioMixer != null)
        {
            float pitchShifterValue = 1.0f / value; // 逆数にすることで音程を一定に保つ
            audioMixer.SetFloat(PitchShifterParam, pitchShifterValue);
            Debug.Log($"AudioMixer Pitch Shifter = {pitchShifterValue}");
        }
        else
        {
            Debug.LogWarning("AudioMixer が設定されていません！");
        }

        // Text 表示を更新
        if (pitchText != null)
        {
            pitchText.text = $"×{value:F2}"; // 小数2桁で表示
        }
    }
}

UdemyでUnityを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

【Unity】学習ロードマップ｜自作ゲームを作りたい人必見！

Unityを使って自作ゲームを作りたい方必見。ゲームエンジン選択から学習方法、収益化の手段まで初心者向けにわかりやすく解説します。

alicia-ing.com

2026.10.06

解説

• 名前空間

UnityEngine：ゲーム開発の基本機能（GameObject、Transform、MonoBehaviourなど）を利用するために必要です。
UnityEngine.UI：UIコンポーネント（スライダーなど）を利用するために必要です。
TMPro：TextMeshProのテキスト表示機能を利用するために必要です。
UnityEngine.Audio：オーディオの再生やミキシング、AudioMixerを操作するために必要です。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

• フィールド（メンバ変数）

audioSource：音声再生の制御を担うAudioSourceコンポーネントを参照します。
pitchSlider：再生速度（ピッチ）の調整に使用するスライダーコンポーネントを参照します。
pitchText：現在の再生速度をテキスト表示するためのTextMeshProコンポーネントを参照します。
audioMixer：ピッチシフターのパラメータを調整するためのAudioMixerコンポーネントを参照します。
PitchShifterParam：AudioMixer内のピッチシフターを制御するためのパラメータ名「PitchShifter」を保持する定数です。

• Startメソッド

スライダーが存在する場合、最小値（0.5）、最大値（2.0）、初期値（1.0）を設定し、
スライダー値の変化でUpdatePitchメソッドが呼ばれるようリスナーを登録します。

その後、初期値をもとに一度UpdatePitchメソッドを実行し、
AudioSourceやAudioMixer、テキスト表示などの初期状態を反映させます。

• UpdatePitchメソッド

AudioSourceが設定されていれば、そのpitchプロパティを更新し、再生速度を変更します。
設定されていない場合は警告ログを出力します。

AudioMixerが設定されていれば、引数の逆数を計算してピッチシフターのパラメータを調整し、音程を一定に保つよう補正します。

設定されていない場合は警告ログを出力します。
TMPテキストが設定されていれば、計算された再生速度を小数点以下2桁でフォーマットし、
テキストに反映させます。

【Unity】カウントアップでリザルト画面にスコアを表示

Unityでスコアを表示します。カウントアップ機能や別シーンに移動してリザルト画面を表示など紹介しています。

alicia-ing.com

2025.04.16

実演

初めに、シーン内に必要なUIコンポーネントを正しくアタッチしてください。

シーンが開始されると、スクリプトのStartメソッドが実行され、
まずUI（特にSlider）の初期設定が行われます。

スライダーの最小値（0.5）、最大値（2.0）、初期値（1.0）が設定され、
値が変更されるたびにUpdatePitchメソッドが呼ばれるようリスナーが登録されます。

スライダーの値が直接AudioSourceのpitchプロパティに反映され、再生速度が変わります。

音の高さが変わらないようにするため、AudioMixerのPitch Shifterパラメータには、
スライダーの値の逆数が適用されます。

再生速度をゲームの進行速度と連動させる

本記事の仕組みは、ゲームの「進行速度」の設定にも使えます。たとえば会話を読み進めるゲームで進行速度を2倍にしたら、BGMやボイスだけでなく、文字が出る間隔や、自動で次へ進むまでの待ち時間も半分にしたくなります。

そこで、元の時間を速度の値で割り算して使います。

float speed = pitchSlider.value;                   // 進行速度（0.5〜2倍）

audioSource.pitch = speed;                         // BGM・ボイスの再生速度
audioMixer.SetFloat("PitchShifter", 1f / speed);   // 音の高さは元に戻す

float typingInterval = baseTypingInterval / speed; // 1文字ごとの間隔
float autoWait = baseAutoWait / speed;             // 自動で次へ進むまでの待ち時間

割り算するのは「使うとき」だけにして、元の値（baseTypingIntervalとbaseAutoWait）は書き換えないようにします。割った結果で元の値を上書きして保存すると、次に起動したときにもう一度割られて、どんどん速くなってしまいます。

筆者

自作のノベルゲームでは、進行速度のスライダー1本で、BGM・ボイスの再生速度と、文字送り・オートの待ち時間をまとめて変えています。最初は文字送りの値そのものを書き換えていたため、起動するたびに速くなる不具合が出ました。

まとめ

本記事では、UnityにおけるAudioSourceのピッチ操作とAudioMixerのPitch Shifterエフェクトを組み合わせ、再生速度のみを変更しながらも音程を維持する方法について解説しました。

この技法は、ゲーム内のBGM、効果音、ナレーションなど、さまざまなシーンで応用可能です。
例えば、スローや早送りの演出、ユーザーの操作に応じたリアルタイムな音声変化など、音響面での表現の幅を大きく広げることができます。