[UE5 - Multiplayer TPS] 언리얼 멀티 플레이어 플러그인 만들기(3): Online Subsystem Steam을 활용하여 Session 검색하고 참여하기

개요

지난번에 Online Subsystem Steam을 활용하여 Steam에 Session을 생성했었다. 링크

[UE5 - Multi Player TPS] 언리얼 멀티 플레이어 플러그인 만들기(2) : Online Subsystem Steam을 사용하여 Sessio

이번엔 다른 PC로 생성된 Session을 찾고 여기에 참가해보겠다.

{ Session Find And Join }

과정

(1) JoinGameSession()에서 session을 찾는다.

(2) session 찾기가 완료되면 FindSessionCompleteDelegate에 등록된 OnFindSessionComplete()함수가 호출된다.

(2) OnFindSessionComplete()에서 session에 참여한다.

(3) session 참여가 완료되면 JoinSessionCompleteDelegate에 등록된 OnJoinSessionComplate()함수가 호출된다.

(4) OnJoinSessionComplate()에서 참여한 session의 IP 주소를 얻어 ClientTravel()함수를 이용해 서버에 참여한다.

구현

1. 우선 이전의 코드의 CreateGameSession()함수에서 SessionSetting의 옵션을 하나 추가해준다.

SessionSettings->Set(FName("MatchType"), FString("FreeForAll"), EOnlineDataAdvertisementType::ViaOnlineServiceAndPing); // 세션의 MatchType을 모두에게 열림, 온라인서비스와 핑을 통해 세션 홍보 옵션으로 설정

FOnlineSessionSettings의 Set함수는 SessionSetting할 때 Key와 Value 짝으로 옵션을 세팅해주는 함수다.

위 코드는 세션의 MatchType을 '모두에게 열림(FreeForAll)'으로 설정하고, 온라인 서비스와 핑을 통해 세션을 홍보할 수 있게 설정하는 코드이다.

2. JoinGameSession()을 구현한다.

이 함수에서는 세션 검색 옵션을 설정하고, 세션을 검색한다.

void AMenuSystemCharacter::JoinGameSession()
{
	// 세션 인터페이스 유효성 검사
	if (!OnlineSessionInterface.IsValid())
	{	
		// log
		if (GEngine)
		{
			GEngine->AddOnScreenDebugMessage(-1, 15.f, FColor::Red, FString(TEXT("Game Session Interface is invailed")));
		}
		return;
	}

	// Find Session Complete Delegate 등록
	OnlineSessionInterface->AddOnFindSessionsCompleteDelegate_Handle(FindSessionCompleteDelegate);

	// Find Game Session
	SessionSearch = MakeShareable(new FOnlineSessionSearch());
	SessionSearch->MaxSearchResults = 10000;	// 검색 결과로 나오는 세션 수 최대값
	SessionSearch->bIsLanQuery = false;			// LAN 사용 여부
	SessionSearch->QuerySettings.Set(SEARCH_PRESENCE, true, EOnlineComparisonOp::Equals); // 찾을 세션 쿼리를 현재로 설정한다

	const ULocalPlayer* LocalPlayer = GetWorld()->GetFirstLocalPlayerFromController();
	OnlineSessionInterface->FindSessions(*LocalPlayer->GetPreferredUniqueNetId(), SessionSearch.ToSharedRef());
}

3. Session을 찾으면 호출될 Delegate에 Callback 함수로 OnFindSessionComplete()를 바인딩해준다.

Session을 생성할 때와 마찬가지로 멤버 변수로 FOnFindSessionsCompleteDelegate타입의 FindSessionCompleteDelegate를 선언해주고, 생성자에서 이 Delegate에 Callback 함수로 OnFindSessionComplete()함수를 바인딩해준다.

AMenuSystemCharacter::AMenuSystemCharacter()
	: CreateSessionCompleteDelegate(FOnCreateSessionCompleteDelegate::CreateUObject(this, &ThisClass::OnCreateSessionComplete))
	, FindSessionCompleteDelegate(FOnFindSessionsCompleteDelegate::CreateUObject(this, &ThisClass::OnFindSessionComplete))
{
	...
}

4. OnFindSessionComplete() 함수를 구현한다.

이 함수에서는 세션들을 찾고 세션의 매치 타입이 'FreeForAll'일 경우, 세션에 참가한다. 

void AMenuSystemCharacter::OnFindSessionComplete(bool bWasSuccessful)
{
	if(!OnlineSessionInterface.IsValid()
	|| !bWasSuccessful)
		return;

	if (GEngine)
	{
		GEngine->AddOnScreenDebugMessage(-1, 15.f, FColor::Cyan, FString(TEXT("======== Search Result ========")));
	}

	for (auto Result : SessionSearch->SearchResults)
	{
		FString Id = Result.GetSessionIdStr();
		FString User = Result.Session.OwningUserName;
		
		// 매치 타입 확인하기
		FString MatchType;
		Result.Session.SessionSettings.Get(FName("MatchType"), MatchType);
		
		// 찾은 세션의 정보 출력하기
		if (GEngine)
		{
			GEngine->AddOnScreenDebugMessage(-1, 15.f, FColor::Cyan, FString::Printf(TEXT("Session ID : %s / Owner : %s"), *Id, *User));
		}

		// 세션의 매치 타입이 "FreeForAll"일 경우 세션 참가
		if (MatchType == FString("FreeForAll"))
		{
			if (GEngine)
			{
				GEngine->AddOnScreenDebugMessage(-1, 15.f, FColor::Cyan, FString::Printf(TEXT("Joining Match Type : %s"), *MatchType));
			}

			// Join Session Complete Delegate 등록 
			OnlineSessionInterface->AddOnJoinSessionCompleteDelegate_Handle(JoinSessionCompleteDelegate);


			const ULocalPlayer* LocalPlayer = GetWorld()->GetFirstLocalPlayerFromController();
			OnlineSessionInterface->JoinSession(*LocalPlayer->GetPreferredUniqueNetId(), NAME_GameSession, Result);
		}
	}
}

5.  Session에 참여하면 호출될 Delegate에 Callback 함수로 OnJoinSessionComplete()를 바인딩해준다.

Session을 생성할 때, 찾을 때와 마찬가지로 멤버 변수로 FOnJoinSessionsCompleteDelegate타입의 JoinSessionCompleteDelegate를 선언해주고, 생성자에서 이 Delegate에 Callback 함수로 OnJoinSessionComplete()함수를 바인딩해준다.

AMenuSystemCharacter::AMenuSystemCharacter()
	: CreateSessionCompleteDelegate(FOnCreateSessionCompleteDelegate::CreateUObject(this, &ThisClass::OnCreateSessionComplete))
	, FindSessionCompleteDelegate(FOnFindSessionsCompleteDelegate::CreateUObject(this, &ThisClass::OnFindSessionComplete))
	, JoinSessionCompleteDelegate(FOnJoinSessionCompleteDelegate::CreateUObject(this, &ThisClass::OnJoinSessionComplate))
{
	...
}

6.  OnJoinSessionComplete()를 구현한다.

이 함수에서는 세션에 참여했다면 참여한 세션의 IP 주소로 접속한다.

void AMenuSystemCharacter::OnJoinSessionComplate(FName SessionName, EOnJoinSessionCompleteResult::Type Result)
{
	if (!OnlineSessionInterface.IsValid())
		return;

	// 세션에 조인했다면 IP Address얻어와서 해당 서버에 접속
	FString Address;
	if (OnlineSessionInterface->GetResolvedConnectString(NAME_GameSession, Address))
	{
		if (GEngine)
		{
			GEngine->AddOnScreenDebugMessage(-1, 15.f, FColor::Yellow, FString::Printf(TEXT("Connect String : %s"), *Address));
		}

		APlayerController* PlayerController = GetGameInstance()->GetFirstLocalPlayerController();
		if (PlayerController)
		{
			PlayerController->ClientTravel(Address, ETravelType::TRAVEL_Absolute);
		}
	}
}

결과

https://youtu.be/TFHdxYz9COI