Unityで衝突(Collision)とトリガー(Trigger)をUnityEventで管理するチュートリアル

2025年3月23日

本資料では、Unityの物理演算における衝突(Collision) および トリガー(Trigger) イベントを、UnityEvent を利用して柔軟にハンドリングする方法を解説します。直接 OnCollisionEnter / OnTriggerEnter を実装するだけでなく、インスペクター上でイベントに紐づけるメソッドを自由に差し替えられる点に注目してください。

---

1. チュートリアルの概要

1.1 目的

• 柔軟なイベント管理: 衝突・トリガーイベントを UnityEvent として公開することで、インスペクター上で簡単に複数のイベントハンドラを登録・変更できます。
• 実践的な応用: 基本的な物理イベント処理に加え、トラブルシューティングのポイントやエラーハンドリングの注意点を学びます。

1.2 必要なスキルレベル

• Unityエディタの基本操作: GameObjectの作成、コンポーネントの追加・設定、シーンの保存と実行など。
• C#の基本文法: MonoBehaviour の継承、メソッド定義、デバッグログ出力（Debug.Log）など。
• 物理コンポーネントの基礎知識: Collider、Rigidbody、Is Triggerの使い分けなど。

---

2. 使用するスクリプト

2.1 CollisionTriggerHandler.cs

物理衝突発生時に UnityEvent を通じて処理を呼び出すスクリプトです。

using UnityEngine;
using UnityEngine.Events;

public class CollisionTriggerHandler : MonoBehaviour
{
    // インスペクター上でハンドラ登録可能な UnityEvent
    public UnityEvent<Collision> OnCollisionEnterEvent;

    private void OnCollisionEnter(Collision collision)
    {
        // 衝突時にイベントが正しく呼び出されているか、デバッグログで確認
        Debug.Log("衝突検知: " + collision.gameObject.name);
        OnCollisionEnterEvent?.Invoke(collision);
    }
}

2.2 TriggerHandler.cs

トリガー領域に入った際に UnityEvent を呼び出すスクリプトです。

using UnityEngine;
using UnityEngine.Events;

public class TriggerHandler : MonoBehaviour
{
    public UnityEvent<Collider> OnTriggerEnterEvent;

    private void OnTriggerEnter(Collider other)
    {
        Debug.Log("トリガー検知: " + other.gameObject.name);
        OnTriggerEnterEvent?.Invoke(other);
    }
}

2.3 Example.cs

実際の処理（ログ出力）を実装したサンプルスクリプトです。
インスペクター上でこれらのメソッドをイベントに紐付けて利用します。

using UnityEngine;

public class Example : MonoBehaviour
{
    public void HandleCollisionEnter(Collision collision)
    {
        Debug.Log("衝突発生: " + collision.gameObject.name);
    }

    public void HandleTriggerEnter(Collider other)
    {
        Debug.Log("トリガー発生: " + other.gameObject.name);
    }
}

---

3. シーンのセットアップ

3.1 プロジェクトの準備

1. Unityで新規または既存のプロジェクトを開きます。
2. 上記3つのスクリプトファイル（CollisionTriggerHandler.cs、TriggerHandler.cs、Example.cs）をプロジェクト内の任意のフォルダ（例：Scripts）に配置します。

3.2 ゲームオブジェクトの配置と設定

1. 物理衝突を扱うオブジェクト（例：Cube）
   • シーンに3Dオブジェクト（Cube）を配置。
   • Collider（Box Collider）が自動追加されるので確認します。
   • Rigidbody を追加。Rigidbodyがないと物理衝突が発生しないため注意！
   • オブジェクトに CollisionTriggerHandler をアタッチ。
2. トリガーを扱うオブジェクト（例：Sphere）
   • シーンに3Dオブジェクト（Sphere）を配置。
   • Collider（Sphere Collider）を確認し、Is Trigger オプションをオンにする。
   • 必要に応じて Rigidbody を追加（移動や物理判定が必要な場合）。
   • オブジェクトに TriggerHandler をアタッチ。
3. イベント受信オブジェクト（例：EventReceiver）
   • 空のゲームオブジェクトを作成し、Example スクリプトをアタッチします。
   • 名前を「EventReceiver」など、役割が分かるように設定。

3.3 シーン図

複数の情報を表示するために、あえて、複数のウィンドウを表示しています

---

4. UnityEventのイベント紐付け

4.1 CollisionTriggerHandler の設定

1. シーン内の衝突オブジェクト（CollisionTriggerHandler を持つオブジェクト）を選択します。
2. インスペクターに表示される OnCollisionEnterEvent フィールドを確認。
3. 「＋」ボタンをクリックして新しいイベント要素を追加。
4. オブジェクトの参照に、Example スクリプトがアタッチされた「EventReceiver」をドラッグ＆ドロップ。
5. ドロップダウンから Example.HandleCollisionEnter(Collision) を選択。

4.2 TriggerHandler の設定

1. シーン内のトリガーオブジェクト（TriggerHandler を持つオブジェクト）を選択します。
2. インスペクターの OnTriggerEnterEvent フィールドを確認。
3. 「＋」ボタンをクリックして新しいイベント要素を追加。
4. オブジェクトの参照に、「EventReceiver」を設定。
5. ドロップダウンから Example.HandleTriggerEnter(Collider) を選択。

---

5. 実行と確認

1. シーンを保存し、Play モードにします。
2. 以下の動作を試して、イベントが正しく発火するか確認してください。
   • 衝突テスト: Rigidbodyを持つCubeを落下させ、別のオブジェクトに衝突させる。
   • トリガーテスト: Is Trigger が有効なオブジェクトに、他のColliderが侵入するように移動させる。
3. Console タブでログを確認し、以下のような出力があれば成功です。
   • 衝突時: 衝突発生: [衝突したオブジェクト名]
   • トリガー時: トリガー発生: [侵入したオブジェクト名]

---

6. トラブルシューティングとエラーハンドリング

• Rigidbodyの設定確認:
  衝突が発生しない場合、対象オブジェクトにRigidbodyが正しく追加されているか確認しましょう。Rigidbodyがなければ物理演算が働かず、イベントが呼ばれません。
• Colliderの設定:
  ・Is Trigger が正しく設定されているか。
  ・衝突オブジェクトには通常のCollider、トリガーオブジェクトにはIs TriggerがオンのColliderが必要です。
• NullReferenceException の回避:
  ・UnityEventにイベントリスナーが正しく登録されていないと、意図した動作にならない場合があります。インスペクターでイベントリストが空になっていないか確認してください。
  ・デバッグログを活用して、イベントが発火しているかどうかをチェックしましょう。

---

7. 応用例と拡張

• 複数イベントの連携:
  UnityEventは複数のメソッドを同時に登録できるため、同一イベントで複数の処理を連携させることが可能です。たとえば、衝突時にスコア加算やエフェクト再生など、複数のアクションを実行できます。
• 2D環境での実装:
  2Dゲームの場合は、OnCollisionEnter2D / OnTriggerEnter2D と UnityEvent<Collision2D> / UnityEvent<Collider2D> を用いることで、同様の仕組みを実装できます。コード例は上記のスクリプトをベースに調整してください。
• エディタ拡張:
  イベントの紐付けやデバッグ情報をより分かりやすくするために、エディタ拡張でカスタムインスペクターを作成する方法もあります。

---

8. まとめ

• 柔軟なイベント管理:
  CollisionTriggerHandler や TriggerHandler により、物理衝突やトリガーイベントをUnityEventとして公開することで、インスペクターから簡単にイベントハンドラを追加・変更できます。
• 基礎から応用まで:
  本チュートリアルでは、基本的なスクリプトの記述から、シーン上での設定方法、トラブルシューティング、さらには2D対応やエディタ拡張の応用例までを解説しました。
• 実践的な確認:
  デバッグログやUnityEventの正しい登録、ColliderとRigidbodyの設定など、実際の動作確認とエラー対応のポイントも確認することで、より実践的な開発力が身に付きます。

このチュートリアルを通じて、Unityでの物理イベント管理の基本から応用までの流れをしっかりと理解し、実際のプロジェクトに役立ててください。