ULingoGameInstance 클래스 참조

#include <ULingoGameInstance.h>

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

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

Public 멤버 함수
	ULingoGameInstance ()
void	CreateMySession (FString displayName)
void	FindOtherSession ()
int32	GetSelectCharacter (FString userName)
virtual void	Init () override
void	JoinOtherSession (int32 sessionIdx)
void	OnCreateSessionComplete (FName sessionName, bool bWasSuccessful)
void	OnFindSessionComplete (bool bWasSuccessful)
void	OnJoinSessionComplete (FName sessionName, EOnJoinSessionCompleteResult::Type result)
void	SetSelectCharacter (FString userName, int32 characterIdx)
virtual void	Shutdown () override
FString	StringBase64Decode (FString str)
FString	StringBase64Encode (FString str)

Public 속성
FName	currSessionName
FFindComplete	onFindComplete
TMap< FString, int32 >	selectCharacter
IOnlineSessionPtr	sessionInterface
TSharedPtr< FOnlineSessionSearch >	sessionSearch

상세한 설명

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

생성자 & 소멸자 문서화

ULingoGameInstance()

ULingoGameInstance::ULingoGameInstance

(

)

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

{
 
}

멤버 함수 문서화

CreateMySession()

void ULingoGameInstance::CreateMySession

(

FString

displayName

)

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

{
    // 로딩 서클 표시
    if (UWorld* World = GetWorld())
    {
        if (ULoadingCircleManager* LoadingManager = ULoadingCircleManager::Get(World))
            LoadingManager->LoadingCircle(true);
    }
 
    // 세션을 만들기 위한 옵션 담을 변수
    FOnlineSessionSettings sessionSettings;
    // 현재 사용중인 서브시스템 이름 가져오자.
    FName subsysName = Online::GetSubsystem(GetWorld())->GetSubsystemName();
    // 만약에 서브시스템이 이름이 NULL 이면 Lan 을 이용하게 설정
    sessionSettings.bIsLANMatch = subsysName.IsEqual(FName(TEXT("NULL")));
    UE_LOG(LogTemp, Warning, TEXT("서브시스템 : %s"), *subsysName.ToString());
 
    // Steam 에선 필수 (bUseLobbiesIfAvailable, bUsesPresence)
    // Lobby 사용 여부 설정
    sessionSettings.bUseLobbiesIfAvailable = true;
    // 친구 상태를 확인할 수 있는 여부
    sessionSettings.bUsesPresence = true;
 
    // 세션 검색 허용 여부
    sessionSettings.bShouldAdvertise = true;
    // 세션 최대 참여 인원 설정 (임시로 2명)
    sessionSettings.NumPublicConnections = 2;
    // 커스텀 정보
    // displayName 을 Base64 로 변환
    displayName = StringBase64Encode(displayName);
    sessionSettings.Set(FName("DP_NAME"), displayName, EOnlineDataAdvertisementType::ViaOnlineServiceAndPing);
    //sessionSettings.Set(FName("MAP_IDX"), 1, EOnlineDataAdvertisementType::ViaOnlineServiceAndPing);
 
    // sessionSettings 이용해서 세션 생성
    FUniqueNetIdPtr netId =
        GetWorld()->GetFirstLocalPlayerFromController()->GetUniqueNetIdForPlatformUser().GetUniqueNetId();
    sessionInterface->CreateSession(*netId, FName(displayName), sessionSettings);   
    //sessionInterface->CreateSession(0, FName(displayName), sessionSettings);
 
}

다음을 참조함 : sessionInterface, StringBase64Encode().

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

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

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

FindOtherSession()

void ULingoGameInstance::FindOtherSession

(

)

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

{
    UE_LOG(LogTemp, Warning, TEXT("세션 조회 시작"));
    // sessionSearch 만들자.
    sessionSearch = MakeShared<FOnlineSessionSearch>();
    // 현재 사용중인 서브시스템 이름 가져오자.
    FName subsysName = Online::GetSubsystem(GetWorld())->GetSubsystemName();
    // 만약에 서브시스템이 이름이 NULL 이면 Lan 을 이용하게 설정
    sessionSearch->bIsLanQuery = subsysName.IsEqual(FName(TEXT("NULL")));
    // 어떤 옵션을 기준으로 검색
    sessionSearch->QuerySettings.Set(SEARCH_LOBBIES, true, EOnlineComparisonOp::Equals);
    //sessionSearch->QuerySettings.Set(FName("DP_NAME"), FName("Wanted"), EOnlineComparisonOp::Equals);
    // 검색 갯수
    sessionSearch->MaxSearchResults = 100;
    // 위 설정을 가지고 세션 검색
    sessionInterface->FindSessions(0, sessionSearch.ToSharedRef());
}

다음을 참조함 : sessionInterface, sessionSearch.

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

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

GetSelectCharacter()

int32 ULingoGameInstance::GetSelectCharacter

(

FString

userName

)

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

{
    int32* value = selectCharacter.Find(userName);
    if (value == nullptr) return -1;
 
    return *value;
}

다음을 참조함 : selectCharacter.

Init()

void ULingoGameInstance::Init ( )

overridevirtual

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

{
    Super::Init();
 
    // 현재 사용하는 서브시스템을 가져오자
    IOnlineSubsystem* subsys = Online::GetSubsystem(GetWorld());
    if (subsys)
    {
        // 서브시스템의 인터페이스를 가져오자.
        sessionInterface = subsys->GetSessionInterface();
        // 세션 생성 성공시 호출되는 함수 등록
        sessionInterface->OnCreateSessionCompleteDelegates.AddUObject(
            this, &ULingoGameInstance::OnCreateSessionComplete);
        // 세션 조회 성공시 호출되는 함수 등록
        sessionInterface->OnFindSessionsCompleteDelegates.AddUObject(
            this, &ULingoGameInstance::OnFindSessionComplete);
        // 세션 참여 성공시 호출되는 함수 등록
        sessionInterface->OnJoinSessionCompleteDelegates.AddUObject(
            this, &ULingoGameInstance::OnJoinSessionComplete);
    }
}

다음을 참조함 : OnCreateSessionComplete(), OnFindSessionComplete(), OnJoinSessionComplete(), sessionInterface.

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

JoinOtherSession()

void ULingoGameInstance::JoinOtherSession

(

int32

sessionIdx

)

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

{
    // 로딩 서클 표시
    if (UWorld* World = GetWorld())
    {
        if (ULoadingCircleManager* LoadingManager = ULoadingCircleManager::Get(World))
            LoadingManager->LoadingCircle(true);
    }
 
    // 검색된 세션 결과들
    auto results = sessionSearch->SearchResults;
    // 5.5 이후 부터 바꼈다...
    results[sessionIdx].Session.SessionSettings.bUseLobbiesIfAvailable = true;
    results[sessionIdx].Session.SessionSettings.bUsesPresence = true;
 
    // 세션 이름 가져오자.
    FString displayName;
    results[sessionIdx].Session.SessionSettings.Get(FName(TEXT("DP_NAME")), displayName);
 
    // 세션 참여
    sessionInterface->JoinSession(0, FName(displayName), results[sessionIdx]);
}

다음을 참조함 : sessionInterface, sessionSearch.

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

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

OnCreateSessionComplete()

void ULingoGameInstance::OnCreateSessionComplete	(	FName	sessionName,
		bool	bWasSuccessful
	)

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

{
    if (bWasSuccessful)
    {
        UE_LOG(LogTemp, Warning, TEXT("[%s] 세션 생성 성공"), *sessionName.ToString());
        // 맵 으로 이동 (로딩 서클은 맵 로딩 완료 후에 숨김)
        GetWorld()->ServerTravel(TEXT("/Game/StarterBundle/CollectionMaps/Map1?listen"));
    }
    else
    {
        UE_LOG(LogTemp, Warning, TEXT("[%s] 세션 생성 실패"), *sessionName.ToString());
 
        // 세션 생성 실패 시 로딩 서클 숨김
        if (UWorld* World = GetWorld())
        {
            if (ULoadingCircleManager* LoadingManager = ULoadingCircleManager::Get(World))
                LoadingManager->LoadingCircle(false);
        }
    }
}

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

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

OnFindSessionComplete()

void ULingoGameInstance::OnFindSessionComplete

(

bool

bWasSuccessful

)

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

{
    UE_LOG(LogTemp, Warning, TEXT("세션 조회 끝"));
    if (bWasSuccessful)
    {
        // 검색된 세션 결과들
        auto results = sessionSearch->SearchResults;
        for (int32 i = 0; i < results.Num(); i++)
        {
            // 방 제목 이름 담을 변수
            FString displayName;
            results[i].Session.SessionSettings.Get(FName(TEXT("DP_NAME")), displayName);
            // displayName 을 UTF8 string 으로 변환
            displayName = StringBase64Decode(displayName);
            UE_LOG(LogTemp, Warning, TEXT("세션 - %i, 이름 : %s"), i, *displayName);
            // onFindComplete 에 들어있는 함수 실행
            onFindComplete.ExecuteIfBound(i, displayName);
        }
    }
    else
    {
        UE_LOG(LogTemp, Warning, TEXT("세션 조회 실패"));
    }
 
    onFindComplete.ExecuteIfBound(-1, FString());
}

다음을 참조함 : onFindComplete, sessionSearch, StringBase64Decode().

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

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

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

OnJoinSessionComplete()

void ULingoGameInstance::OnJoinSessionComplete	(	FName	sessionName,
		EOnJoinSessionCompleteResult::Type	result
	)

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

{
    // 만약 참여 성공 했다면
    if (result == EOnJoinSessionCompleteResult::Success)
    {
        // 서버가 만들어 놓은 세션 URL 을 얻어오자.k
        FString url;
        sessionInterface->GetResolvedConnectString(sessionName, url);
        UE_LOG(LogTemp, Warning, TEXT("URL : %s"), *url);
        // 서버가 있는 맵으로 이동 (로딩 서클은 맵 로딩 완료 후에 숨김)
        APlayerController* pc = GetWorld()->GetFirstPlayerController();
        pc->ClientTravel(url, TRAVEL_Absolute);
    }
    else
    {
        UE_LOG(LogTemp, Warning, TEXT("[%s] 세션 참여 실패"), *sessionName.ToString());
 
        // 세션 참여 실패 시 로딩 서클 숨김
        if (UWorld* World = GetWorld())
        {
            if (ULoadingCircleManager* LoadingManager = ULoadingCircleManager::Get(World))
                LoadingManager->LoadingCircle(false);
        }
    }
}

다음을 참조함 : sessionInterface.

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

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

SetSelectCharacter()

void ULingoGameInstance::SetSelectCharacter	(	FString	userName,
		int32	characterIdx
	)

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

{
    selectCharacter.Add(userName, characterIdx);
}

다음을 참조함 : selectCharacter.

Shutdown()

void ULingoGameInstance::Shutdown ( )

overridevirtual

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

{
    // 델리게이트 정리
    if (sessionInterface.IsValid())
    {
        // 세션 델리게이트 바인딩 해제
        sessionInterface->OnCreateSessionCompleteDelegates.RemoveAll(this);
        sessionInterface->OnFindSessionsCompleteDelegates.RemoveAll(this);
        sessionInterface->OnJoinSessionCompleteDelegates.RemoveAll(this);
 
        PRINTLOG(TEXT("[LingoGameInstance] Session delegates cleared"));
    }
 
    // sessionSearch 정리
    if (sessionSearch.IsValid())
    {
        sessionSearch.Reset();
    }
 
    // sessionInterface 정리
    sessionInterface.Reset();
 
    // selectCharacter 맵 정리
    selectCharacter.Empty();
 
    PRINTLOG(TEXT("[LingoGameInstance] Shutdown complete"));
 
    Super::Shutdown();
}

다음을 참조함 : PRINTLOG, selectCharacter, sessionInterface, sessionSearch.

StringBase64Decode()

FString ULingoGameInstance::StringBase64Decode

(

FString

str

)

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

{
    TArray<uint8> arrayData;
    FBase64::Decode(str, arrayData);
    std::string utf8String((char*)arrayData.GetData(), arrayData.Num());
    return UTF8_TO_TCHAR(utf8String.c_str());
}

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

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

StringBase64Encode()

FString ULingoGameInstance::StringBase64Encode

(

FString

str

)

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

{
    // str 을 std::string 로 변환
    std::string utf8String = TCHAR_TO_UTF8(*str);
    // utf8String 을 uint8 의 Array 변환
    TArray<uint8> arrayData = TArray<uint8>((uint8*)utf8String.c_str(), utf8String.length());
 
    return FBase64::Encode(arrayData);
}

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

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

멤버 데이터 문서화

currSessionName

FName ULingoGameInstance::currSessionName

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

onFindComplete

FFindComplete ULingoGameInstance::onFindComplete

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

다음에 의해서 참조됨 : ULobbyWidget::NativeConstruct(), OnFindSessionComplete().

selectCharacter

TMap<FString, int32> ULingoGameInstance::selectCharacter

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

다음에 의해서 참조됨 : GetSelectCharacter(), SetSelectCharacter(), Shutdown().

sessionInterface

IOnlineSessionPtr ULingoGameInstance::sessionInterface

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

다음에 의해서 참조됨 : CreateMySession(), FindOtherSession(), Init(), JoinOtherSession(), OnJoinSessionComplete(), Shutdown().

sessionSearch

TSharedPtr<FOnlineSessionSearch> ULingoGameInstance::sessionSearch

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

다음에 의해서 참조됨 : FindOtherSession(), JoinOtherSession(), OnFindSessionComplete(), Shutdown().

---

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

• Source/Onepiece/Game/Public/ULingoGameInstance.h
• Source/Onepiece/Game/Private/ULingoGameInstance.cpp