ADailyKiosk 클래스 참조

Daily Study Kiosk 더 자세히 ...

#include <ADailyKiosk.h>

ADailyKiosk에 대한 상속 다이어그램 :

ADailyKiosk에 대한 협력 다이어그램:

Public 멤버 함수
	ADailyKiosk ()
class UWidgetComponent *	GetWidgetComp ()

Protected 멤버 함수
virtual void	BeginPlay () override

Protected 속성
TObjectPtr< class UBoxComponent >	BoxComp
TObjectPtr< class UInteractableComponent >	InteractableComp
TObjectPtr< class UStaticMeshComponent >	MeshComp
TObjectPtr< class USceneComponent >	RootSceneComp
TObjectPtr< class UWidgetComponent >	WidgetComp
TObjectPtr< class UWidgetComponent >	WidgetGuideComp

Private 멤버 함수
TArray< FWordData >	GetRandomKoreanWords (int32 Count)
	랜덤 한국어 단어 데이터 가져오기 (Fallback용)
void	OnInteractionTriggered (AActor *Interactor)
void	OnOutlineStateChanged (bool bShouldShowOutline)
void	OnResponseDailyQuestion (FResponseChatDailys &InResponseData, bool bWasSuccessful)

상세한 설명

Daily Study Kiosk

사용자가 상호작용하면 ChatDaily API를 통해 "오늘의 한국어 문장 5개 주세요"를 요청하고 응답이 오면 Popup_DailyStudy를 띄웁니다.

ADailyKiosk.h 파일의 18 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

ADailyKiosk()

ADailyKiosk::ADailyKiosk

(

)

ADailyKiosk.cpp 파일의 19 번째 라인에서 정의되었습니다.

{
    PrimaryActorTick.bCanEverTick = false;
 
    RootSceneComp = CreateDefaultSubobject<USceneComponent>(TEXT("RootSceneComp"));
    SetRootComponent(RootSceneComp);
 
    MeshComp = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("MeshComp"));
    MeshComp->SetupAttachment(RootComponent);
 
    InteractableComp = CreateDefaultSubobject<UInteractableComponent>(TEXT("Interactable"));
    InteractableComp->InteractionType = EInteractionType::Kiosk;
    InteractableComp->InteractionPrompt = TEXT("Activate");
 
    BoxComp = CreateDefaultSubobject<UBoxComponent>(TEXT("BoxComp"));
    BoxComp->SetupAttachment(GetRootComponent());
    BoxComp->SetRelativeLocation(FVector(0, 36, 75));
    BoxComp->SetBoxExtent(FVector(60, 65, 92));
 
    WidgetComp = CreateDefaultSubobject<UWidgetComponent>(TEXT("WidgetComp"));
    ConstructorHelpers::FClassFinder<UInteractWidget> WidgetRef(DAILYKIOSK_INTERACT_WIDGET_PATH);
    if (WidgetRef.Succeeded())
    {
        WidgetComp->SetWidgetClass(WidgetRef.Class);
        WidgetComp->SetupAttachment(GetRootComponent());
        WidgetComp->SetWidgetSpace(EWidgetSpace::Screen);
        WidgetComp->SetDrawSize(FVector2D(2048.0f, 1024.0f));
    }
}

다음을 참조함 : BoxComp, DAILYKIOSK_INTERACT_WIDGET_PATH, InteractableComp, MeshComp, RootSceneComp, WidgetComp.

멤버 함수 문서화

BeginPlay()

void ADailyKiosk::BeginPlay ( )

overrideprotectedvirtual

ADailyKiosk.cpp 파일의 49 번째 라인에서 정의되었습니다.

{
    Super::BeginPlay();
 
    // 델리게이트 바인딩
    InteractableComp->InitWidget(WidgetComp);
    InteractableComp->OnInteractionTriggered.AddDynamic(this, &ADailyKiosk::OnInteractionTriggered);
    InteractableComp->OnOutlineStateChanged.AddDynamic(this, &ADailyKiosk::OnOutlineStateChanged);
}

다음을 참조함 : InteractableComp, OnInteractionTriggered(), OnOutlineStateChanged(), WidgetComp.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

GetRandomKoreanWords()

TArray< FWordData > ADailyKiosk::GetRandomKoreanWords ( int32  Count )

private

랜덤 한국어 단어 데이터 가져오기 (Fallback용)

ADailyKiosk.cpp 파일의 165 번째 라인에서 정의되었습니다.

{
    TArray<FWordData> RandomWordDataArray;
 
    UGameDataManager* DataManager = UGameDataManager::Get(GetWorld());
    if (!DataManager)
    {
        PRINTLOG(TEXT("[DailyKiosk] Error: GameDataManager not found"));
        return RandomWordDataArray;
    }
 
    // ReadData에서 모든 키 가져오기
    TArray<int32> AllKeys = DataManager->GetAllReadDataKeys();
 
    if (AllKeys.Num() == 0)
    {
        PRINTLOG(TEXT("[DailyKiosk] Error: No ReadData available"));
        return RandomWordDataArray;
    }
 
    // 요청한 개수만큼 랜덤 단어 선택
    int32 WordsToGenerate = FMath::Min(Count, AllKeys.Num());
 
    for (int32 i = 0; i < WordsToGenerate; ++i)
    {
        // 랜덤 인덱스 선택
        int32 RandomIndex = FMath::RandRange(0, AllKeys.Num() - 1);
        int32 RandomKey = AllKeys[RandomIndex];
        AllKeys.RemoveAt(RandomIndex); // 중복 방지
 
        // 데이터 로드
        FReadData ReadData;
        if (DataManager->GetReadData(RandomKey, ReadData))
        {
            // FWordData 생성
            FWordData WordData;
            WordData.Kor = ReadData.Word;
            WordData.Eng = ReadData.Eng;
            WordData.Pronunciation = ReadData.Eng; // TODO: 나중에 실제 발음 데이터로 교체
 
            RandomWordDataArray.Add(WordData);
        }
    }
 
    PRINTLOG(TEXT("[DailyKiosk] Generated %d random word data from ReadData"), RandomWordDataArray.Num());
    return RandomWordDataArray;
}

다음을 참조함 : FReadData::Eng, FWordData::Eng, UGameDataManager::GetAllReadDataKeys(), UGameDataManager::GetReadData(), FWordData::Kor, PRINTLOG, FWordData::Pronunciation, FReadData::Word.

다음에 의해서 참조됨 : OnResponseDailyQuestion().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetWidgetComp()

class UWidgetComponent * ADailyKiosk::GetWidgetComp ( )

inline

ADailyKiosk.h 파일의 25 번째 라인에서 정의되었습니다.

{ return WidgetComp; };

다음에 의해서 참조됨 : UPopup_DailyResult::OnClickConfirm().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnInteractionTriggered()

void ADailyKiosk::OnInteractionTriggered ( AActor *  Interactor )

private

ADailyKiosk.cpp 파일의 59 번째 라인에서 정의되었습니다.

{
    // ChatDaily API 요청
    if (auto KLingoNetwork = UKLingoNetworkSystem::Get(GetWorld()))
    {
        PRINTLOG(TEXT("[DailyKiosk] Requesting daily question..."));
        KLingoNetwork->RequestDailyQuestion(
            DefineData::DailySystemPrompt,
            DefineData::DailyUserPrompt,
            FResponseChatDailysDelegate::CreateUObject(this, &ADailyKiosk::OnResponseDailyQuestion)
        );
    }
}

다음을 참조함 : DefineData::DailySystemPrompt, DefineData::DailyUserPrompt, OnResponseDailyQuestion(), PRINTLOG.

다음에 의해서 참조됨 : BeginPlay().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnOutlineStateChanged()

void ADailyKiosk::OnOutlineStateChanged ( bool  bShouldShowOutline )

private

ADailyKiosk.cpp 파일의 157 번째 라인에서 정의되었습니다.

{
    if (MeshComp)
    {
        MeshComp->SetRenderCustomDepth(bShouldShowOutline);
    }
}

다음을 참조함 : MeshComp.

다음에 의해서 참조됨 : BeginPlay().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OnResponseDailyQuestion()

void ADailyKiosk::OnResponseDailyQuestion ( FResponseChatDailys &  InResponseData, bool  bWasSuccessful  )

private

ADailyKiosk.cpp 파일의 73 번째 라인에서 정의되었습니다.

{
    if (!bWasSuccessful)
    {
        PRINTLOG(TEXT("[DailyKiosk] Network request failed. Using fallback word data."));
 
        // 네트워크 실패 시 랜덤 단어 데이터로 대체
        TArray<FWordData> FallbackWordData = GetRandomKoreanWords(DefineData::MIN_REQUIRED_WORDS);
 
        if (FallbackWordData.Num() > 0)
        {
            if (UPopup_DailyStudy* DailyStudyPopup = UPopupManager::Get(GetWorld())->ShowPopupAs<UPopup_DailyStudy>(EPopupType::DailyStudy))
            {
                DailyStudyPopup->InitPopup(FallbackWordData);
            }
        }
        else
        {
            PRINTLOG(TEXT("[DailyKiosk] ERROR: No fallback data available!"));
        }
 
        return;
    }
 
    // AI 응답을 | 구분자로 파싱 (형식: "개|DOG|Gae|고양이|CAT|Go-yang-i")
    TArray<FString> RawTokens;
    InResponseData.answer.ParseIntoArray(RawTokens, TEXT("|"), true);
 
    // 3개씩 묶어서 FWordData로 변환 (Kor|Eng|Pronunciation)
    TArray<FWordData> ValidWordDataArray;
    for (int32 i = 0; i + 2 < RawTokens.Num(); i += 3)
    {
        FString Kor = RawTokens[i].TrimStartAndEnd();
        FString Eng = RawTokens[i + 1].TrimStartAndEnd();
        FString Pronunciation = RawTokens[i + 2].TrimStartAndEnd();
 
        // 빈 문자열 체크
        if (Kor.IsEmpty() || Eng.IsEmpty() || Pronunciation.IsEmpty())
        {
            PRINTLOG(TEXT("[DailyKiosk] Skipped: Empty field (Kor: '%s', Eng: '%s', Phon: '%s')"), *Kor, *Eng, *Pronunciation);
            continue;
        }
 
        // 한국어 검증 (Kor 필드만)
        if (!UCommonFunctionLibrary::IsValidKoreanWord(Kor))
        {
            PRINTLOG(TEXT("[DailyKiosk] Skipped: Invalid Korean word '%s'"), *Kor);
            continue;
        }
 
        // FWordData 생성
        FWordData WordData;
        WordData.Kor = Kor;
        WordData.Eng = Eng;
        WordData.Pronunciation = Pronunciation;
 
        ValidWordDataArray.Add(WordData);
        PRINTLOG(TEXT("[DailyKiosk] Parsed Word: Kor='%s', Eng='%s', Phon='%s'"), *Kor, *Eng, *Pronunciation);
    }
 
    // 유효한 단어가 부족하면 GameDataManager에서 보충
    if (ValidWordDataArray.Num() < DefineData::MIN_REQUIRED_WORDS)
    {
        int32 WordsNeeded = DefineData::MIN_REQUIRED_WORDS - ValidWordDataArray.Num();
 
        TArray<FWordData> AdditionalWordData = GetRandomKoreanWords(WordsNeeded);
        ValidWordDataArray.Append(AdditionalWordData);
    }
 
    // 최종 검증 및 팝업 표시
    if (ValidWordDataArray.Num() > 0)
    {
        if (UPopup_DailyStudy* DailyStudyPopup = UPopupManager::Get(GetWorld())->ShowPopupAs<UPopup_DailyStudy>(EPopupType::DailyStudy))
        {
            DailyStudyPopup->InitPopup(ValidWordDataArray);
            PRINTLOG(TEXT("[DailyKiosk] Initialized DailyStudy popup with %d words"), ValidWordDataArray.Num());
        }
    }
    else
    {
        PRINTLOG(TEXT("[DailyKiosk] ERROR: No valid word data!"));
    }
}

다음을 참조함 : FResponseChatDailys::answer, FWordData::Eng, GetRandomKoreanWords(), UCommonFunctionLibrary::IsValidKoreanWord(), FWordData::Kor, DefineData::MIN_REQUIRED_WORDS, PRINTLOG, FWordData::Pronunciation.

다음에 의해서 참조됨 : OnInteractionTriggered().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

BoxComp

TObjectPtr<class UBoxComponent> ADailyKiosk::BoxComp

protected

ADailyKiosk.h 파일의 56 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ADailyKiosk().

InteractableComp

TObjectPtr<class UInteractableComponent> ADailyKiosk::InteractableComp

protected

ADailyKiosk.h 파일의 53 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ADailyKiosk(), BeginPlay().

MeshComp

TObjectPtr<class UStaticMeshComponent> ADailyKiosk::MeshComp

protected

ADailyKiosk.h 파일의 47 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ADailyKiosk(), OnOutlineStateChanged().

RootSceneComp

TObjectPtr<class USceneComponent> ADailyKiosk::RootSceneComp

protected

ADailyKiosk.h 파일의 44 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ADailyKiosk().

WidgetComp

TObjectPtr<class UWidgetComponent> ADailyKiosk::WidgetComp

protected

ADailyKiosk.h 파일의 59 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ADailyKiosk(), BeginPlay().

WidgetGuideComp

TObjectPtr<class UWidgetComponent> ADailyKiosk::WidgetGuideComp

protected

ADailyKiosk.h 파일의 50 번째 라인에서 정의되었습니다.

---

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

• Source/Onepiece/Interactable/Public/ADailyKiosk.h
• Source/Onepiece/Interactable/Private/ADailyKiosk.cpp