✍️Today I Learned

📅 2025-11-19

• 위젯 스위처를 활용한 UI 상태 관리
• Toggle 패턴으로 UI Open/Close 통합
• ESC 키 우선순위 기반 UI 닫기 로직
• UInterface를 통한 블루프린트-C++ 데이터 전달
• 방어적 프로그래밍으로 UI 상태 관리

---

위젯 스위처를 활용한 UI 상태 관리

핵심 개념

Visibility를 직접 바꾸지 말고 SetActiveWidgetIndex()만 사용해서 UI 전환

구조 설계

// WidgetSwitcher_Backpack
enum EBackpackWidgetIndex {
    Empty_Backpack = 0,
    PlayerInventory = 1
};

// WidgetSwitcher_Content  
enum EContentWidgetIndex {
    Empty_Content = 0,
    Container = 1,
    BuildingMode = 2,
    CraftingMode = 3,
    Settings = 4
};

장점

• 코드가 간결해짐 (Visibility 제어 불필요)
• enum으로 가독성 향상
• 각 스위처는 독립적으로 동작

---

Toggle 패턴으로 UI Open/Close 통합

사용자 입력(E키)키 하나로 UI Open/Close 통합 관리

void ToggleContainer(AContainerActor* Container) {
    // 같은 상자면 닫기
    if (CurrentContainer == Container) {
        CloseCurrentContainer();
        return;
    }
    // 다른 상자면 교체
    // ...
}

---

ESC 키 우선순위 기반 UI 닫기 로직

요구사항

• ESC로 UI 단계적으로 닫기
• 아무것도 없으면 환경설정 열기

구현

void HandleEscapeKey() {
    // 1순위: 환경설정 닫기
    if (bIsSettingsOpen) {
        CloseSettings();
        return;
    }
    
    // 2순위: 게임 UI 모두 닫기
    if (IsAnyUIOpen()) {
        CloseAllGameUI();
        return;
    }
    
    // 3순위: 환경설정 열기
    OpenSettings();
}

---

UInterface를 통한 블루프린트-C++ 데이터 전달

문제

블루프린트로 만든 위젯에 C++의 컨테이너 인벤토리 데이터를 어떻게 전달할까?

해결: UInterface 사용

// C++ 인터페이스 정의
UINTERFACE(Blueprintable)
class UIInventoryWidget : public UInterface {
    GENERATED_BODY()
};

class IIInventoryWidget {
    GENERATED_BODY()
public:
    UFUNCTION(BlueprintNativeEvent, BlueprintCallable)
    void SetInventoryData(UTSInventoryMasterComponent* Inventory);
};

// C++에서 호출
if (ContainerWidget->Implements<UIInventoryWidget>()) {
    IIInventoryWidget::Execute_SetInventoryData(
        ContainerWidget, 
        ContainerInventory
    );
}

블루프린트 연결

1. 위젯 블루프린트 Class Settings에서 인터페이스 추가
2. Event Graph에서 SetInventoryData 이벤트 구현
3. 전달받은 데이터로 슬롯 UI 생성

---

방어적 프로그래밍으로 UI 상태 관리

발견한 버그

// 문제 시나리오
1. 상자 열림 (타이머 실행 중)
2. 환경설정 버튼 클릭
3. 환경설정 닫음
4. CurrentContainer가 남아있고 타이머도 실행 중!

해결

void CloseSettings() {
    bIsSettingsOpen = false;
    
    // ✅ 혹시 남은 상태 정리
    CloseCurrentContainer();  // nullptr이면 바로 return
    
    UpdateInputMode();
}

void OpenSettings() {
    // ✅ 열기 전에 게임 UI 정리
    if (IsAnyUIOpen()) {
        CloseAllGameUI();
    }
    // ...
}

---

💡 느낀 점 (What I Felt)

UI 시스템을 설계하면서 "사용자가 어떤 순서로 버튼을 누를지 모른다"는 걸 체감했다. 처음엔 정상적인 경로만 생각했는데, 상자 열고 → 설정 열고 → 설정 닫으면 상자 타이머가 남아있는 버그를 발견했다.

방어적 프로그래밍의 중요성을 깨달았다. 특히 UI처럼 상태가 복잡한 시스템에서는 각 함수가 "들어올 때 상태 확인, 나갈 때 정리"를 철저히 해야 한다.

---