#include <ChatInputBox.h>

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

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

Public 멤버 함수
bool	HasKeyboardFocus ()

virtual void	NativeOnInitialized () override

virtual FReply	NativeOnPreviewKeyDown (const FGeometry &InGeometry, const FKeyEvent &InKeyEvent) override

virtual void	NativeTick (const FGeometry &MyGeometry, float InDeltaTime) override

void	SetInputFocus (bool bFocus)

void	SetOwningChatWidget (class UChatWidget *InChatWidget)

Public 속성
TObjectPtr< class UButton >	Button_Send

TObjectPtr< class UMultiLineEditableTextBox >	MultiLineEditableTextBox_Input

Private 멤버 함수
FText	FlushMessage ()

TArray< struct FWordData >	GetRandomKoreanWords (int32 Count)
	GameDataManager에서 랜덤 한국어 단어 데이터 가져오기 (FWordData 형태)

void	HandleSendClicked ()

bool	IsAIAsk (const FString &InMessage, FString &OutQuestion) const

bool	IsDailyAsk (const FString &InMessage, FString &OutQuestion) const

void	OnDailyAnswerReceived (FResponseChatDailys &ResponseData, bool bWasSuccessful)

Private 속성
bool	bWasFocused = false

TObjectPtr< class UChatWidget >	OwningChatWidget = nullptr

상세한 설명

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

멤버 함수 문서화

◆ FlushMessage()

FText UChatInputBox::FlushMessage ( )

private

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

{
    // message에 저장 & 텍스트 칸 비우기
    FText message = MultiLineEditableTextBox_Input->GetText();
    
    MultiLineEditableTextBox_Input->SetText(FText::GetEmpty());
    
    return message;
}

다음을 참조함 : MultiLineEditableTextBox_Input.

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

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

◆ GetRandomKoreanWords()

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

private

GameDataManager에서 랜덤 한국어 단어 데이터 가져오기 (FWordData 형태)

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

{
    TArray<FWordData> RandomWordDataArray;
 
    UGameDataManager* DataManager = UGameDataManager::Get(GetWorld());
    if (!DataManager)
    {
        PRINTLOG(TEXT("[Daily] Error: GameDataManager not found"));
        return RandomWordDataArray;
    }
 
    // ReadData에서 모든 키 가져오기
    TArray<int32> AllKeys = DataManager->GetAllReadDataKeys();
    
    if (AllKeys.Num() == 0)
    {
        PRINTLOG(TEXT("[Daily] 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 생성 (ReadData에는 Pronunciation이 없으므로 Eng로 임시 설정)
            FWordData WordData;
            WordData.Kor = ReadData.Word;
            WordData.Eng = ReadData.Eng;
            WordData.Pronunciation = ReadData.Eng; // TODO: 나중에 실제 발음 데이터로 교체
            
            RandomWordDataArray.Add(WordData);
        }
    }
 
    PRINTLOG(TEXT("[Daily] 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.

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

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

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

◆ HandleSendClicked()

void UChatInputBox::HandleSendClicked ( )

private

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

{
    // 텍스트가 비어있지 않다면 처리
    FText Message = FlushMessage();
    if (Message.IsEmpty())
    {
        // 빈 메시지면 포커스만 해제
        SetInputFocus(false);
        return;
    }
 
    auto* PC = Cast<APlayerControl>(GetWorld()->GetFirstPlayerController());
    if (!PC)
        return;
 
    const FString MessageStr = Message.ToString();
    FString CleanQuestion;
 
    if (IsAIAsk(MessageStr, CleanQuestion))
    {
        // 사용자가 입력한 전체 메시지 표시 (로그성)
        PC->ServerRPC_SendChat(Message);
 
        // AI에게 정제된 질문 전송
        PC->ServerRPC_SendAIQuestion(CleanQuestion);
 
        PRINTLOG(TEXT("[AI Chat] User question: %s"), *CleanQuestion);
    }
    else if (IsDailyAsk(MessageStr, CleanQuestion))
    {
        // Daily 단어 생성 요청
        if (UKLingoNetworkSystem* NetworkSystem = UKLingoNetworkSystem::Get(GetWorld()))
        {
            NetworkSystem->RequestDailyQuestion(DefineData::DailySystemPrompt, CleanQuestion,
                FResponseChatDailysDelegate::CreateUObject(this, &UChatInputBox::OnDailyAnswerReceived));
 
            PRINTLOG(TEXT("[Daily] Word generation request: %s"), *CleanQuestion);
        }
    }
    else
    {
        // 2. 일반 채팅 메시지 전송
        PC->ServerRPC_SendChat(Message);
    }
 
    // 메시지 전송 후 포커스 해제 및 게임 모드로 복원
    SetInputFocus(false);
 
}

다음을 참조함 : DefineData::DailySystemPrompt, FlushMessage(), IsAIAsk(), IsDailyAsk(), OnDailyAnswerReceived(), PRINTLOG, SetInputFocus().

다음에 의해서 참조됨 : NativeOnInitialized(), NativeOnPreviewKeyDown().

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

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

◆ HasKeyboardFocus()

bool UChatInputBox::HasKeyboardFocus ( )

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

{
    return MultiLineEditableTextBox_Input && MultiLineEditableTextBox_Input->HasKeyboardFocus();
}

다음을 참조함 : MultiLineEditableTextBox_Input.

◆ IsAIAsk()

bool UChatInputBox::IsAIAsk	(	const FString &	InMessage,
		FString &	OutQuestion
	)		const

private

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

{
    FString LeftPart, RightPart;
 
    // 콜론(:)을 기준으로 분리
    if (InMessage.Split(TEXT(":"), &LeftPart, &RightPart))
    {
        // 왼쪽 파트의 공백을 제거하고 "AI"와 일치하는지 확인 (대소문자 무시)
        if (LeftPart.TrimStartAndEnd().Equals(DefineData::AI, ESearchCase::IgnoreCase))
        {
            OutQuestion = RightPart.TrimStart();
            return !OutQuestion.IsEmpty(); // 내용이 비어있지 않아야 true
        }
    }
    return false;
}

다음을 참조함 : DefineData::AI.

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

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

◆ IsDailyAsk()

bool UChatInputBox::IsDailyAsk	(	const FString &	InMessage,
		FString &	OutQuestion
	)		const

private

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

{
    FString LeftPart, RightPart;
 
    if (InMessage.Split(TEXT(":"), &LeftPart, &RightPart))
    {
        if (LeftPart.TrimStartAndEnd().Equals(DefineData::Daily, ESearchCase::IgnoreCase))
        {
            OutQuestion = RightPart.TrimStart();
            return !OutQuestion.IsEmpty(); // 내용이 비어있지 않아야 true
        }
    }
    return false;
}

다음을 참조함 : DefineData::Daily.

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

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

◆ NativeOnInitialized()

void UChatInputBox::NativeOnInitialized ( )

overridevirtual

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

{
    Super::NativeOnInitialized();
 
    Button_Send->OnClicked.AddDynamic(this, &UChatInputBox::HandleSendClicked);
}

다음을 참조함 : Button_Send, HandleSendClicked().

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

◆ NativeOnPreviewKeyDown()

FReply UChatInputBox::NativeOnPreviewKeyDown	(	const FGeometry &	InGeometry,
		const FKeyEvent &	InKeyEvent
	)

overridevirtual

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

{
    // Enter 키 감지 & Shift+Enter는 줄바꿈 허용
    if (InKeyEvent.GetKey() == EKeys::Enter && !InKeyEvent.IsShiftDown())
    {
        HandleSendClicked();
        return FReply::Handled();
    }
 
    // ESC 키로 포커스 해제
    if (InKeyEvent.GetKey() == EKeys::Escape)
    {
        SetInputFocus(false);
        return FReply::Handled();
    }
 
    return Super::NativeOnPreviewKeyDown(InGeometry, InKeyEvent);
}

다음을 참조함 : HandleSendClicked(), SetInputFocus().

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

◆ NativeTick()

void UChatInputBox::NativeTick	(	const FGeometry &	MyGeometry,
		float	InDeltaTime
	)

overridevirtual

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

{
    Super::NativeTick(MyGeometry, InDeltaTime);
 
    // 현재 포커스 상태 확인
    bool bIsFocused = MultiLineEditableTextBox_Input && MultiLineEditableTextBox_Input->HasKeyboardFocus();
 
    // 포커스 상태 변화 감지
    if (bWasFocused != bIsFocused)
    {
        PRINTLOG(TEXT("[ChatInputBox] Focus changed: %d -> %d"), bWasFocused, bIsFocused);
 
        // 포커스를 잃었을 때만 처리 (화면 클릭 등)
        if (bWasFocused && !bIsFocused)
        {
            PRINTLOG(TEXT("[ChatInputBox] Focus lost - switching to GameOnly mode"));
 
            // GameOnly 모드로 전환
            if (APlayerControl* PC = Cast<APlayerControl>(GetOwningPlayer()))
            {
                FInputModeGameOnly InputMode;
                PC->SetInputMode(InputMode);
                PC->SetShowMouseCursor(false);
                FSlateApplication::Get().SetAllUserFocusToGameViewport();
            }
 
            // ChatWidget에 포커스 해제 알림
            if (OwningChatWidget)
            {
                PRINTLOG(TEXT("[ChatInputBox] Notifying ChatWidget of focus loss"));
                OwningChatWidget->OnInputFocusChanged(false);
            }
            else
            {
                PRINTLOG(TEXT("[ChatInputBox] ERROR: OwningChatWidget is null!"));
            }
        }
    }
 
    bWasFocused = bIsFocused;
}

다음을 참조함 : bWasFocused, MultiLineEditableTextBox_Input, OwningChatWidget, PRINTLOG.

◆ OnDailyAnswerReceived()

void UChatInputBox::OnDailyAnswerReceived	(	FResponseChatDailys &	ResponseData,
		bool	bWasSuccessful
	)

private

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

{
    const int32 MIN_REQUIRED_WORDS = 3;
 
    if (!bWasSuccessful)
    {
        // 네트워크 실패 시 랜덤 단어 데이터로 대체
        TArray<FWordData> FallbackWordData = GetRandomKoreanWords(MIN_REQUIRED_WORDS);
        
        if (FallbackWordData.Num() > 0)
        {
            if (UPopup_DailyStudy* DailyStudyPopup = UPopupManager::Get(GetWorld())->ShowPopupAs<UPopup_DailyStudy>(EPopupType::DailyStudy))
            {
                DailyStudyPopup->InitPopup(FallbackWordData);
            }
        }
 
        return;
    }
 
    // AI 응답을 | 구분자로 파싱 (형식: "개|DOG|Gae|고양이|CAT|Go-yang-i")
    TArray<FString> RawTokens;
    ResponseData.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("[Daily] Skipped: Empty field (Kor: '%s', Eng: '%s', Phon: '%s')"), *Kor, *Eng, *Pronunciation);
            continue;
        }
 
        // 한국어 검증 (Kor 필드만)
        if (!UCommonFunctionLibrary::IsValidKoreanWord(Kor))
        {
            PRINTLOG(TEXT("[Daily] Skipped: Invalid Korean word '%s'"), *Kor);
            continue;
        }
 
        // FWordData 생성
        FWordData WordData;
        WordData.Kor = Kor;
        WordData.Eng = Eng;
        WordData.Pronunciation = Pronunciation;
 
        ValidWordDataArray.Add(WordData);
        PRINTLOG(TEXT("[Daily] Parsed Word: Kor='%s', Eng='%s', Phon='%s'"), *Kor, *Eng, *Pronunciation);
    }
 
    // 유효한 단어가 부족하면 GameDataManager에서 보충
    if (ValidWordDataArray.Num() < MIN_REQUIRED_WORDS)
    {
        int32 WordsNeeded = MIN_REQUIRED_WORDS - ValidWordDataArray.Num();
 
        TArray<FWordData> AdditionalWordData = GetRandomKoreanWords(WordsNeeded);
        ValidWordDataArray.Append(AdditionalWordData);
 
        PRINTLOG(TEXT("[Daily] Added %d fallback words from ReadData"), AdditionalWordData.Num());
    }
 
    // 최종 검증 및 팝업 표시
    if (ValidWordDataArray.Num() > 0)
    {
        if (UPopup_DailyStudy* DailyStudyPopup = UPopupManager::Get(GetWorld())->ShowPopupAs<UPopup_DailyStudy>(EPopupType::DailyStudy))
        {
            DailyStudyPopup->InitPopup(ValidWordDataArray);
            PRINTLOG(TEXT("[Daily] Initialized DailyStudy popup with %d words"), ValidWordDataArray.Num());
        }
    }
}

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

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

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

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

◆ SetInputFocus()

void UChatInputBox::SetInputFocus ( bool bFocus )

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

{
    if ( bFocus )
    {
        // 먼저 포커스 설정
        MultiLineEditableTextBox_Input->SetKeyboardFocus();
 
        // UI 입력 모드로 전환
        if (APlayerControl* PC = Cast<APlayerControl>(GetOwningPlayer()))
        {
            FInputModeUIOnly InputMode;
            InputMode.SetWidgetToFocus(MultiLineEditableTextBox_Input->TakeWidget());
            PC->SetInputMode(InputMode);
            PC->SetShowMouseCursor(true);
        }
 
        // ChatWidget에 포커스 획득 알림
        if (OwningChatWidget)
        {
            OwningChatWidget->OnInputFocusChanged(true);
        }
 
        bWasFocused = true;
    }
    else
    {
        // GameOnly 모드로 전환 및 포커스 해제
        if (APlayerControl* PC = Cast<APlayerControl>(GetOwningPlayer()))
        {
            FInputModeGameOnly InputMode;
            PC->SetInputMode(InputMode);
            PC->SetShowMouseCursor(false);
 
            // 뷰포트로 포커스 이동 (자동으로 입력창 포커스 해제됨)
            FSlateApplication::Get().SetAllUserFocusToGameViewport();
        }
 
        // ChatWidget에 포커스 해제 알림
        if (OwningChatWidget)
        {
            OwningChatWidget->OnInputFocusChanged(false);
        }
 
        bWasFocused = false;
    }
}

다음을 참조함 : bWasFocused, MultiLineEditableTextBox_Input, OwningChatWidget.

다음에 의해서 참조됨 : HandleSendClicked(), NativeOnPreviewKeyDown().

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

◆ SetOwningChatWidget()

void UChatInputBox::SetOwningChatWidget ( class UChatWidget * InChatWidget )

inline

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

24{ OwningChatWidget = InChatWidget; }

멤버 데이터 문서화

◆ Button_Send

TObjectPtr<class UButton> UChatInputBox::Button_Send

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

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

◆ bWasFocused

bool UChatInputBox::bWasFocused = false

private

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

다음에 의해서 참조됨 : NativeTick(), SetInputFocus().

◆ MultiLineEditableTextBox_Input

TObjectPtr<class UMultiLineEditableTextBox> UChatInputBox::MultiLineEditableTextBox_Input

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

다음에 의해서 참조됨 : FlushMessage(), HasKeyboardFocus(), NativeTick(), SetInputFocus().

◆ OwningChatWidget

TObjectPtr<class UChatWidget> UChatInputBox::OwningChatWidget = nullptr

private

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

다음에 의해서 참조됨 : NativeTick(), SetInputFocus().

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

Source/Onepiece/UI/Public/ChatInputBox.h
Source/Onepiece/UI/Private/ChatInputBox.cpp

Public 멤버 함수

Public 속성

Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ FlushMessage()

◆ GetRandomKoreanWords()

◆ HandleSendClicked()

◆ HasKeyboardFocus()

◆ IsAIAsk()

◆ IsDailyAsk()

◆ NativeOnInitialized()

◆ NativeOnPreviewKeyDown()

◆ NativeTick()

◆ OnDailyAnswerReceived()

◆ SetInputFocus()

◆ SetOwningChatWidget()

멤버 데이터 문서화

◆ Button_Send

◆ bWasFocused

◆ MultiLineEditableTextBox_Input

◆ OwningChatWidget