매크로 구조#

DECLARE_{델리게이트유형}DELEGATE{함수정보}

• 델리게이트 유형

  • DECLARE_DELEGATE (일대일)
  • DECLARE_MULTICAST (일대다)
  • DECLARE_DYNAMIC (블루프린트 연동, 일대일)
  • DECLARE_DYNAMIC_MULTICAST (블루프린트 연동, 일대다)

• 함수 정보

  • DECLARE_DELEGATE
  • DECLARE_DELEGATE_OneParam
  • DECLARE_DELEGATE_RetVal_ThreeParams
  • 최대 9개 파라미터까지 지원

설계 내용#

• 학사정보 변경 시 학교명, 내용을 학생에게 전달해야 함 -> 2개의 인자
• 변경된 학사 정보는 다수 인원을 대상으로 발송해야 함 -> MULTICAST
• 오직 C++ 프로그래밍에서만 사용 -> DYNAMIC 사용 X

결론: DECLARE_MULTICAST_DELEGATE_TwoParams 매크로 사용

1. CourseInfo#

• 발행자 (Publisher) 역할
• 델리게이트를 정의하고, 학사 정보가 변경될 때 Broadcast로 알림을 발행한다.

CourseInfo.h

// delegate 매크로 선언
DECLARE_MULTICAST_DELEGATE_TwoParams(FCourseInfoOnChangedSignature, const FString&, const FString&);

UCLASS()
class UNREALDELEGATE_API UCourseInfo : public UObject
{
    GENERATED_BODY()
public:
    UCourseInfo();

    // 델리게이트 멤버 변수 선언
    FCourseInfoOnChangedSignature OnChanged;
    
    // 외부에서 학사정보 변경 요청 시 호출되는 함수
    void ChangeCourseInfo(const FString& InSchoolName, const FString& InNewContents);

private:
    FString Contents;
};

CourseInfo.cpp

UCourseInfo::UCourseInfo()
{
    Contents = TEXT("기존 학사 정보");
}

void UCourseInfo::ChangeCourseInfo(const FString& InSchoolName, const FString& InNewContents)
{
    // 5. 학사 정보 내용 업데이트
    Contents = InNewContents;
    
    UE_LOG(LogTemp, Log, TEXT("[CourseInfo] 학사 정보가 변경되어 알림을 발송합니다."));
    
    // 6. 델리게이트를 통해 알림 발행 (구독자들에게 방송)
    OnChanged.Broadcast(InSchoolName, Contents);
}

2. Student#

• 구독자 (Subscriber) 역할
• 발행자(CourseInfo)가 알림을 보내면 자신이 등록한 함수(GetNotification)를 자동으로 호출받는다.

Student.h

UCLASS()
class UNREALDELEGATE_API UStudent : public UObject
{
    GENERATED_BODY()

public:
    // 알림을 받을 함수
    void GetNotification(const FString& School, const FString& NewCourseInfo);
private:
    FString Name;
};

Student.cpp

// 7. 모든 구독자 학생들이 알림을 받음
void UStudent::GetNotification(const FString& School, const FString& NewCourseInfo)
{
    UE_LOG(LogTemp, Log, TEXT("[Student] %s 님이 %s로부터 받은 메시지 : %s"), *Name, *School, *NewCourseInfo);
}

3. MyGameInstance#

• 조율자 (Coordinator) 역할
• 발행자와 구독자를 연결해주는 역할을 한다.
  • CourseInfo를 생성
  • Student들을 생성한다. (여기서는 3개)
  • Student들을 CourseInfo의 델리게이트에 바인딩(구독)시킨다.
• 유일하게 두 클래스(CourseInfo, Student)를 모두 include한다.

MyGameInstance.h

private:
    UPROPERTY()
    TObjectPtr<class UCourseInfo> CourseInfo;

MyGameInstance.cpp

void UMyGameInstance::Init()
{
    Super::Init();

    // CourseInfo는 MyGameInstance의 SubObject가 되고
    // MyGameInstance는 CourseInfo의 Outer가 됨
    // 1. Composition 관계로 CourseInfo 생성 (발행자)
    CourseInfo = NewObject<UCourseInfo>(this); 

    UE_LOG(LogTemp, Log, TEXT("==============================="));

    // 2. Student 객체 생성 (구독자)
    UStudent* Student1 = NewObject<UStudent>(this);
    Student1->SetName(TEXT("학생1"));
    UStudent* Student2 = NewObject<UStudent>(this);
    Student2->SetName(TEXT("학생2"));   
    UStudent* Student3 = NewObject<UStudent>(this);
    Student3->SetName(TEXT("학생3"));   
    
    // 3. 모든 학생을 구독자로 등록 (Binding)
    CourseInfo->OnChanged.AddUObject(Student1, &UStudent::GetNotification);
    CourseInfo->OnChanged.AddUObject(Student2, &UStudent::GetNotification);
    CourseInfo->OnChanged.AddUObject(Student3, &UStudent::GetNotification);

    FString SchoolName = TEXT("언리얼대학교");
    
    // 4. 발행자에게 정보 변경 요청 (이벤트 발생 트리거)
    CourseInfo->ChangeCourseInfo(SchoolName, TEXT("변경된 학사 정보"));
}

출력 결과#

LogTemp: ===============================
LogTemp: [CourseInfo] 학사 정보가 변경되어 알림을 발송합니다.
LogTemp: [Student] 학생3 님이 언리얼대학교로부터 받은 메시지 : 변경된 학사 정보
LogTemp: [Student] 학생2 님이 언리얼대학교로부터 받은 메시지 : 변경된 학사 정보
LogTemp: [Student] 학생1 님이 언리얼대학교로부터 받은 메시지 : 변경된 학사 정보

전체 흐름 요약#

1. MyGameInstance: CourseInfo 생성 (발행자 준비)
2. MyGameInstance: Student 객체 생성 (구독자 준비)
3. MyGameInstance: 학생들을 CourseInfo.OnChanged 델리게이트에 구독자로 등록 (AddUObject)
4. CourseInfo: 학사 정보 변경 시 델리게이트 Broadcast 실행 (모든 학생에게 발행)
5. Student: 등록된 함수 GetNotification 자동 호출 (구독자 알림 수신)

델리게이트 vs 컴포지션#

• 델리게이트: 느슨한 결합 (기능적 의존성 제거, 구독자 패턴 활용)
• 컴포지션: 강한 결합 (객체의 생성과 소멸 주기를 완전히 소유)

느슨한 결합 (Loose Coupling)의 장점#

• 향후 시스템 변경 사항에 대해 손쉽게 대처할 수 있다.
• 발행-구독 모델의 이점
  • 클래스는 자신이 해야 하는 작업에만 집중 가능
  • 외부 변경 사항에 영향을 받지 않음
  • 자신의 기능을 확장해도 다른 모듈에 영향을 주지 않음

언리얼 C++ 델리게이트 선언시 생각할 점#

적합한 매크로를 선택하기 위해 다음을 고려한다

1. 인자의 개수: 파라미터가 몇 개 필요한가?
2. 동작 방식: 1:1 통신인가, 1(Multicast) 통신인가?
3. 블루프린트 연동: 에디터/BP에서 접근이 필요한가? (Dynamic 필요 여부)

기타: UML에서의 표기#

• 따로 번외편에서 정리.