UnityのC#デリゲート | イベントとコールバック

私もUnityを始めた頃、「関数を変数みたいに渡す」という概念に一度つまずきました。

ボタンを押したら処理を実行したい。
敵が倒れたらUIを更新したい。
そういう「あとから実行する処理」をつなぐのが、デリゲートやイベントの役割です。
難しく見えますが、UnityEventから触れると理解が早いです。

この記事では、delegateとActionの概要、UnityEventとの使い分け、ボタンクリックや死亡通知の具体例まで解説します。
実務で出会う場面に絞って整理します。

＼プログラミング未経験でも大丈夫！まずは1本作り切ろう／

初心者が最初に選ぶならコレ

Unity ノンフィールドRPG
＋スレスパ風JRPG講座

★★★★★ (Unity6対応)

Unity6対応・スマホ化対応の最新カリキュラム。「何から始めればいいかわからない」という初心者でも、ステップごとに手を動かすだけでRPGが完成します。

講座を見てみる ＼ゼロからでもスマホ対応RPGが作れる！／

憧れのアクションゲームに挑戦

Unity 2Dアクションゲーム
の作り方講座（ロックマン風）

★★★★★ (スマホ化・広告実装)

初心者でもロックマン風の横スクロールACTが作れる講座。7ステージ＋ラスボスという本格構成で、スマホ化・広告実装まで対応。「自分のゲームをリリースしたい」夢を叶えます。

講座を見てみる ＼初心者でも本格ACTが完成する！／

3Dゲーム開発の入口はここ

ゼルダ風3Dアクションゲーム
の作り方講座

★★★★★ (スマホ化対応)

「3Dゲームって難しそう…」と感じている初心者向けの講座。全16回でゼルダ風3Dアクションがスマホ対応で作れるようになります。3D開発の基礎がしっかり身につきます。

講座を見てみる ＼初心者でも全16回で3Dゲームが完成！／

デリゲートとは何か

デリゲート（delegate）は、メソッドを参照して保持できる型です。
変数に数値や文字列を入れるように、メソッドを「後で呼ぶ処理」として登録できます。

public class GameManager : MonoBehaviour
{
    public delegate void OnGameOverDelegate;
    public OnGameOverDelegate onGameOver;

    public void TriggerGameOver
    {
        Debug.Log("ゲームオーバー");
        onGameOver?.Invoke;
    }
}

onGameOver?.Invokeは、登録された処理があれば実行する、という意味です。
?はnullチェックの省略記法です。

Actionを使った短い書き方

毎回delegateを宣言するのは長いので、Actionを使うのが一般的です。
System名前空間の型なので、using System;を忘れないようにしましょう。

using System;
using UnityEngine;

public class ScoreManager : MonoBehaviour
{
    public Action<int> onScoreChanged;

    public void AddScore(int value)
    {
        onScoreChanged?.Invoke(value);
    }
}

Actionは引数なし、Action<int>はintを1つ受け取る、Action<int, string>は2つ受け取る、という形で使います。
戻り値がある処理にはFuncを使いますが、イベント通知ではActionが多いです。

UnityEventとの使い分け

Unityには、Inspector上でドラッグ＆ドロップで登録できるUnityEventもあります。
ボタンのOnClickはこれが代表例です。

using UnityEngine;
using UnityEngine.Events;

public class DoorSwitch : MonoBehaviour
{
    public UnityEvent onDoorOpened;

    public void OpenDoor
    {
        Debug.Log("ドアが開いた");
        onDoorOpened?.Invoke;
    }
}

使い分けの目安は次のとおりです。

• UnityEvent：Inspectorで非プログラマも設定したい、ボタン連携、演出のつなぎ
• Action/delegate：コードだけで完結、複雑な引数、パフォーマンスを気にする場面

管理人

UIボタンならUnityEvent、スクリプト同士の連携ならAction、と覚えておくと選びやすいです。
どちらも「後から実行する」という点は同じですよ。

ボタンクリックのイベント例

UIボタンは、コードを書かなくてもInspectorから処理を登録できます。

コードから登録する場合は、次のように書きます。

using UnityEngine;
using UnityEngine.UI;

public class StartButton : MonoBehaviour
{
    void Start
    {
        Button btn = GetComponent<Button>;
        btn.onClick.AddListener(OnStartClicked);
    }

    void OnStartClicked
    {
        Debug.Log("ゲーム開始！");
    }
}

AddListenerでメソッドを登録し、RemoveListenerで解除できます。
シーン切り替え時に解除を忘れると、二重登録の原因になるので注意しましょう。

敵の死亡通知でActionを使う

敵が倒れたらスコア加算やSE再生をしたい場面では、Actionが向いています。

using System;
using UnityEngine;

public class Enemy : MonoBehaviour
{
    public Action onDeath;
    [SerializeField] private int hp = 30;

    public void TakeDamage(int amount)
    {
        hp -= amount;
        if (hp <= 0)
        {
            onDeath?.Invoke;
            Destroy(gameObject);
        }
    }
}

public class GameFlow : MonoBehaviour
{
    void Start
    {
        Enemy enemy = FindObjectOfType<Enemy>;
        enemy.onDeath += HandleEnemyDeath;
    }

    void HandleEnemyDeath
    {
        Debug.Log("敵撃破！スコア+100");
    }
}

+=で登録、-=で解除します。
複数の処理を1つのイベントに登録できるのも、デリゲートの便利な点です。

C#イベント（event）キーワード

外部から勝手にInvokeされないよう、eventキーワードを付ける書き方もあります。

public event Action onDeath;

// 外部から onDeath?.Invoke は呼べない
// 登録（+=）と解除（-=）だけ可能

公開APIとしてイベントを渡すときは、event付きのActionにしておくと安全です。
自分のクラス内からだけInvokeする、というルールを守りやすくなります。

ラムダ式で短く登録する

Actionには、メソッド名の代わりにラムダ式を渡す書き方もあります。

void Start
{
    ScoreManager score = GetComponent<ScoreManager>;
    score.onScoreChanged += (newScore) =>
    {
        Debug.Log("スコア更新: " + newScore);
    };
}

1行で済む処理ならラムダ式が便利です。
ただし、RemoveListenerや-=で解除するときは、同じ参照が必要になるため、長い処理は名前付きメソッドにしておく方が安全です。

管理人

最初はUnityEventのボタン連携から触って、慣れたらActionでスクリプト間連携、という順番がおすすめです。
いきなり全部理解する必要はありません。

よくあるつまずき

• 登録忘れ → +=やAddListenerを書いたか確認
• 二重登録 → Startが複数回走るとリスナーが増える。
  解除するか1回だけ登録する
• privateメソッドをInspector登録 → UnityEventから呼ぶメソッドはpublicが必要
• 破棄後の参照 → Destroyしたオブジェクトのイベントは解除する

「ボタンを押しても反応しない」ときは、OnClickのリストが空でないか、Time.timeScaleが0になっていないかも合わせて確認してください。

イベント設計では、「誰が通知するか（発火側）」と「誰が受け取るか（購読側）」を分けて考えると整理しやすくなります。
EnemyはonDeathを発火するだけ、GameFlowはHandleEnemyDeathでUI更新——この分担がデリゲートの基本的な使い方です。
Sceneをまたいで使う場合は、DontDestroyOnLoadしたGameManagerにイベントを集約するパターンもよく見ます。

管理人

デリゲートは「松竹梅の連携」みたいなもの。
ボタンが叩く、敵が倒れる、UIが更新される——順番に役割を分けてつないでいきましょう。

まとめ

デリゲートとActionは、メソッドを後から実行するための仕組みです。
UnityEventはInspector連携向け、Actionはコード中心の連携向け、と使い分けると整理しやすくなります。

ボタンクリックや敵の死亡通知は、ゲーム制作で最初に出会うイベントの代表例です。
UIボタンのOnClickから試し、慣れたらActionでスクリプト間をつないでみましょう。
イベント設計を含めて学びたい方は、Unity入門の森の講座で、実践的なゲーム制作と一緒に身につけられます。
今日はButtonのOnClickに、Debug.Logを1つ登録するところから始めてみてください。