KLingo 서버와의 HTTP 요청을 중재하는 게임 인스턴스 서브시스템입니다. 더 자세히 ...

#include <UKLingoNetworkSystem.h>

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

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

Public 멤버 함수
	DEFINE_SUBSYSTEM_GETTER_INLINE (UKLingoNetworkSystem)

virtual void	Deinitialize () override
	등록된 델리게이트를 정리하고 서브시스템을 종료합니다.

virtual void	Initialize (FSubsystemCollectionBase &Collection) override
	HTTP 모듈 초기화 및 네트워크 대기 카운터를 설정합니다.

void	RequestChatAudio (const FString &Context, const FString &AudioPath, FResponseChatAnswersDelegate InDelegate)
	Chat 답변을 요청합니다 (음성 질문).

void	RequestChatQuestion (const FString &Context, const FString &Question, FResponseChatAnswersDelegate InDelegate)
	Chat 답변을 요청합니다 (텍스트 질문).

void	RequestDailyAudio (const FString &Context, const FString &AudioPath, FResponseChatDailysDelegate InDelegate)
	Daily Chat 답변을 요청합니다 (음성 질문).

void	RequestDailyQuestion (const FString &Context, const FString &Question, FResponseChatDailysDelegate InDelegate)
	Daily Chat 답변을 요청합니다 (텍스트 질문).

void	RequestEvaluationResult (int32 RoomId, FResponseEvaluationResultDelegate InDelegate)
	Evaluation 결과를 조회합니다.

void	RequestInterviewAnswer (const FRequestInterviewAnswer &Answer, FResponseInterviewAnswerDelegate InDelegate)
	인터뷰 답변 제출 요청을 전송합니다.

void	RequestInterviewHello (FResponseInterviewHelloDelegate InDelegate)
	인터뷰 시작 요청을 전송합니다.

void	RequestListenAudio (const FString &AudioText, FResponseListenAudioDelegate InDelegate)
	Listen 음성 생성 요청을 전송합니다.

void	RequestListenResult (const FRequestListenResult &Result, FResponseListenResultDelegate InDelegate)
	Listen 결과 제출 요청을 전송합니다.

void	RequestListenScenario (FResponseListenScenarioDelegate InDelegate)
	Listen 시나리오 조회 요청을 전송합니다.

void	RequestReadResult (const FRequestReadResult &Result, FResponseReadResultDelegate InDelegate)
	Read 결과 제출 요청을 전송합니다.

void	RequestReadScenario (FResponseReadScenarioDelegate InDelegate)
	Read 시나리오 조회 요청을 전송합니다.

void	RequestSpeakingJudges (const FString &Question, const FString &AudioPath, FResponseSpeakingJudesDelegate InDelegate)
	Speaking 평가 요청을 전송합니다.

void	RequestSpeakResult (const FRequestSpeakResult &Result, FResponseSpeakResultDelegate InDelegate)
	Speak 결과 제출 요청을 전송합니다.

void	RequestSpeakScenario (FResponseSpeakScenarioDelegate InDelegate)
	Speak 시나리오 조회 요청을 전송합니다.

void	RequestUserMe (FResponseUserMeDelegate InDelegate)
	현재 사용자 정보를 조회합니다.

void	RequestUserRegister (const FString &UserName, FResponseUserRegisterDelegate InDelegate)
	사용자 등록 요청을 전송합니다.

void	RequestUserToken (const FString &UserName, FResponseUserTokenDelegate InDelegate)
	사용자 토큰 발급 요청을 전송합니다.

void	RequestWriteQuestions (FResponseWriteQuestionDelegate InDelegate)
	Write 문제 목록을 요청합니다.

void	RequestWriteResult (const FRequestWriteResult &Result, FResponseWriteResultDelegate InDelegate)
	Write 결과 제출 요청을 전송합니다.

void	RequestWriteSubmit (const TArray< FString > &ImagePathArray, TArray< FString > InTargetText, FResponseWriteSubmitDelegate InDelegate)
	Write 제출 요청을 전송합니다.

Private 멤버 함수
void	AddNetworkWaitCount (int Value)
	네트워크 처리 대기 카운트를 갱신하고 UI에 통보합니다.

TSharedRef< IHttpRequest, ESPMode::ThreadSafe >	SetupHttpRequest (const FString &Url, const FString &Verb)

void	ShowLoadingCircle (bool bShow)
	LoadingCircle을 표시하거나 숨깁니다.

void	ShowNetworkErrorPopup (int32 ResponseCode, const FString &ResponseContent)
	네트워크 에러 팝업을 표시합니다.

정적 Private 멤버 함수
static const TCHAR *	GetLogPrefix (ENetworkLogType InLogType)
	요청 타입에 맞는 로그 접두사를 반환합니다.

static bool	IsResSuccess (const int InCode)

static void	LogNetwork (ENetworkLogType InLogType, const FString &URL, const FString &Body=TEXT(""))
	공통 네트워크 로그 메시지를 출력합니다.

Private 속성
FString	access_token
	인증 토큰 (로그인 후 저장)

int	NetworkWaitCount = 0
	처리 중인 요청 수를 집계하는 카운터입니다.

상세한 설명

KLingo 서버와의 HTTP 요청을 중재하는 게임 인스턴스 서브시스템입니다.

학습/퀘스트/채팅 등 여러 API 요청의 공통 진입점으로 사용됩니다. 요청 처리 중 로딩 UI 및 오류 팝업을 관리하며, 응답은 델리게이트로 전달됩니다. 사용 위치: 네트워크 요청이 필요한 게임플레이/학습 UI 전반.

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

멤버 함수 문서화

◆ AddNetworkWaitCount()

void UKLingoNetworkSystem::AddNetworkWaitCount ( int Value )

private

네트워크 처리 대기 카운트를 갱신하고 UI에 통보합니다.

매개변수

Value [in] 증감할 값입니다.

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

{
    NetworkWaitCount += Value;
 
    UWorld* World = GetWorld();
    if (!IsValid(World))
    {
        PRINTLOG( TEXT("[Network] Invalid World in AddNetworkWaitCount."));
        return;
    }
 
    if ( auto BroadcastManager = UBroadcastManager::Get(World) )
        BroadcastManager->SendNetworkWaitCount(NetworkWaitCount);
}

다음을 참조함 : NetworkWaitCount, PRINTLOG.

다음에 의해서 참조됨 : RequestListenScenario(), RequestReadScenario(), RequestSpeakScenario(), RequestUserMe(), RequestUserRegister(), RequestUserToken().

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

◆ DEFINE_SUBSYSTEM_GETTER_INLINE()

UKLingoNetworkSystem::DEFINE_SUBSYSTEM_GETTER_INLINE ( UKLingoNetworkSystem )

◆ Deinitialize()

void UKLingoNetworkSystem::Deinitialize ( )

overridevirtual

등록된 델리게이트를 정리하고 서브시스템을 종료합니다.

잔여 네트워크 요청 상태를 정리해 안전하게 종료합니다. 사이드이펙트: 내부 상태를 해제하고 UI 대기 상태를 정리합니다.

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

{
    Super::Deinitialize();
}

◆ GetLogPrefix()

const TCHAR * UKLingoNetworkSystem::GetLogPrefix ( ENetworkLogType InLogType )

staticprivate

요청 타입에 맞는 로그 접두사를 반환합니다.

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

{
    switch (InLogType)
    {
    case ENetworkLogType::Get:       return TEXT("[GET]");
    case ENetworkLogType::Post:      return TEXT("[POST]");
    case ENetworkLogType::WS:        return TEXT("[WS]");
    default:                         return TEXT("[UNKNOWN]");
    }
}

다음을 참조함 : Get, Post, WS.

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

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

◆ Initialize()

void UKLingoNetworkSystem::Initialize ( FSubsystemCollectionBase & Collection )

overridevirtual

HTTP 모듈 초기화 및 네트워크 대기 카운터를 설정합니다.

서브시스템 시작 시 요청 상태 추적을 준비하기 위한 초기화 단계입니다. 사이드이펙트: 내부 카운터 및 요청 대기 상태를 초기화합니다.

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

{
    Super::Initialize(Collection);
    NetworkWaitCount = 0;
}

다음을 참조함 : NetworkWaitCount.

◆ IsResSuccess()

bool UKLingoNetworkSystem::IsResSuccess ( const int InCode )

staticprivate

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

{
    if ( InCode == 200 || InCode == 201 )
        return true;
    return false;
}

다음에 의해서 참조됨 : RequestEvaluationResult(), RequestListenScenario(), RequestReadScenario(), RequestSpeakScenario(), RequestUserMe(), RequestUserRegister(), RequestUserToken().

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

◆ LogNetwork()

void UKLingoNetworkSystem::LogNetwork	(	ENetworkLogType	InLogType,
		const FString &	URL,
		const FString &	Body = `TEXT("")`
	)

staticprivate

공통 네트워크 로그 메시지를 출력합니다.

매개변수

InLogType	[in] 로그 타입입니다.
URL	[in] 요청 URL입니다.
Body	[in] 요청 본문입니다 (선택사항).

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

{
    if (!Body.IsEmpty())
    {
        NETWORK_LOG(TEXT("%s %s | Body: %s"), GetLogPrefix(InLogType), *Message, *Body);
    }
    else
    {
        NETWORK_LOG(TEXT("%s %s"), GetLogPrefix(InLogType), *Message);
    }
}

다음을 참조함 : GetLogPrefix(), NETWORK_LOG.

다음에 의해서 참조됨 : RequestChatAudio(), RequestChatQuestion(), RequestDailyAudio(), RequestDailyQuestion(), RequestEvaluationResult(), RequestInterviewAnswer(), RequestInterviewHello(), RequestListenAudio(), RequestListenResult(), RequestListenScenario(), RequestReadResult(), RequestReadScenario(), RequestSpeakingJudges(), RequestSpeakResult(), RequestSpeakScenario(), RequestUserMe(), RequestUserRegister(), RequestUserToken(), RequestWriteQuestions(), RequestWriteResult(), RequestWriteSubmit().

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

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

◆ RequestChatAudio()

void UKLingoNetworkSystem::RequestChatAudio	(	const FString &	Context,
		const FString &	AudioPath,
		FResponseChatAnswersDelegate	InDelegate
	)

Chat 답변을 요청합니다 (음성 질문).

POST /chats/answers

음성 파일을 업로드해 답변을 생성합니다.

매개변수

Context	[in] 대화 컨텍스트입니다.
AudioPath	[in] 음성 파일 경로입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::chats_answers);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // 상대 경로를 절대 경로로 변환
    FString AbsoluteAudioPath = FPaths::IsRelative(AudioPath)
        ? FPaths::Combine(FPaths::ProjectDir(), AudioPath)
        : AudioPath;
    AbsoluteAudioPath = FPaths::ConvertRelativePathToFull(AbsoluteAudioPath);
 
    // multipart/form-data로 context와 audio 파일 전송
    FHttpMultipartFormData Form;
    Form.AddText(TEXT("context"), Context);
    Form.AddText(TEXT("level"), FString::FromInt(ULingoGameHelper::GetLingoGameState(GetWorld())->GetRoomLevel()));
 
    if (!Form.AddFile(TEXT("audio"), AbsoluteAudioPath))
    {
        NETWORK_LOG(TEXT("[POST] RequestChatAnswersWithAudio: audio file load failed: %s"), *AudioPath);
        FResponseChatAnswers EmptyResponse;
        InDelegate.ExecuteIfBound(EmptyResponse, false);
        return;
    }
 
    Form.SetupHttpRequest(Request);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), FString::Printf(TEXT("Context: %s, AudioPath: %s"), *Context, *AudioPath));
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](
            FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FResponseChatAnswers ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestChatAnswersWithAudio - Code: %d, Response: %s"),
                    ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestChatAnswersWithAudio failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : FHttpMultipartFormData::AddFile(), FHttpMultipartFormData::AddText(), RequestAPI::chats_answers, Context, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FHttpMultipartFormData::SetupHttpRequest().

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

◆ RequestChatQuestion()

void UKLingoNetworkSystem::RequestChatQuestion	(	const FString &	Context,
		const FString &	Question,
		FResponseChatAnswersDelegate	InDelegate
	)

Chat 답변을 요청합니다 (텍스트 질문).

POST /chats/answers

대화 맥락과 질문을 제출해 답변을 생성합니다.

매개변수

Context	[in] 대화 컨텍스트입니다.
Question	[in] 사용자 질문입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    TMap<FString, FString> Query;
    Query.Add(TEXT("context"), Context);
    Query.Add(TEXT("question"), Question);
    Query.Add(TEXT("level"), FString::FromInt(ULingoGameHelper::GetLingoGameState(GetWorld())->GetRoomLevel()));
    FString Url = NetworkConfig::GetFullUrlWithQuery( RequestAPI::chats_answers, Query );
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
    
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), FString::Printf(TEXT("Context: %s, Question: %s"), *Context, *Question));
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](
            FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FResponseChatAnswers ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestChatAnswers - Code: %d, Response: %s"),
                    ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
 
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestChatAnswers failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : RequestAPI::chats_answers, Context, NetworkConfig::GetFullUrlWithQuery(), ULingoGameHelper::GetLingoGameState(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest().

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

◆ RequestDailyAudio()

void UKLingoNetworkSystem::RequestDailyAudio	(	const FString &	Context,
		const FString &	AudioPath,
		FResponseChatDailysDelegate	InDelegate
	)

Daily Chat 답변을 요청합니다 (음성 질문).

POST /chats/dailys

데일리 학습용 음성 질문을 업로드해 답변을 생성합니다.

매개변수

Context	[in] 대화 컨텍스트입니다.
AudioPath	[in] 음성 파일 경로입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::chats_daily);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // 상대 경로를 절대 경로로 변환
    FString AbsoluteAudioPath = FPaths::IsRelative(AudioPath)
        ? FPaths::Combine(FPaths::ProjectDir(), AudioPath)
        : AudioPath;
    AbsoluteAudioPath = FPaths::ConvertRelativePathToFull(AbsoluteAudioPath);
 
    // multipart/form-data로 context와 audio 파일 전송
    FHttpMultipartFormData Form;
    Form.AddText(TEXT("system"), Context);
    Form.AddText(TEXT("level"), FString::FromInt(ULingoGameHelper::GetLingoGameState(GetWorld())->GetRoomLevel()));
 
    if (!Form.AddFile(TEXT("audio"), AbsoluteAudioPath))
    {
        NETWORK_LOG(TEXT("[POST] RequestChatDailysWithAudio: audio file load failed: %s"), *AudioPath);
        FResponseChatDailys EmptyResponse;
        InDelegate.ExecuteIfBound(EmptyResponse, false);
        return;
    }
 
    Form.SetupHttpRequest(Request);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), FString::Printf(TEXT("Context: %s, AudioPath: %s"), *Context, *AudioPath));
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](
            FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FResponseChatDailys ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestChatDailysWithAudio - Code: %d, Response: %s"),
                    ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestChatDailysWithAudio failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : FHttpMultipartFormData::AddFile(), FHttpMultipartFormData::AddText(), RequestAPI::chats_daily, Context, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FHttpMultipartFormData::SetupHttpRequest().

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

◆ RequestDailyQuestion()

void UKLingoNetworkSystem::RequestDailyQuestion	(	const FString &	Context,
		const FString &	Question,
		FResponseChatDailysDelegate	InDelegate
	)

Daily Chat 답변을 요청합니다 (텍스트 질문).

POST /chats/dailys

데일리 학습용 대화 컨텍스트로 답변을 생성합니다.

매개변수

Context	[in] 대화 컨텍스트입니다.
Question	[in] 사용자 질문입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    TMap<FString, FString> Query;
    Query.Add(TEXT("system"), Context);
    Query.Add(TEXT("question"), Question);
    Query.Add(TEXT("level"), FString::FromInt(ULingoGameHelper::GetLingoGameState(GetWorld())->GetRoomLevel()));
    FString Url = NetworkConfig::GetFullUrlWithQuery( RequestAPI::chats_daily, Query );
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), FString::Printf(TEXT("Context: %s, Question: %s"), *Context, *Question));
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](
            FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->ShowLoadingCircle(false);
            FResponseChatDailys ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestChatDailys - Code: %d, Response: %s"),
                    ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
 
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestChatDailys failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : RequestAPI::chats_daily, Context, NetworkConfig::GetFullUrlWithQuery(), ULingoGameHelper::GetLingoGameState(), LogNetwork(), NETWORK_GET, NETWORK_LOG, Post, SetupHttpRequest().

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

◆ RequestEvaluationResult()

void UKLingoNetworkSystem::RequestEvaluationResult	(	int32	RoomId,
		FResponseEvaluationResultDelegate	InDelegate
	)

Evaluation 결과를 조회합니다.

GET /evaluations/rooms/{room_id}

평가 결과를 UI에 표시하기 위해 서버에서 데이터를 가져옵니다.

매개변수

RoomId	[in] 평가 룸 ID입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    // URL 형식: /evaluations/rooms/{room_id}
    FString Endpoint = FString::Printf(TEXT("%s/%d"), *RequestAPI::evaluations_rooms, RoomId);
    FString Url = NetworkConfig::GetFullUrl(Endpoint);
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            ShowLoadingCircle(false);
 
            FResponseEvaluationResult ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestEvaluationResult - Code: %d, Response: %s"), 
                    ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[GET] RequestEvaluationResult failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : RequestAPI::evaluations_rooms, Get, NetworkConfig::GetFullUrl(), IsResSuccess(), LogNetwork(), NETWORK_GET, NETWORK_LOG, FResponseEvaluationResult::PrintData(), FResponseEvaluationResult::SetFromHttpResponse(), SetupHttpRequest(), ShowLoadingCircle(), ShowNetworkErrorPopup().

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

◆ RequestInterviewAnswer()

void UKLingoNetworkSystem::RequestInterviewAnswer	(	const FRequestInterviewAnswer &	Answer,
		FResponseInterviewAnswerDelegate	InDelegate
	)

인터뷰 답변 제출 요청을 전송합니다.

사용자 답변을 서버로 전송하여 평가/저장을 수행합니다.

매개변수

Answer	[in] 제출할 인터뷰 답변 데이터입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    // {room_id}?room_id=
    FString Endpoint = FString::Printf(TEXT("%s/%lld"), *RequestAPI::interview_answer, ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomId() );
    FString Url = NetworkConfig::GetFullUrl(Endpoint);
    
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // Request Body 설정
    FString RequestBody;
    if (Answer.ToJsonString(RequestBody))
    {
        Request->SetContentAsString(RequestBody);
        NETWORK_LOG(TEXT("[POST] RequestInterviewAnswer Body: %s"), *RequestBody);
    }
    else
    {
        NETWORK_LOG(TEXT("[POST] RequestInterviewAnswer - Failed to serialize request body"));
    }
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *RequestBody);
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FResponseInterviewAnswer ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[POST] RequestInterviewAnswer - Code: %d, Response: %s"),
                    ResponseCode, *ResPtr->GetContentAsString());
                
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestInterviewAnswer failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), RequestAPI::interview_answer, LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FRequestInterviewAnswer::ToJsonString().

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

◆ RequestInterviewHello()

void UKLingoNetworkSystem::RequestInterviewHello ( FResponseInterviewHelloDelegate InDelegate )

인터뷰 시작 요청을 전송합니다.

인터뷰 시나리오를 시작하기 위한 진입 요청입니다.

매개변수

InDelegate [in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::interview_hello);
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FResponseInterviewHello ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestInterviewHello - Code: %d, Response: %s"), ResponseCode, *ResPtr->GetContentAsString());
                
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestInterviewHello failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : Get, NetworkConfig::GetFullUrl(), RequestAPI::interview_hello, LogNetwork(), NETWORK_GET, NETWORK_LOG, SetupHttpRequest().

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

◆ RequestListenAudio()

void UKLingoNetworkSystem::RequestListenAudio	(	const FString &	AudioText,
		FResponseListenAudioDelegate	InDelegate
	)

Listen 음성 생성 요청을 전송합니다.

텍스트를 음성으로 변환해 듣기 학습에 사용하는 요청입니다.

매개변수

AudioText	[in] 음성으로 변환할 텍스트입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    if (auto ACM = UVoiceCacheManager::Get(GetWorld()))
    {
        // HACK, 임시로 서버로 보내지 않게 하기 위해서
        // 일레븐랩스를 사용해서 하는데, 500이슈가 뜬다
        // 일레븐 랩스의 토큰을 모두 소진해서,
        // 그러면 이것을 당분간 해결하기전까지는 발생안하기 위해서 데이터를 스킵한다.
        TArray<uint8> CachedAudio;
        if (ACM->TryGetCachedAudio(AudioText, CachedAudio))
        {
            FResponseListenAudio Response;
            Response.audio_text = AudioText;
            Response.audio_base64 = CachedAudio;
 
            // ✅ 비동기 Delegate 호출 (타이밍 문제 해결)
            if (UWorld* World = GetWorld())
            {
                // Response를 힙에 할당하여 Lambda에서 안전하게 사용
                TSharedPtr<FResponseListenAudio> SharedResponse = MakeShared<FResponseListenAudio>(Response);
 
                World->GetTimerManager().SetTimerForNextTick([InDelegate, SharedResponse]()
                {
                    // 다음 프레임에 Delegate 호출
                    InDelegate.ExecuteIfBound(*SharedResponse, true);
                });
            }
            else
            {
                // World가 없으면 즉시 호출 (fallback)
                InDelegate.ExecuteIfBound(Response, true);
            }
 
            return;
        }
    }
 
    TMap<FString, FString> Query;
    Query.Add(TEXT("audio_text"), AudioText);
    FString Url = NetworkConfig::GetFullUrlWithQuery( RequestAPI::listenings_audio, Query );
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
    LogNetwork(ENetworkLogType::Post, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate, AudioText](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FResponseListenAudio ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestListenAudio - Code: %d"), ResponseCode);
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    ResponseData.PrintData();
 
                    // [4] 캐시에 저장 (Lambda 캡처된 AudioText 사용)
                    if (auto ACM = UVoiceCacheManager::Get(WeakThis->GetWorld()))
                    {
                        if (ResponseData.audio_base64.Num() > 0)
                        {
                            ACM->SaveToCache(AudioText, ResponseData.audio_base64);
                        }
                    }
 
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestListenAudio failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : FResponseListenAudio::audio_base64, FResponseListenAudio::audio_text, NetworkConfig::GetFullUrlWithQuery(), RequestAPI::listenings_audio, LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest().

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

◆ RequestListenResult()

void UKLingoNetworkSystem::RequestListenResult	(	const FRequestListenResult &	Result,
		FResponseListenResultDelegate	InDelegate
	)

Listen 결과 제출 요청을 전송합니다.

듣기 학습 결과를 서버에 기록하기 위해 호출합니다.

매개변수

Result	[in] 제출할 결과 데이터입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::listen_result);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // Request Body 설정
    FString RequestBody;
    if (Result.ToJsonString(RequestBody))
        Request->SetContentAsString(RequestBody);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *RequestBody);
 
    Request->OnProcessRequestComplete().BindLambda(
      [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
      {
          if (!WeakThis.IsValid() || IsEngineExitRequested())
              return;
 
          WeakThis->ShowLoadingCircle(false);
 
          FResponseListenResult ResponseData;
 
          if (bWasSuccessful && ResPtr.IsValid())
          {
              const int32 ResponseCode = ResPtr->GetResponseCode();
 
              NETWORK_LOG(TEXT("[RES] RequestListenResult - Code: %d, Response: %s"),
                  ResponseCode, *ResPtr->GetContentAsString());
 
              if (IsResSuccess(ResponseCode))
              {
                  ResponseData.SetFromHttpResponse(ResPtr);
                  ResponseData.PrintData();
                  InDelegate.ExecuteIfBound(ResponseData, true);
              }
              else
              {
                  WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                  InDelegate.ExecuteIfBound(ResponseData, false);
              }
          }
          else
          {
              NETWORK_LOG(TEXT("[RES] RequestListenResult failed - bSuccess: %s, Response valid: %s"),
                  bWasSuccessful ? TEXT("true") : TEXT("false"),
                  ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
 
              int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
              FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
              WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
              InDelegate.ExecuteIfBound(ResponseData, false);
          }
      });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : NetworkConfig::GetFullUrl(), RequestAPI::listen_result, LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FRequestListenResult::ToJsonString().

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

◆ RequestListenScenario()

void UKLingoNetworkSystem::RequestListenScenario ( FResponseListenScenarioDelegate InDelegate )

Listen 시나리오 조회 요청을 전송합니다.

듣기 학습 단계의 시나리오 데이터를 받아오기 위한 호출입니다.

매개변수

InDelegate [in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    // URL 형식: /scenario/stages/redis/{room_id}/{scenario_id}/{stage_type}/{level}
    FString Endpoint = FString::Printf(TEXT("%s/%lld/%d/%d/%d"), *RequestAPI::scenario,
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomId(),
        1,
        ULingoGameHelper::GetStageTypeIndex(EQuestType::Listen),
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomLevel());
    
    FString Url = NetworkConfig::GetFullUrl(Endpoint);
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            AddNetworkWaitCount(-1);
 
            FResponseListenScenario ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] Code: %d, Response: %s"), ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    // ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[RES] RequestReadScenario failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : AddNetworkWaitCount(), Get, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), ULingoGameHelper::GetStageTypeIndex(), IsResSuccess(), Listen, LogNetwork(), NETWORK_GET, NETWORK_LOG, RequestAPI::scenario, FResponseListenScenario::SetFromHttpResponse(), SetupHttpRequest(), ShowNetworkErrorPopup().

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

◆ RequestReadResult()

void UKLingoNetworkSystem::RequestReadResult	(	const FRequestReadResult &	Result,
		FResponseReadResultDelegate	InDelegate
	)

Read 결과 제출 요청을 전송합니다.

읽기 학습 결과를 서버에 기록하기 위해 호출합니다.

매개변수

Result	[in] 제출할 결과 데이터입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::read_result);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // Request Body 설정                                                                                                                                                                                                          
    FString RequestBody;
    if (Result.ToJsonString(RequestBody))
        Request->SetContentAsString(RequestBody);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *RequestBody);
 
    Request->OnProcessRequestComplete().BindLambda(
      [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
      {
          if (!WeakThis.IsValid() || IsEngineExitRequested())
              return;
 
          WeakThis->ShowLoadingCircle(false);
 
          FResponseReadResult ResponseData;
 
          if (bWasSuccessful && ResPtr.IsValid())
          {
              const int32 ResponseCode = ResPtr->GetResponseCode();
 
              NETWORK_LOG(TEXT("[POST] RequestQuestResult - Code: %d, Response: %s"),
                  ResponseCode, *ResPtr->GetContentAsString());
 
              if (IsResSuccess(ResponseCode))
              {
                  ResponseData.SetFromHttpResponse(ResPtr);
                  ResponseData.PrintData();
                  InDelegate.ExecuteIfBound(ResponseData, true);
              }
              else                                                                                                                                                                                                              
              {
                  WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                  InDelegate.ExecuteIfBound(ResponseData, false);
              }
          }
          else                                                                                                                                                                                                                  
          {
              NETWORK_LOG(TEXT("[POST] RequestReadResult failed - bSuccess: %s, Response valid: %s"),
                  bWasSuccessful ? TEXT("true") : TEXT("false"),
                  ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
 
              int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
              FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
              WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
              InDelegate.ExecuteIfBound(ResponseData, false);
          }
      });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : NetworkConfig::GetFullUrl(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, RequestAPI::read_result, SetupHttpRequest(), FRequestReadResult::ToJsonString().

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

◆ RequestReadScenario()

void UKLingoNetworkSystem::RequestReadScenario ( FResponseReadScenarioDelegate InDelegate )

Read 시나리오 조회 요청을 전송합니다.

읽기 학습 단계의 시나리오 데이터를 받아오기 위한 호출입니다.

매개변수

InDelegate [in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    // URL 형식: /scenario/stages/redis/{room_id}/{scenario_id}/{stage_type}/{level}
    FString Endpoint = FString::Printf(TEXT("%s/%lld/%d/%d/%d"), *RequestAPI::scenario,
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomId(),
        1,
        ULingoGameHelper::GetStageTypeIndex(EQuestType::Read),
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomLevel());
    
    FString Url = NetworkConfig::GetFullUrl(Endpoint);
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            AddNetworkWaitCount(-1);
 
            FResponseReadScenario ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] Code: %d, Response: %s"), ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    // ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[GET] RequestReadScenario failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : AddNetworkWaitCount(), Get, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), ULingoGameHelper::GetStageTypeIndex(), IsResSuccess(), LogNetwork(), NETWORK_GET, NETWORK_LOG, Read, RequestAPI::scenario, FResponseReadScenario::SetFromHttpResponse(), SetupHttpRequest(), ShowNetworkErrorPopup().

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

◆ RequestSpeakingJudges()

void UKLingoNetworkSystem::RequestSpeakingJudges	(	const FString &	Question,
		const FString &	AudioPath,
		FResponseSpeakingJudesDelegate	InDelegate
	)

Speaking 평가 요청을 전송합니다.

질문 텍스트와 사용자의 음성 파일을 제출해 발음 평가를 요청합니다.

매개변수

Question	[in] 평가 기준 질문 텍스트입니다.
AudioPath	[in] 업로드할 음성 파일 경로입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    TMap<FString, FString> Query;
    Query.Add(TEXT("question"), Question);
    FString Url = NetworkConfig::GetFullUrlWithQuery( RequestAPI::speakings_judes, Query );
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // 상대 경로를 절대 경로로 변환
    FString AbsoluteAudioPath = FPaths::IsRelative(AudioPath) 
        ? FPaths::Combine(FPaths::ProjectDir(), AudioPath)
        : AudioPath;
    AbsoluteAudioPath = FPaths::ConvertRelativePathToFull(AbsoluteAudioPath);
 
    FHttpMultipartFormData Form;
    if (!Form.AddFile(TEXT("audio"), AbsoluteAudioPath))
    {
        NETWORK_LOG(TEXT("[POST] Speaking Questions: file load failed: %s"), *AudioPath);
        FResponseSpeakingJudes EmptyResponse;
        InDelegate.ExecuteIfBound(EmptyResponse, false);
        return;
    }
    Form.SetupHttpRequest(Request);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->ShowLoadingCircle(false);
            FResponseSpeakingJudes ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestSpeakingQuestions - Code: %d, Response: %s"), ResponseCode, *ResPtr->GetContentAsString());
            
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestSpeakingQuestions failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
            
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
            
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : FHttpMultipartFormData::AddFile(), NetworkConfig::GetFullUrlWithQuery(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FHttpMultipartFormData::SetupHttpRequest(), RequestAPI::speakings_judes.

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

◆ RequestSpeakResult()

void UKLingoNetworkSystem::RequestSpeakResult	(	const FRequestSpeakResult &	Result,
		FResponseSpeakResultDelegate	InDelegate
	)

Speak 결과 제출 요청을 전송합니다.

말하기 학습 결과를 서버에 기록하기 위해 호출합니다.

매개변수

Result	[in] 제출할 결과 데이터입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::speak_result);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // Request Body 설정
    FString RequestBody;
    if (Result.ToJsonString(RequestBody))
        Request->SetContentAsString(RequestBody);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *RequestBody);
 
    Request->OnProcessRequestComplete().BindLambda(
      [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
      {
          if (!WeakThis.IsValid() || IsEngineExitRequested())
              return;
 
          WeakThis->ShowLoadingCircle(false);
 
          FResponseSpeakResult ResponseData;
 
          if (bWasSuccessful && ResPtr.IsValid())
          {
              const int32 ResponseCode = ResPtr->GetResponseCode();
 
              NETWORK_LOG(TEXT("[RES] FResponseSpeakResult - Code: %d, Response: %s"),
                  ResponseCode, *ResPtr->GetContentAsString());
 
              if (IsResSuccess(ResponseCode))
              {
                  ResponseData.SetFromHttpResponse(ResPtr);
                  ResponseData.PrintData();
                  InDelegate.ExecuteIfBound(ResponseData, true);
              }
              else
              {
                  WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                  InDelegate.ExecuteIfBound(ResponseData, false);
              }
          }
          else
          {
              NETWORK_LOG(TEXT("[RES] FResponseSpeakResult failed - bSuccess: %s, Response valid: %s"),
                  bWasSuccessful ? TEXT("true") : TEXT("false"),
                  ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
 
              int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
              FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
              WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
              InDelegate.ExecuteIfBound(ResponseData, false);
          }
      });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : NetworkConfig::GetFullUrl(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), RequestAPI::speak_result, FRequestSpeakResult::ToJsonString().

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

◆ RequestSpeakScenario()

void UKLingoNetworkSystem::RequestSpeakScenario ( FResponseSpeakScenarioDelegate InDelegate )

Speak 시나리오 조회 요청을 전송합니다.

말하기 학습 단계의 시나리오 데이터를 받아오기 위한 호출입니다.

매개변수

InDelegate [in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    // URL 형식: /scenario/stages/redis/{room_id}/{scenario_id}/{stage_type}/{level}
    FString Endpoint = FString::Printf(TEXT("%s/%lld/%d/%d/%d"), *RequestAPI::scenario,
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomId(),
        1,
        ULingoGameHelper::GetStageTypeIndex(EQuestType::Speak),
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomLevel());
 
    FString Url = NetworkConfig::GetFullUrl(Endpoint);
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            AddNetworkWaitCount(-1);
 
            FResponseSpeakScenario ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                // NOTE : 굉장히 시끄러움.
                // NETWORK_LOG(TEXT("[RES] Code: %d, Response: %s"), ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[RES] RequestSpeakScenario failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
 
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
 
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : AddNetworkWaitCount(), Get, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), ULingoGameHelper::GetStageTypeIndex(), IsResSuccess(), LogNetwork(), NETWORK_GET, NETWORK_LOG, FResponseSpeakScenario::PrintData(), RequestAPI::scenario, FResponseSpeakScenario::SetFromHttpResponse(), SetupHttpRequest(), ShowNetworkErrorPopup(), Speak.

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

◆ RequestUserMe()

void UKLingoNetworkSystem::RequestUserMe ( FResponseUserMeDelegate InDelegate )

현재 사용자 정보를 조회합니다.

토큰 기반 인증이 유효한지 검증하는 데 사용됩니다.

매개변수

InDelegate [in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::users_me);
    auto Request = SetupHttpRequest( Url, NETWORK_GET );
    
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
    
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            AddNetworkWaitCount(-1);
 
            FResponseUserMe ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] Code: %d, Response: %s"), ResponseCode, *HttpResponse->GetContentAsString());
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
 
                    ULingoGameInstanceSubsystem::Get(GetWorld())->SetUserInfo(ResponseData);
 
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[GET] RequestUserMe failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : AddNetworkWaitCount(), Get, NetworkConfig::GetFullUrl(), IsResSuccess(), LogNetwork(), NETWORK_GET, NETWORK_LOG, FResponseUserMe::PrintData(), FResponseUserMe::SetFromHttpResponse(), SetupHttpRequest(), ShowNetworkErrorPopup(), RequestAPI::users_me.

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

◆ RequestUserRegister()

void UKLingoNetworkSystem::RequestUserRegister	(	const FString &	UserName,
		FResponseUserRegisterDelegate	InDelegate
	)

사용자 등록 요청을 전송합니다.

신규 사용자 생성 플로우에서 계정을 생성하기 위해 사용됩니다.

매개변수

UserName	[in] 등록할 사용자 이름입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::users_register);
    auto Request = SetupHttpRequest( Url, NETWORK_POST );
    
    TSharedPtr<FJsonObject> JsonObject = MakeShareable(new FJsonObject);
    JsonObject->SetStringField(TEXT("username"), UserName);
    JsonObject->SetStringField(TEXT("fullname"), UserName + TEXT("@klingo.com"));
    JsonObject->SetStringField(TEXT("password"), UserName);
 
    FString RequestBody;
    TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&RequestBody);
    FJsonSerializer::Serialize(JsonObject.ToSharedRef(), Writer);
    Request->SetContentAsString(RequestBody);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *RequestBody);
    
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            AddNetworkWaitCount(-1);
 
            FResponseUserRegister ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    NETWORK_LOG(TEXT("[POST] RequestUserRegister failed - Code: %d, Response: %s"),
                        ResponseCode, *HttpResponse->GetContentAsString());
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestUserRegister failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
                
                // HTTP 요청 실패 시 팝업 표시
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : AddNetworkWaitCount(), NetworkConfig::GetFullUrl(), IsResSuccess(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, FResponseUserRegister::PrintData(), FResponseUserRegister::SetFromHttpResponse(), SetupHttpRequest(), ShowNetworkErrorPopup(), RequestAPI::users_register.

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

◆ RequestUserToken()

void UKLingoNetworkSystem::RequestUserToken	(	const FString &	UserName,
		FResponseUserTokenDelegate	InDelegate
	)

사용자 토큰 발급 요청을 전송합니다.

인증 토큰을 발급받아 이후 요청의 권한을 확보하기 위해 사용됩니다.

매개변수

UserName	[in] 토큰 발급 대상 사용자 이름입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::users_token);
    auto Request = SetupHttpRequest( Url, NETWORK_POST );
 
    // OAuth2 password flow requires application/x-www-form-urlencoded
    FHttpMultipartFormData FormData(EFormDataType::FormUrlEncoded);
    FormData.AddText(TEXT("grant_type"), TEXT("password"));
    FormData.AddText(TEXT("username"), UserName);
    FormData.AddText(TEXT("password"), UserName);
    FormData.SetupHttpRequest(Request);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *UserName);
    
    Request->OnProcessRequestComplete().BindLambda(
        [this, InDelegate, UserName](FHttpRequestPtr HttpRequest, FHttpResponsePtr HttpResponse, bool bSuccess)
        {
            AddNetworkWaitCount(-1);
 
            FResponseUserToken ResponseData;
 
            if (bSuccess && HttpResponse.IsValid())
            {
                const int32 ResponseCode = HttpResponse->GetResponseCode();
 
                if (IsResSuccess(ResponseCode))
                {
                    NETWORK_LOG(TEXT("[RES] RequestInterviewHello - Code: %d, Response: %s"), ResponseCode, *HttpResponse->GetContentAsString());
 
                    ResponseData.SetFromHttpResponse(HttpResponse);
                    ResponseData.PrintData();
 
                    access_token = ResponseData.access_token;
 
                    if (auto PS = ULingoGameHelper::GetLingoPlayerState(this))
                        PS->SetToken(ResponseData.access_token);
 
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    NETWORK_LOG(TEXT("[POST] RequestUserToken failed - Code: %d, Response: %s"),
                        ResponseCode, *HttpResponse->GetContentAsString());
                    ShowNetworkErrorPopup(ResponseCode, HttpResponse->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestUserToken failed - bSuccess: %s, Response valid: %s"),
                    bSuccess ? TEXT("true") : TEXT("false"),
                    HttpResponse.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = HttpResponse.IsValid() ? HttpResponse->GetResponseCode() : 0;
                FString ErrorContent = HttpResponse.IsValid() ? HttpResponse->GetContentAsString() : TEXT("Network connection failed");
                ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : FResponseUserToken::access_token, access_token, AddNetworkWaitCount(), FHttpMultipartFormData::AddText(), FormUrlEncoded, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoPlayerState(), IsResSuccess(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, FResponseUserToken::PrintData(), FResponseUserToken::SetFromHttpResponse(), SetupHttpRequest(), FHttpMultipartFormData::SetupHttpRequest(), ShowNetworkErrorPopup(), RequestAPI::users_token.

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

◆ RequestWriteQuestions()

void UKLingoNetworkSystem::RequestWriteQuestions ( FResponseWriteQuestionDelegate InDelegate )

Write 문제 목록을 요청합니다.

쓰기 학습 단계의 문제 리스트를 서버에서 받아옵니다.

매개변수

InDelegate [in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    // URL 형식: /scenario/stages/redis/{room_id}/{scenario_id}/{stage_type}/{level}
    FString Endpoint = FString::Printf(TEXT("%s/%lld/%d/%d/%d"), *RequestAPI::scenario,
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomId(),
        1,
        ULingoGameHelper::GetStageTypeIndex(EQuestType::Write),
        ULingoGameHelper::GetLingoGameState( GetWorld())->GetRoomLevel());
    FString Url = NetworkConfig::GetFullUrl(Endpoint);
    auto Request = SetupHttpRequest(Url, NETWORK_GET);
 
    LogNetwork(ENetworkLogType::Get, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->AddNetworkWaitCount(-1);
            FQuestWriteInfo ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] RequestWriteQuestions - Code: %d, Response: %s"), ResponseCode, *ResPtr->GetContentAsString());
                
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestWriteQuestions failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    AddNetworkWaitCount(1);
    Request->ProcessRequest();
}

다음을 참조함 : Get, NetworkConfig::GetFullUrl(), ULingoGameHelper::GetLingoGameState(), ULingoGameHelper::GetStageTypeIndex(), FQuestWriteInfo::IsValid(), LogNetwork(), NETWORK_GET, NETWORK_LOG, RequestAPI::scenario, SetupHttpRequest(), Write.

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

◆ RequestWriteResult()

void UKLingoNetworkSystem::RequestWriteResult	(	const FRequestWriteResult &	Result,
		FResponseWriteResultDelegate	InDelegate
	)

Write 결과 제출 요청을 전송합니다.

쓰기 학습 결과를 서버에 기록하기 위해 호출합니다.

매개변수

Result	[in] 제출할 결과 데이터입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::wriite_result);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
 
    // Request Body 설정                                                                                                                                                                                                          
    FString RequestBody;
    if (Result.ToJsonString(RequestBody))
        Request->SetContentAsString(RequestBody);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL(), *RequestBody);
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->ShowLoadingCircle(false);
 
            FResponseWriteResult ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] Code: %d, Response: %s"), ResponseCode, *ResPtr->GetContentAsString());
                
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestOcrExtract failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : NetworkConfig::GetFullUrl(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FRequestWriteResult::ToJsonString(), RequestAPI::wriite_result.

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

◆ RequestWriteSubmit()

void UKLingoNetworkSystem::RequestWriteSubmit	(	const TArray< FString > &	ImagePathArray,
		TArray< FString >	InTargetText,
		FResponseWriteSubmitDelegate	InDelegate
	)

Write 제출 요청을 전송합니다.

이미지 경로 목록과 타겟 텍스트를 서버로 제출해 OCR/채점 처리에 사용합니다.

매개변수

ImagePathArray	[in] 업로드할 이미지 파일 경로 배열입니다.
InTargetText	[in] 비교 대상 텍스트 배열입니다.
InDelegate	[in] 응답 콜백입니다. 사이드이펙트: 네트워크 요청을 전송하고 로딩 UI 상태를 갱신합니다.

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

{
    FString Url = NetworkConfig::GetFullUrl(RequestAPI::writes_submit);
    auto Request = SetupHttpRequest(Url, NETWORK_POST);
    
    FHttpMultipartFormData Form;
    for (FString ImageName : ImageNameArray)
    {
        if (!Form.AddFile(TEXT("files"), FString::Printf(TEXT("%s"), *ImageName)))
        {
            NETWORK_LOG(TEXT("[POST] OCR Extract: file load failed: %s"), *ImageName);
            FResponseWriteSubmit EmptyResponse;
            InDelegate.ExecuteIfBound(EmptyResponse, false);
            return;
        }
    }
    for (FString targetText : InTargetText)
    {
        Form.AddText(TEXT("target_texts"), targetText);
    }
    
    Form.SetupHttpRequest(Request);
 
    LogNetwork(ENetworkLogType::Post, *Request->GetURL());
 
    Request->OnProcessRequestComplete().BindLambda(
        [WeakThis = TWeakObjectPtr<UKLingoNetworkSystem>(this), InDelegate](FHttpRequestPtr Req, FHttpResponsePtr ResPtr, bool bWasSuccessful)
        {
            if (!WeakThis.IsValid() || IsEngineExitRequested())
                return;
 
            WeakThis->ShowLoadingCircle(false);
            FResponseWriteSubmit ResponseData;
 
            if (bWasSuccessful && ResPtr.IsValid())
            {
                const int32 ResponseCode = ResPtr->GetResponseCode();
 
                NETWORK_LOG(TEXT("[RES] Code: %d, Response: %s"), ResponseCode, *ResPtr->GetContentAsString());
                
                if (IsResSuccess(ResponseCode))
                {
                    ResponseData.SetFromHttpResponse(ResPtr);
                    InDelegate.ExecuteIfBound(ResponseData, true);
                }
                else
                {
                    WeakThis->ShowNetworkErrorPopup(ResponseCode, ResPtr->GetContentAsString());
                    InDelegate.ExecuteIfBound(ResponseData, false);
                }
            }
            else
            {
                NETWORK_LOG(TEXT("[POST] RequestOcrExtract failed - bSuccess: %s, Response valid: %s"),
                    bWasSuccessful ? TEXT("true") : TEXT("false"),
                    ResPtr.IsValid() ? TEXT("true") : TEXT("false"));
                
                int32 ErrorCode = ResPtr.IsValid() ? ResPtr->GetResponseCode() : 0;
                FString ErrorContent = ResPtr.IsValid() ? ResPtr->GetContentAsString() : TEXT("Network connection failed");
                WeakThis->ShowNetworkErrorPopup(ErrorCode, ErrorContent);
                
                InDelegate.ExecuteIfBound(ResponseData, false);
            }
        });
 
    ShowLoadingCircle(true);
    Request->ProcessRequest();
}

다음을 참조함 : FHttpMultipartFormData::AddFile(), FHttpMultipartFormData::AddText(), NetworkConfig::GetFullUrl(), LogNetwork(), NETWORK_LOG, NETWORK_POST, Post, SetupHttpRequest(), FHttpMultipartFormData::SetupHttpRequest(), RequestAPI::writes_submit.

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

◆ SetupHttpRequest()

TSharedRef< IHttpRequest, ESPMode::ThreadSafe > UKLingoNetworkSystem::SetupHttpRequest	(	const FString &	Url,
		const FString &	Verb
	)

private

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

{
    auto RetRequest = FHttpModule::Get().CreateRequest();
    RetRequest->SetURL(Url);
    RetRequest->SetVerb(Verb);
 
    // 기본 헤더
    RetRequest->SetHeader(TEXT("Content-Type"), TEXT("application/json"));
    RetRequest->SetHeader(TEXT("Authorization"), FString::Printf(TEXT("Bearer %s"), *access_token));
 
    return RetRequest;
}

다음을 참조함 : access_token.

다음에 의해서 참조됨 : RequestChatAudio(), RequestChatQuestion(), RequestDailyAudio(), RequestDailyQuestion(), RequestEvaluationResult(), RequestInterviewAnswer(), RequestInterviewHello(), RequestListenAudio(), RequestListenResult(), RequestListenScenario(), RequestReadResult(), RequestReadScenario(), RequestSpeakingJudges(), RequestSpeakResult(), RequestSpeakScenario(), RequestUserMe(), RequestUserRegister(), RequestUserToken(), RequestWriteQuestions(), RequestWriteResult(), RequestWriteSubmit().

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

◆ ShowLoadingCircle()

void UKLingoNetworkSystem::ShowLoadingCircle ( bool bShow )

private

LoadingCircle을 표시하거나 숨깁니다.

매개변수

bShow [in] true면 표시, false면 숨김

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

{
    if (UWorld* World = GetWorld())
    {
        if (ULoadingCircleManager* LoadingManager = ULoadingCircleManager::Get(World))
            LoadingManager->LoadingCircle(bShow);
    }
}

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

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

◆ ShowNetworkErrorPopup()

void UKLingoNetworkSystem::ShowNetworkErrorPopup	(	int32	ResponseCode,
		const FString &	ResponseContent
	)

private

네트워크 에러 팝업을 표시합니다.

매개변수

ResponseCode	[in] HTTP 응답 코드입니다.
ResponseContent	[in] HTTP 응답 본문입니다.

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

{
    UWorld* World = GetWorld();
    if (!IsValid(World))
    {
        NETWORK_LOG(TEXT("[Network] Invalid World in ShowNetworkErrorPopup"));
        return;
    }
 
    // JSON 응답 파싱
    FString ErrorDetail = TEXT("Network request failed");
    
    TSharedPtr<FJsonObject> JsonObject;
    TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(ResponseContent);
    
    if (FJsonSerializer::Deserialize(Reader, JsonObject) && JsonObject.IsValid())
    {
        // "detail" 필드 추출
        if (JsonObject->HasField(TEXT("detail")))
        {
            ErrorDetail = JsonObject->GetStringField(TEXT("detail"));
        }
    }
    else
    {
        // JSON 파싱 실패 시 원본 응답 사용
        if (!ResponseContent.IsEmpty())
        {
            ErrorDetail = ResponseContent;
        }
    }
 
    // 팝업 표시
    if (UPopupManager* PopupMgr = UPopupManager::Get(World))
    {
        FString Title = FString::Printf(TEXT("Error %d"), ResponseCode);
        PopupMgr->ShowMsgBoxSimple(Title, ErrorDetail, EMsgBoxType::OK);
        
        NETWORK_LOG(TEXT("[Network] Error Popup - Code: %d, Detail: %s"), ResponseCode, *ErrorDetail);
    }
}

다음을 참조함 : NETWORK_LOG, OK.

다음에 의해서 참조됨 : RequestEvaluationResult(), RequestListenScenario(), RequestReadScenario(), RequestSpeakScenario(), RequestUserMe(), RequestUserRegister(), RequestUserToken().

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

멤버 데이터 문서화

◆ access_token

FString UKLingoNetworkSystem::access_token

private

인증 토큰 (로그인 후 저장)

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

다음에 의해서 참조됨 : RequestUserToken(), SetupHttpRequest().

◆ NetworkWaitCount

int UKLingoNetworkSystem::NetworkWaitCount = 0

private

처리 중인 요청 수를 집계하는 카운터입니다.

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

다음에 의해서 참조됨 : AddNetworkWaitCount(), Initialize().

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

Source/Onepiece/Network/Public/UKLingoNetworkSystem.h
Source/Onepiece/Network/Private/UKLingoNetworkSystem.cpp

Public 멤버 함수

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ AddNetworkWaitCount()

◆ DEFINE_SUBSYSTEM_GETTER_INLINE()

◆ Deinitialize()

◆ GetLogPrefix()

◆ Initialize()

◆ IsResSuccess()

◆ LogNetwork()

◆ RequestChatAudio()

◆ RequestChatQuestion()

◆ RequestDailyAudio()

◆ RequestDailyQuestion()

◆ RequestEvaluationResult()

◆ RequestInterviewAnswer()

◆ RequestInterviewHello()

◆ RequestListenAudio()

◆ RequestListenResult()

◆ RequestListenScenario()

◆ RequestReadResult()

◆ RequestReadScenario()

◆ RequestSpeakingJudges()

◆ RequestSpeakResult()

◆ RequestSpeakScenario()

◆ RequestUserMe()

◆ RequestUserRegister()

◆ RequestUserToken()

◆ RequestWriteQuestions()

◆ RequestWriteResult()

◆ RequestWriteSubmit()

◆ SetupHttpRequest()

◆ ShowLoadingCircle()

◆ ShowNetworkErrorPopup()

멤버 데이터 문서화

◆ access_token

◆ NetworkWaitCount