✍️Today I Learned

📅 2025-09-09

• Lyra - CommonUI

Lyra - CommonUI

CommonUI: UMG를 한 번 더 매핑한 플러그인. 쓸 부분만 쓰기

UIPolicy: UI 설정 방식 결정. UI를 진짜 관리

→ 다른 레이아웃 쓰려면 이거 만들어서 GameUIManagerSubsystem에 등록

Primary Layout

• 제일 먼저 정의해야 함
• 몇가지 레이아웃(메뉴, 인게임, 팝업 등)을 가질 지 정의
• Common Activatable Widget Stack
  • 가장 최근 위젯 먼저 제거하기 위해 Stack 사용
  • 레이아웃 4개 생성 - GameLayer, GameMenu(게임), Menu(설정), Modal(팝업)
  • RegisterLayer 로 게임플레이 태그와 레이아웃 매핑

어떤 레이아웃인지 - 태그, 해당 레이아웃 안에 어떤 UIExtension(위젯)이 들어가는지 - 태그

레이아웃 안에 위젯 세팅 → Game Feature Action 사용 (Add Widget)

UIExtension

• ExtensionPointTag : 위젯의 태그
• Data < UObject> : 위젯 클래스
• ContextObject < UObject> : 위젯 소유자

UIExtensionHandle

• Subsystem
• UIExtension

Layout, UIExtension 관리 구조

Layout 관리

• GameUIManagerSubsystem → UIPolicy → Layout

UIExtension 관리

• UIExtensionSystem → UIExtension

GameFeature_AddWidget

프라이머리 레이아웃에 원하는 레이아웃 넣고 그 레이아웃의 UIExtension에 어떤 위젯을 장착할지 태그로 결정

FLyraHUDLayoutRequest

• LayoutClass <UCommonActivatableWidget> : 프라이머리 레이아웃에 넣을 위젯
• LayerID : 프라이머리 레이아웃에 등록할 태그

FLyraHUDElementEntry

• WidgetClass <UUserWidget>: 레이아웃에 들어갈 위젯
• SlotID : LayoutClass에 정의된 슬롯의 태그

GameFeatureAction_AddWidgets의 작동 흐름

1. AddToWorld: Game Feature가 활성화되면 이 함수가 호출됩니다. 여기서는 UGameFrameworkComponentManager에 핸들러를 등록합니다. 이 핸들러는 특정 액터(여기서는 ALyraHUD)에서 특정 이벤트가 발생할 때 HandleActorExtension 함수를 호출하도록 설정됩니다.
2. HandleActorExtension: 이 함수는 ALyraHUD에서 UGameFrameworkComponentManager::NAME_GameActorReady 이벤트가 수신되면 호출됩니다. 이 이벤트가 바로 *LyraHUD::BeginPlay()에서 보낸 이벤트입니다.
3. AddWidgets: HandleActorExtension 함수는 이벤트 이름이 NAME_GameActorReady인 경우 AddWidgets 함수를 호출합니다. 이 함수에서 실제로 위젯을 HUD에 추가하는 로직이 실행됩니다.

요약하자면, ALyraHUD::BeginPlay()는 "나 준비됐어!"라는 신호를 보내고, GameFeatureAction_AddWidgets는 그 신호를 받아서 "알았어, 그럼 내가 위젯을 추가해 줄게"라고 응답하는 구조입니다. 이러한 분리된 이벤트 기반 방식은 시스템의 유연성과 확장성을 크게 향상시킵니다.

Common Activatable Widget

• 런타임 중 Activate/Deactivate 가능
• Input 처리 방식 커스텀

Assetbundle : client, server 표시해서 필요한 것들만 로딩

TobjectPtr은 번들로 등록하지 않아도 항상 가져옴. 클라이언트나 서버 상관없이 항상 필요한 것들은 objectPtr로 설정

위젯은 클라이언트에서만 필요하고 서버는 없어도 되므로 TSoftClassPtr로 설정함. 그러면 클라이언트만 가져오도록 설정해야함

UIExtensionPoint

1. 서브시스템에서 관련 태그로 extension point를 찾고 매치 기준 확인 (태그 일치, 허용된 위젯 클래스)
2. 기준에 맞으면 델리게이트를 통해서 ExtensionPoint 위젯에 장착

서브시스템에서 UIExtensionPointHandle로 관리

• UIExtensionSubsystem : 핸들을 통해서 서브시스템에 접근할 수 있음
• UIExtensionPoint

---

💡 느낀 점 (What I Felt)

한 번 잘 이해하면 유용하게 쓸 수 있을 것 같다.

---