Project PT를 진행하면서 Unity에서 사용했던 UI 관리 방식을 Unreal 환경에 맞춰 변경하였다. 이 문서는 Unity에서 사용했던 UI 관리 방식과 Unreal에서 새롭게 적용한 방식을 정리한 문서이다.

기존 Unity UI 시스템 개요

• Unity 에서는 UI를 Stack기반으로 관리하여 이전 UI 상태를 추적하는 방식을 사용했다.
• UIManager가 UI 생성, 검색 및 제거를 직접 처리했다.

Uniyt에서 사용한 UI 구조

• UI 타입 구분

  UI 타입	설명	예시
  Static	항상 유지되는 UI (Stack으로 관리됨)	메인 로비, 설정 창, 캐릭터 상태창
  Dynamic	동적으로 생성되며 Stack으로 관리되지 않음	인벤토리, 퀘스트, UI, 아이템 정보창
  System	게임 전역에서 사용되는 UI	알림 메시지, 팝업 창

Unity에서 사용했던 UIManager 구조를 Unreal 에 맞게 변경하였다.

UIManagerSubsystem 도입

• Unity에서는 UIManager가 UI를 직접 관리했지만, Unreal에서는 UIManagerSubsystem 을 활용하여 UI를 중앙에서 관리

• 주요 코드

  void UUIManagerSubsystem::CreateLayoutWidget(UCommonLocalPlayer* LocalPlayer)
  {
      if (!LocalPlayer)
      {
          UE_LOG(LogTemp, Error, TEXT("[UIManageSubsystem]This PlayerController is Nullptr"));
          return;
      }
  
      if (CurrentWidgetClass == nullptr)
      {
          TSubclassOf<UCommonUserWidgetBase> WidgetClass = DefualtWidget.LoadSynchronous();
          RegisterWidget(WidgetClass);
      }
  
      check(CurrentWidgetClass);
      if (APlayerController* PlayerController = LocalPlayer->GetPlayerController(GetWorld()))
      {
          if (UCommonUserWidgetBase* NewWidgetBase = CreateWidget<UCommonUserWidgetBase>(PlayerController, CurrentWidgetClass))
          {
              CurrentWidget = NewWidgetBase;
              AddToLayoutViewport(LocalPlayer);
          }
      }
  }

GameplayTag 기반 UI 계층 구조

• GameplayTag를 사용하여 UI를 효율적으로 관리

  UI Layer
  ├── System UI (GameplayTag: UI.System)
  │   ├── 알림 메시지
  │   ├── 팝업 창
  │   └── 튜토리얼 UI
  ├── Static UI (GameplayTag: UI.Static)
  │   ├── 메인 로비 UI
  │   ├── 설정 창
  │   └── 캐릭터 상태창
  └── Dynamic UI (GameplayTag: UI.Dynamic)
      ├── 인벤토리 UI
      ├── 퀘스트 UI
      └── 아이템 정보창

• GameplayTag을 활용한 UI 탐색 및 등록

  void UCommonUserWidgetBase::RegisterLayer(FGameplayTag LayerTag, UCommonActivatableWidgetContainerBase* LayerWidget)
  {
      if (!IsDesignTime())
      {
          LayerWidget->SetTransitionDuration(0.0);
          Layers.Add(LayerTag, LayerWidget);
      }
  }

UI 재사용을 위한 캐싱

• 비활성화된 UI를 캐싱하여 불필요한 UI 객체 생성 방지

• UI 상태 저장 → 비활성화 전 상태 복원 가능

  void UCommonActivatableWidgetBase::NativeOnDeactivated()
  {
      Super::NativeOnDeactivated();
  
      if (!CacheWidgets.IsEmpty())
      {
          for (FUserWidgetData& WidgetInfo : CacheWidgets)
          {
              if (WidgetInfo.IsActivated())
              {
                  PrevVisibleWidgets.Add(WidgetInfo);
                  WidgetInfo.SetActiveWidget(false);
              }
          }
      }
  }