UnityでUIボタンを押したらテキストが変わる — uGUI はじめの一歩

Game 視点でクリックできるボタンを置き、押すたびに TextMeshPro の文字列を書き換えます。カウンタを 1 足す程度の短いロジックです。

下図は「画面 → スクリプト → インスペクタ配線 → 再生」の流れです。

初めて TextMeshPro を使うプロジェクトでは、メニューから Window → TextMeshPro → Import TMP Essential Resources（表記はバージョンで多少異なる）を実行しておくと安全です。

1. ヒエラルキーで右クリック → UI → Canvas（EventSystem も自動生成されることが多い）
2. Canvas 下に UI → Button - TextMeshPro を作成（自動で Text 子が付く場合あり）
3. 同じく Canvas 下に UI → Text - TextMeshPro を追加し、名前を StatusLabel などに
4. 空の GameObject を作成し UiClickCounter を付ける場所に（後でスクリプトを載せます）

Assets で Create → C# Script。クラス名とファイル名を UiClickCounter にそろえます。

using TMPro;
using UnityEngine;

/// <summary>
/// ボタンから呼ぶ用の公開メソッドで、TextMeshProUGUI の文言を書き換えます。
/// Button の On Click () に、このコンポーネントが付いたオブジェクトを指定して紐づけます。
/// </summary>
public class UiClickCounter : MonoBehaviour
{
    [Header("更新したいラベル")]
    [SerializeField] private TextMeshProUGUI statusText;

    private int clicks;

    /// <summary>Inspector の Button → On Click () からこのメソッドを選びます。</summary>
    public void OnButtonPressed()
    {
        clicks++;
        statusText.text = $"ボタンを {clicks} 回押しました！";
    }
}

• TextMeshProUGUI statusText … 更新対象のラベル参照。Inspector でドラッグ割り当てします。
• OnButtonPressed … public かつ引数なしである必要があります（この形が Button イベントから選びやすい）。
• clicks … 状態をフィールドに持ち、クリックのたびに増やして文字列へ反映しています。

1. UiClickCounter をアタッチした GameObject を選択し、Status Text 欄に StatusLabel（TextMeshProUGUI）をドラッグ。
2. Button オブジェクトを選択。Button コンポーネントの On Click () で + を押す。
3. 出てきたスロットに UiClickCounter が付いた GameObject をドラッグ。
4. 右の関数ドロップダウンから UiClickCounter → OnButtonPressed を選択。
5. Play し、Game ビューでボタンをクリック。ラベルが更新されれば完了。

• ボタンの子 Text と StatusLabel を別々にして、見た目を整理してみる
• メソッドをもう1つ増やし、On Click に複数エントリを登録して連続で呼ぶ（リセット用など）
• 前レッスンの回転スクリプトと同じシーンに UI を足してもよい（レイアウトに注意）

• ボタンが反応しない … EventSystem がシーンにあるか、Button の interactable、 前面に他 UI が被っていないか確認。
• On Click にメソッドが出ない … public か、引数なしか、スクリプトにコンパイルエラーがないか確認。
• NullReferenceException … statusText を Inspector で割り当て忘れていないか。
• テキストが豆腐になる … TMP のフォールバックフォントや Import が必要な場合があります。

• Canvas / Button / TextMeshProUGUI を配置した
• SerializeField でテキスト参照を渡した
• Button の On Click () から public メソッドを呼んだ
• ゲーム中にラベル文字列を更新できた

• スライダーやトグルと値を束ねる（複数 UI を1つのPresenterにまとめる）
• 3D 入力と組み合わせる（クリック移動レッスン）
• Addressables で UI プレハブを動的ロードする（発展）