【Unity】TextMeshProでテキストを1文字ずつ表示する

本記事を読むと以下の実行ができます

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

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

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

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

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

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

文字送り表示

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

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

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

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

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

コルーチンで実装

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

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

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

【アセット不要！Unityで作るノベルゲーム】第6回は、Invokeで引数を渡し、数秒後に動作させてオート機能を作ります。オートモードを導入すると、プレイヤーがわざわざクリック操作をせずにストーリーの流れを自動的に楽しむことができます。

alicia-ing.com

2024.10.30

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

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

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

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

alicia-ing.com

2024.10.23

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

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

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

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

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

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

alicia-ing.com

2024.11.03

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

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

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

alicia-ing.com

2024.10.28

ソースコード

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;
    }
}

UdemyでUnityを学習

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

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

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

alicia-ing.com

2025.01.25

解説

• 名前空間

「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

2024.10.23

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

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

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

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

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

まとめ

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

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

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

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