DesignPattern - 이벤트 버스(Event Bus) 패턴

📡 Unity 디자인 패턴 - 이벤트 버스(Event Bus) 패턴

1. 이벤트 버스란?

이벤트 버스(Event Bus) 패턴은 객체 간 직접적인 참조 없이, 전역 이벤트 허브를 통해 메시지를 주고받는 구조입니다.

"A가 B를 직접 알지 못해도, 이벤트 버스를 통해 소통할 수 있는 구조"입니다.

Unity에서는 UI, 게임 로직, 시스템 간 느슨한 연결(Decoupling) 이 필요할 때 매우 유용합니다.

---

2. 언제 사용하나요?

• 시스템 간 결합도를 낮추고 싶을 때
• 여러 UI/오브젝트가 동일한 이벤트를 구독해야 할 때
• 특정 이벤트에 반응하는 대상이 자주 바뀌거나 많을 때

---

3. 구조 설명

• Publisher (발행자): 이벤트를 전송함
• Subscriber (구독자): 특정 이벤트를 듣고 반응함
• EventBus: 중재자 역할. 모든 이벤트를 관리하고 전달함

---

4. Unity 예제: 플레이어가 아이템을 먹었을 때 UI 업데이트

🧠 Step 1: EventBus 클래스

using System;
using System.Collections.Generic;

public static class EventBus
{
    private static Dictionary<string, Action<object>> eventTable = new();

    public static void Subscribe(string key, Action<object> callback)
    {
        if (!eventTable.ContainsKey(key))
            eventTable[key] = delegate { };

        eventTable[key] += callback;
    }

    public static void Unsubscribe(string key, Action<object> callback)
    {
        if (eventTable.ContainsKey(key))
            eventTable[key] -= callback;
    }

    public static void Publish(string key, object data = null)
    {
        if (eventTable.TryGetValue(key, out var callback))
            callback.Invoke(data);
    }
}

---

🎮 Step 2: Player에서 아이템 획득 시 이벤트 발행

using UnityEngine;

public class Player : MonoBehaviour
{
    private void Update()
    {
        if (Input.GetKeyDown(KeyCode.E))
        {
            Debug.Log("플레이어가 아이템을 획득!");
            EventBus.Publish("ItemPicked", "HealthPotion");
        }
    }
}

---

🖼️ Step 3: UI가 이벤트를 구독하여 표시

using UnityEngine;
using TMPro;

public class ItemUI : MonoBehaviour
{
    [SerializeField] private TextMeshProUGUI itemText;

    private void OnEnable()
    {
        EventBus.Subscribe("ItemPicked", OnItemPicked);
    }

    private void OnDisable()
    {
        EventBus.Unsubscribe("ItemPicked", OnItemPicked);
    }

    private void OnItemPicked(object itemName)
    {
        itemText.text = $"획득한 아이템: {itemName}";
    }
}

---

5. 장점과 단점

✅ 장점

• 완전한 느슨한 결합
• 여러 오브젝트가 하나의 이벤트에 반응 가능
• 발행자와 구독자가 서로 몰라도 됨 → 확장성↑

❌ 단점

• 실행 흐름이 명확하지 않음 → 디버깅 어려움
• 잘못된 이벤트 키 입력 시 런타임 오류 유발 가능

---

✅ 마무리 한 줄 요약

이벤트 버스는 "말만 하면 누구든 들을 수 있는 마이크" 같은 구조로, Unity 프로젝트의 복잡도를 낮추는 강력한 도구입니다.