Udemy Unreal - Gameplay Ability System - Top Down RPG (Section 4)

📖 유데미 GAS 강의 중 기록해두고 싶은 내용을 적어둔 포스트

Section 4 : UI 구현 (MVC 패턴)

---

MVC 패턴

참고영상-배민 테코톡

View : 각 WBP
WidgetController : WidgetController 클래스
Model : Data들

View -> Controller -> Model 의 일방향적 종속성을 지니도록 한다.
(Model은 Controller의 상세를 모르고, Controller도 마찬가지로 각 Widget으로부터 독립적)

---

View

UAuraUserWidget

public:
 	// 위젯 블루프린트에서 컨트롤러 셋할 수 있도록
 	UFUNCTION(BlueprintCallable)
 	void SetWidgetController(UObject* InWidgetController);
 	
 	// 일방향 종속성을 위해 위젯이 컨트롤러를 포인터로 들고 컨트롤러는 위젯 안 들고 있음
 	UPROPERTY(BlueprintReadOnly)
 	TObjectPtr<UObject> WidgetController;
 
 protected:
 	// 컨트롤러가 셋 됐는지 확인하기위한 함수로 일종의 BeginPlay 역할 수행
 	UFUNCTION(BlueprintImplementableEvent)
 	void WidgetControllerSet();

void UAuraUserWidget::SetWidgetController(UObject* InWidgetController)
{
	WidgetController = InWidgetController;
	// 블루프린트 이벤트 호출
	WidgetControllerSet();
}

블루프린트에서 사용 예시

---

Controller

UAuraWidgetController

UObject 클래스를 상속받았다.

public:
	// FWidgetControllerParams는 4개의 멤버를 묶어놓은 구조체임
 	UFUNCTION(BlueprintCallable)
 	void SetWidgetControllerParams(const FWidgetControllerParams& WCParams);
 
 	
 protected:
 	// 자식 컨트롤러들이 접근할 수 있도록 protected
 	// Model에 접근하기 위한 포인터들 (일방향 종속성 유지 View -> Controller -> Model) 
 	UPROPERTY(BlueprintReadOnly, Category="WidgetController")
 	TObjectPtr<APlayerController> PlayerController;
 
 	UPROPERTY(BlueprintReadOnly, Category="WidgetController")
 	TObjectPtr<APlayerState> PlayerState;
 
 	UPROPERTY(BlueprintReadOnly, Category="WidgetController")
 	TObjectPtr<UAbilitySystemComponent> AbilitySystemComponent;
 
 	UPROPERTY(BlueprintReadOnly, Category="WidgetController")
 	TObjectPtr<UAttributeSet> AttributeSet;

HUD

컨트롤러 생성과 멤버 할당의 타이밍을 잡기위해 HUD 클래스를 활용한다.
게임모드에서 HUD 클래스를 지정하고 사용한다.

public:
 
 	UPROPERTY()
 	TObjectPtr<UAuraUserWidget> OverlayWidget;
 
 	// Controller도 같이 만들기 (Getter지만 없다면 하나 만들고 이미 있다면 있는 컨트롤러 리턴)
 	UOverlayWidgetController* GetOverlayWidgetController(const FWidgetControllerParams& WCParams);
 
 	// Overlay 구성을 위한 위젯과 컨트롤러 생성
 	void InitOverlay(APlayerController* PC, APlayerState* PS, UAbilitySystemComponent* ASC, UAttributeSet* AS);
 
 	
 private:
 
 	UPROPERTY(EditAnywhere)
 	TSubclassOf<UAuraUserWidget> OverlayWidgetClass;
 
 	// 컨트롤러 만들기 위한 클래스와 만든 뒤의 포인터
 	UPROPERTY(EditAnywhere)
 	TSubclassOf<UOverlayWidgetController> OverlayWidgetControllerClass;
 	UPROPERTY()
 	TObjectPtr<UOverlayWidgetController> OverlayWidgetController;

InitOverlay() 함수에서 위젯 생성과 컨트롤러 할당

 UOverlayWidgetController* AAuraHUD::GetOverlayWidgetController(const FWidgetControllerParams& WCParams)
 {
 	if (OverlayWidgetController == nullptr)
 	{
 		OverlayWidgetController = NewObject<UOverlayWidgetController>(this,OverlayWidgetControllerClass);
 		OverlayWidgetController->SetWidgetControllerParams(WCParams);
 	}
 	return OverlayWidgetController;
 }
 
 void AAuraHUD::InitOverlay(APlayerController* PC, APlayerState* PS, UAbilitySystemComponent* ASC, UAttributeSet* AS)
 {
 	// 단순 check - crash 보다 상세하게 메시지 전달
 	checkf(OverlayWidgetClass, TEXT("OverlaywidgetClass Uninitialized, Check BP_AuraHUD"));
 	checkf(OverlayWidgetControllerClass, TEXT("OverlayWidgetControllerClass Uninitialized, Check BP_AuraHUD"));
 
 	
 	UUserWidget* Widget = CreateWidget<UUserWidget>(GetWorld(),OverlayWidgetClass);
 	OverlayWidget = Cast<UAuraUserWidget>(Widget);
 	const FWidgetControllerParams WCParams(PC,PS,ASC,AS);
 	OverlayWidgetController = GetOverlayWidgetController(WCParams);
 	OverlayWidget->SetWidgetController(OverlayWidgetController);
 	
 	Widget->AddToViewport();
 	
 }

InitOverlay()의 호출은 AAuraCharacter::InitAbilityActorInfo()에서

• Controller 생성에 필요한 4가지 멤버가 모두 생성된 이후에 해야하므로 이 부분이 적절한 시점이다. (이미 포인터를 받아놔서 전달하기도 편함)
• PlayerController를 통해 HUD에 접근할 수 있다.

void AAuraCharacter::InitAbilityActorInfo()
{
 	AbilitySystemComponent = AuraPlayerState->GetAbilitySystemComponent();
 	AbilitySystemComponent->InitAbilityActorInfo(AuraPlayerState, this);
 	AttributeSet = AuraPlayerState->GetAttributeSet();
 
 	// InitOverlay
 	// 멀티플레이어의 경우 플레이어블 캐릭터가 항상 Playercontroller를 들고있지는 않기때문에 ValidCheck을 하고 넘어가면
 	// 다른 클라이언트가 컨트롤 중인 플레이어 캐릭터에서 ASSERT가 발생할 수 있기때문에 if()로 valid 확인된 경우만 Init해주면 됨
 	if (APlayerController* PlayerController = GetController<APlayerController>())
 	{
 	// check(PlayerController) X , 마찬가지로 HUD도 1 플레이어한테만 있으니까 if() 체크만 하기
 		if (AAuraHUD* AuraHUD = PlayerController->GetHUD<AAuraHUD>())
 		{
 			AuraHUD->InitOverlay(PlayerController,AuraPlayerState,AbilitySystemComponent,AttributeSet);
 		}
 	}
}

---

바인딩과 델리게이트

델리게이트

컨트롤러에서 수행

OverlayWidgetController.h

 // Dynamic : BP(특히 WBP)에 사용할 것이므로
 // Multicast : 여러 Widget에 연결할 예정이므로
 DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnHealthChangedSignature,float,NewHealth);
 
 // BluprintAssignable : Multicast에 사용, 블루프린트에서 델리게이트가 노출되도록
 	UPROPERTY(BlueprintAssignable, Category="GAS|Attributes")
 	FOnHealthChangedSignature OnHealthChanged;
    
 // 콜백 함수들 만들기
 	// ASC에서 제공하는 델리게이트 사용하므로 양식 맞추기 (const FOnAttributeChangeData&) 
 	void HealthChanged(const FOnAttributeChangeData& Data) const;

OverlayWidgetController.cpp

void UOverlayWidgetController::BroadcastInitialValues()
 {
 	// AttributeSet 멤버가 확실히 할당된 이후에 브로드캐스팅된다는 것을 전제로 하므로 CastChecked 사용
 	UAuraAttributeSet* AuraAttributeSet = CastChecked<UAuraAttributeSet>(AttributeSet);
 	OnHealthChanged.Broadcast(AuraAttributeSet->GetHealth());
 }
 
 void UOverlayWidgetController::BindCallbacksToDependencies()
 {
 	UAuraAttributeSet* AuraAttributeSet = CastChecked<UAuraAttributeSet>(AttributeSet);
 
 	// ASC의 델리게이트 받아오기, Dynamic 델리게이트가 아니므로 AddUObject로 바인딩
 	// 바인딩할 어트리뷰트 구조체를 인자로 넣기
 	AbilitySystemComponent->GetGameplayAttributeValueChangeDelegate(
    AuraAttributeSet->GetHealthAttribute()) // 델리게이트 불러오고
 	.AddUObject(this,&UOverlayWidgetController::HealthChanged); // 바인딩 (오브젝트, 콜백함수)
 }
 
 void UOverlayWidgetController::HealthChanged(const FOnAttributeChangeData& Data) const
 {
 	OnHealthChanged.Broadcast(Data.NewValue);
 }

델리게이트 할당 예시

---

커밋

https://github.com/jongmin7759/Unreal_GAS/commit/f8daafac54a063629bf40d2d0af01b7b7dbc74b3
https://github.com/jongmin7759/Unreal_GAS/commit/db3f63fb9566ba3d6666d7cecd2644ef1f3eecc9