게임 개발/Unity 6 & C#

[게임 디자인 패턴] 옵저버 패턴: Unity C# vs Unreal C++ 구현과 UML 구조

kugorang 2025. 6. 1. 17:16
728x90

TL;DR (세 줄 요약)

  1. 체력이 바뀔 때 UI, 사운드, 업적이 모두 반응해야 합니다. 체력 클래스가 이들을 직접 부르면, 반응할 대상을 하나 더할 때마다 체력 클래스의 코드를 고쳐야 합니다.
  2. 옵저버 패턴은 "알림을 받을 함수의 목록"을 보관해 두고, 값이 바뀌면 목록의 함수를 차례로 부르는 설계입니다. Unity C#은 event로, Unreal C++은 델리게이트로 이 목록을 만듭니다.
  3. 구독과 해제는 반드시 짝으로 둡니다. Unity는 OnEnable과 OnDisable, Unreal은 BeginPlay와 EndPlay에 둡니다. 해제하지 않으면 이미 파괴된 객체의 함수가 불려 오류가 납니다.

이 글은 게임에서 자주 쓰는 옵저버 패턴(Observer Pattern)을 Unity C#과 Unreal C++로 각각 구현해 보고, 두 구현을 비교합니다. 디자인 패턴은 자주 생기는 문제를 푸는 검증된 설계 방법에 이름을 붙인 것입니다. 코드는 설명을 위한 예제입니다.

1. 옵저버 패턴이 없으면 코드가 어떻게 되나요?

회색 격자 배경 위에 원과 십자선이 그려져 있고 그 위에 OBSERVER PATTERN 이라는 글자가 적힌 그림
그림. 이 글의 주제인 옵저버 패턴

플레이어의 체력이 줄어들 때 체력바, 효과음, 업적이 모두 반응해야 한다고 가정합니다. 가장 단순한 방법은 체력을 가진 클래스가 세 가지를 직접 부르는 것입니다.

// 체력이 바뀔 때 직접 호출하는 방식
void TakeDamage(float d)
{
    health -= d;
    healthBar.SetValue(health);   // UI를 직접 안다
    audio.PlayHurt();             // 사운드도 직접 안다
    achievement.Check(health);    // 업적도 직접 안다
}

이 코드에서 체력 클래스는 체력바(healthBar), 사운드(audio), 업적(achievement)을 모두 알고 있습니다. 문제는 두 가지입니다.

  • 무기 아이콘 갱신, 데미지 숫자 표시, 리플레이 기록을 더하면 체력 클래스가 아는 대상이 계속 늘어납니다. 그때마다 TakeDamage를 고쳐야 합니다.
  • 다른 프로젝트에서 체력 클래스를 다시 쓰려면, 그 프로젝트에 없는 UI 클래스와 업적 클래스까지 함께 옮겨야 합니다.

2. 옵저버 패턴은 어떤 구조인가요?

옵저버 패턴에서는 값을 가진 쪽이 "알림을 받을 함수의 목록"만 가지고 있습니다. 값이 바뀌면 목록에 있는 함수를 순서대로 부릅니다. 누가 목록에 들어 있는지는 신경 쓰지 않습니다.

역할뜻예
Subject (발행자)상태를 가진 객체입니다. 구독 함수 목록을 보관하고, 상태가 바뀌면 목록을 순서대로 부릅니다.
Observer (구독자)알림을 받는 쪽입니다. 자신의 함수를 목록에 넣고(구독), 필요 없어지면 뺍니다(해제).
ConcreteSubject실제 값을 가진 클래스입니다.체력, 날씨, 점수
ConcreteObserver알림을 받아 각자 다른 일을 하는 클래스입니다.체력바 UI, 사운드, 업적

핵심은 Subject가 "알림을 받는 함수의 모양" 하나만 알고, 구독자가 실제로 어떤 클래스인지는 모른다는 점입니다. 그래서 구독자를 더해도 Subject의 코드는 바뀌지 않습니다.

값은 어떻게 전달하나요? (push와 pull)

방식동작알맞은 경우
push알림과 함께 값(예: 새 체력)을 넘깁니다. 구독자는 다시 묻지 않아도 됩니다.넘길 값이 한두 개일 때
pull"바뀌었다"는 사실만 알립니다. 구독자가 Subject에서 필요한 값을 직접 읽습니다.값이 여러 개일 때

아래 예제는 새 체력 값을 함께 넘기는 push 방식입니다.

3. Unity C#에서는 어떻게 구현하나요?

C#에는 함수를 값처럼 담아 두는 델리게이트(delegate)라는 타입이 있습니다. event는 델리게이트를 안전하게 공개하는 키워드입니다.

using System;
using UnityEngine;

public class Player : MonoBehaviour
{
    public event Action<float> OnHealthChanged;   // 구독 함수 목록
    float health = 100f;

    public void TakeDamage(float damage)
    {
        health -= damage;
        OnHealthChanged?.Invoke(health);          // 등록된 함수를 모두 호출
    }
}

public class HealthBarUI : MonoBehaviour
{
    public Player player;

    void OnEnable()  { player.OnHealthChanged += UpdateBar; }
    void OnDisable() { player.OnHealthChanged -= UpdateBar; }

    void UpdateBar(float value)
    {
        // value를 0~1로 바꿔 fillAmount에 넣는 계산
    }
}

코드를 순서대로 풀이합니다.

  • public event Action<float> OnHealthChanged;: 구독 함수 목록입니다. Action<float>는 float 값 하나를 받고 아무것도 돌려주지 않는 함수를 담는 델리게이트 타입입니다.
  • OnHealthChanged?.Invoke(health);: 목록에 등록된 함수를 모두 부르면서 새 체력 값을 넘깁니다. ?.은 구독자가 하나도 없어 목록이 null일 때 호출을 건너뛰는 문법입니다.
  • player.OnHealthChanged += UpdateBar;: 체력바가 자신의 UpdateBar 함수를 목록에 넣습니다(구독).
  • player.OnHealthChanged -= UpdateBar;: 목록에서 뺍니다(해제).
  • OnEnable과 OnDisable: 컴포넌트가 켜질 때와 꺼질 때 Unity가 불러 주는 함수입니다. 구독과 해제를 여기에 짝으로 둡니다.

event 키워드를 붙이면 클래스 바깥에서는 +=와 -=만 쓸 수 있습니다. 바깥에서 Invoke를 불러 가짜 알림을 보내거나 목록을 통째로 바꾸는 일을 막아 줍니다.

Player 클래스에는 체력바, 사운드, 업적이라는 단어가 한 번도 나오지 않습니다. 반응할 대상을 더하려면 새 클래스를 만들어 구독만 하면 됩니다.

4. Unreal C++에서는 어떻게 구현하나요?

Unreal Engine은 델리게이트를 매크로로 선언합니다. 여러 함수를 등록할 수 있는 델리게이트를 멀티캐스트 델리게이트라고 부릅니다.

DECLARE_MULTICAST_DELEGATE_OneParam(FOnHealthChanged, float);

UCLASS()
class APlayerCharacter : public AActor
{
    GENERATED_BODY()
public:
    FOnHealthChanged OnHealthChanged;
    float Health = 100.f;

    void TakeDamage(float Damage)
    {
        Health -= Damage;
        OnHealthChanged.Broadcast(Health);   // 등록된 모든 대상 호출
    }
};
  • DECLARE_MULTICAST_DELEGATE_OneParam(FOnHealthChanged, float);: float 인자 하나를 받는 멀티캐스트 델리게이트 타입 FOnHealthChanged를 선언합니다.
  • FOnHealthChanged OnHealthChanged;: 구독 함수 목록입니다.
  • OnHealthChanged.Broadcast(Health);: 등록된 모든 함수를 부르면서 새 체력 값을 넘깁니다. C#의 Invoke와 같은 역할입니다. 등록된 함수가 하나도 없어도 Broadcast는 안전하게 부를 수 있습니다.
  • UCLASS()와 GENERATED_BODY(): 엔진이 이 클래스의 정보를 알 수 있게 해 주는 Unreal의 매크로입니다.

참고로 AActor에는 이미 TakeDamage라는 이름의 가상 함수가 있습니다. 위 코드는 설명을 위해 단순하게 적은 것입니다. 실제 프로젝트에서는 엔진의 TakeDamage를 재정의하거나 겹치지 않는 다른 이름을 씁니다.

구독하는 쪽의 코드는 다음과 같습니다.

void UHealthBarWidget::Subscribe(APlayerCharacter* Player)
{
    if (Player)
        Player->OnHealthChanged.AddUObject(this, &UHealthBarWidget::UpdateHealthBar);
}
void UHealthBarWidget::UpdateHealthBar(float NewHealth) { /* UI 갱신 */ }
  • AddUObject(this, &UHealthBarWidget::UpdateHealthBar): 이 위젯 객체(this)의 UpdateHealthBar 함수를 목록에 넣습니다. C#의 +=와 같은 역할입니다.
  • if (Player): 플레이어 포인터가 비어 있지 않을 때만 구독합니다.

Unreal에서도 해제해야 하나요?

네. 등록 방법에 따라 해제 방식이 다릅니다.

등록 함수등록 대상해제
AddUObjectUObject의 멤버 함수델리게이트가 객체를 약한 참조로 기억합니다. 객체가 사라지면 그 바인딩은 더 이상 불리지 않습니다. 그래도 더 일찍 알림을 끊으려면 직접 해제합니다.
AddRaw일반 C++ 객체의 멤버 함수직접 Remove해야 합니다.
AddLambda람다(이름 없는 함수)직접 Remove해야 합니다.
AddDynamic동적 델리게이트에 등록하는 UFUNCTIONRemoveDynamic과 짝으로 씁니다.

약한 참조는 객체가 사라지는 것을 막지 않으면서 그 객체가 아직 살아 있는지 확인할 수 있는 참조입니다.

두 엔진의 구현을 나란히 놓으면 어떤가요?

하는 일Unity C#Unreal C++
목록 선언event Action<float>DECLARE_MULTICAST_DELEGATE_OneParam
구독+=AddUObject, AddDynamic 등
해제-=Remove, RemoveDynamic 등
알림 보내기?.Invoke(값)Broadcast(값)
구독과 해제를 두는 곳OnEnable, OnDisableBeginPlay, EndPlay

5. UML로 보면 어떤 관계인가요?

UML은 클래스 사이의 관계를 그림으로 나타내는 표기법입니다. 옵저버 패턴을 UML 클래스 다이어그램으로 그리면 다음 관계가 나옵니다.

  • Subject는 Observer 목록을 가집니다. 목록에는 0개 이상(0..*)의 Observer가 들어갑니다.
  • Observer는 update() 하나를 정의하는 인터페이스입니다. 인터페이스는 어떤 함수를 가져야 하는지만 정해 둔 약속입니다.
  • ConcreteSubject는 notify()에서 목록을 돌며 update()를 부릅니다.
  • ConcreteObserver는 update()를 구현합니다. pull 방식이면 Subject를 참조해 값을 읽습니다.

화살표는 Subject에서 Observer 인터페이스 쪽으로 향합니다. 구체 클래스끼리 직접 이어진 선이 없습니다. 이 선을 없애는 것이 옵저버 패턴의 목적입니다.

6. 실무에서 자주 생기는 문제는 무엇인가요?

문제설명
해제를 빠뜨림구독만 하고 해제하지 않으면 파괴된 객체의 함수가 불립니다. 가장 흔한 원인입니다.
알림 안에서 다시 알림알림을 처리하는 함수가 다시 같은 알림을 일으키면 호출이 끝없이 반복됩니다.
중복 구독같은 함수를 두 번 구독하면 변화 한 번에 함수가 두 번 실행됩니다.
알림 도중 목록 변경구독자 목록을 직접 만든 리스트로 관리할 때, 목록을 도는 중에 구독자가 추가되거나 빠지면 순회가 깨집니다. 목록의 복사본을 만들어 돕니다.
구독자의 예외C#에서는 구독자 하나에서 예외가 나면 그 뒤의 구독자가 알림을 받지 못합니다.

자주 묻는 질문 (FAQ)

Q1. 이벤트와 옵저버 패턴은 같은 것인가요?

이벤트는 옵저버 패턴을 구현하는 수단입니다. C#의 event와 Unreal의 델리게이트가 그 수단입니다. 옵저버 패턴은 "발행자는 구독자를 모른 채 알림만 보낸다"는 설계입니다. 직접 만든 인터페이스 목록으로도 같은 설계를 할 수 있습니다.

Q2. 해제를 안 하면 어떤 일이 생기나요?

객체를 파괴해도 목록에 그 객체의 함수가 남습니다. 다음 알림 때 이미 없는 객체의 함수가 불립니다. Unity에서는 그 함수가 파괴된 오브젝트에 접근하는 순간 MissingReferenceException이 납니다. 목록이 객체를 붙잡고 있어서 메모리도 정리되지 않습니다. Unreal C++에서 AddRaw로 등록한 객체가 사라진 뒤 알림이 가면 프로그램이 크래시할 수 있습니다.

Q3. 체력 변화처럼 자주 일어나는 값에도 써도 되나요?

쓸 수 있습니다. 다만 알림 한 번마다 구독자 수만큼 함수 호출이 일어납니다. 매 프레임 바뀌는 값이라면 값이 실제로 달라졌을 때만 알리거나, 한 프레임에 한 번만 알리도록 모읍니다. UI 갱신을 별도 주기로 처리하는 방법도 있습니다.

수정 안내

이 글은 2026년 11월 21일에 다시 썼습니다. 코드 블록 밖에 있어야 할 설명 문장이 코드 블록 안에 들어가 있던 것을 바로잡았습니다. FAQ Q2의 "C#에서는 NullReferenceException이 난다"를 Unity의 실제 예외 이름인 MissingReferenceException으로 고쳤습니다. "AddUObject로 등록한 바인딩은 자동으로 정리된다"를 "약한 참조로 기억해서 객체가 사라지면 불리지 않는다"로 고쳤습니다. "알림 도중 목록 변경" 문제는 직접 만든 리스트를 쓸 때의 문제라는 점을 밝혔습니다. Unreal 예제의 TakeDamage 이름이 엔진 함수와 겹친다는 설명을 더했습니다. Unreal 코드 블록의 언어 표시를 C++로 바꿨습니다.

참고 자료

같은 주제의 다른 글: [UE5 렌더링] 텍스처에서 디스플레이까지: 언리얼 색 파이프라인과 sRGB vs Linear, [게임 엔진 비교] Unity C# vs Unreal C++: 메모리 관리, GC, 성능, 생산성, [게임 개발 방법론] 게임 개발의 애자일·스크럼 도입 사례 3가지: 스타트업·대기업·분산팀, [Unity C#] Coroutine vs Thread vs UniTask·Awaitable 비교, [Unity] ML-Agents 강화학습 게임 AI: 관찰·행동·보상 설계와 학습 과정

728x90
728x90