28강. 세션 생성과 참가 흐름 이해하기

?1. 이번 강의에서 해결할 문제

세션 생성 성공을 곧바로 상대와 네트워크 연결된 상태로 착각하거나, Join 성공 뒤 Connect String을 사용하지 않아 로비로 이동하지 않습니다. Online Subsystem 작업은 비동기이며 Create → Advertise → Find → Join → Resolve Address → ClientTravel 단계를 각각 확인해야 합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 세션 수명과 실제 게임 연결·Travel을 구분합니다.
• GameInstanceSubsystem에서 Create·Find·Join Delegate를 등록·해제합니다.
• Null Online Subsystem의 LAN 세션으로 두 프로세스 접속을 검증합니다.

◇3. 핵심 개념

세션은 검색 가능한 매치 메타데이터와 참가 수명을 표현합니다. 실제 네트워크 이동은 Join 결과에서 플랫폼별 Connect String을 얻고 로컬 PlayerController가 ClientTravel을 실행해야 합니다. 서버는 세션 생성 뒤 /Game/Maps/Lobby?listen으로 리슨 World를 엽니다.

Online Subsystem은 플랫폼 서비스와 비동기 통신하므로 호출 반환값은 “작업을 시작했는가”이고 완료 Delegate가 최종 결과입니다. Delegate Handle을 작업마다 보관하고 완료·실패·Subsystem 종료에서 해제합니다.

✎4. 단계별 실습

CaptureArena.Build.cs 의존성

CaptureArena.Build.cs

PublicDependencyModuleNames.AddRange(new[]
{
    "Core", "CoreUObject", "Engine", "InputCore",
    "OnlineSubsystem", "OnlineSubsystemUtils"
});

파일 경로: Source/CaptureArena/Online/CaptureSessionSubsystem.h

CaptureSessionSubsystem.h

#pragma once

#include "CoreMinimal.h"
#include "Interfaces/OnlineSessionInterface.h"
#include "Subsystems/GameInstanceSubsystem.h"
#include "CaptureSessionSubsystem.generated.h"

UCLASS()
class CAPTUREARENA_API UCaptureSessionSubsystem : public UGameInstanceSubsystem
{
    GENERATED_BODY()

public:
    virtual void Initialize(FSubsystemCollectionBase& Collection) override;
    virtual void Deinitialize() override;

    void CreateSession(bool bLan);
    void FindSessions(bool bLan);
    void JoinFirstSession();

private:
    void HandleCreateSessionComplete(FName Name, bool bSuccess);
    void HandleFindSessionsComplete(bool bSuccess);
    void HandleJoinSessionComplete(FName Name, EOnJoinSessionCompleteResult::Type Result);

    IOnlineSessionPtr SessionInterface;
    TSharedPtr<FOnlineSessionSearch> SessionSearch;
    FDelegateHandle CreateHandle;
    FDelegateHandle FindHandle;
    FDelegateHandle JoinHandle;
};

CaptureSessionSubsystem.cpp

#include "Online/CaptureSessionSubsystem.h"

#include "OnlineSessionSettings.h"
#include "OnlineSubsystem.h"

void UCaptureSessionSubsystem::Initialize(FSubsystemCollectionBase& Collection)
{
    Super::Initialize(Collection);
    IOnlineSubsystem* Online = IOnlineSubsystem::Get();
    SessionInterface = Online ? Online->GetSessionInterface() : nullptr;
}

void UCaptureSessionSubsystem::CreateSession(bool bLan)
{
    if (!SessionInterface.IsValid()) return;

    FOnlineSessionSettings Settings;
    Settings.bIsLANMatch = bLan;
    Settings.NumPublicConnections = 2;
    Settings.bShouldAdvertise = true;
    Settings.bAllowJoinInProgress = true;
    Settings.bUsesPresence = true;
    Settings.Set(FName("MODE"), FString("CAPTURE"),
        EOnlineDataAdvertisementType::ViaOnlineServiceAndPing);

    CreateHandle = SessionInterface->AddOnCreateSessionCompleteDelegate_Handle(
        FOnCreateSessionCompleteDelegate::CreateUObject(
            this, &ThisClass::HandleCreateSessionComplete));

    if (!SessionInterface->CreateSession(0, NAME_GameSession, Settings))
    {
        SessionInterface->ClearOnCreateSessionCompleteDelegate_Handle(CreateHandle);
    }
}

void UCaptureSessionSubsystem::HandleCreateSessionComplete(
    FName Name, bool bSuccess)
{
    SessionInterface->ClearOnCreateSessionCompleteDelegate_Handle(CreateHandle);
    if (!bSuccess || !GetWorld()) return;

    GetWorld()->ServerTravel(TEXT("/Game/Maps/Lobby?listen"));
}

void UCaptureSessionSubsystem::FindSessions(bool bLan)
{
    if (!SessionInterface.IsValid()) return;

    SessionSearch = MakeShared<FOnlineSessionSearch>();
    SessionSearch->bIsLanQuery = bLan;
    SessionSearch->MaxSearchResults = 50;
    SessionSearch->QuerySettings.Set(
        SEARCH_PRESENCE, true, EOnlineComparisonOp::Equals);

    FindHandle = SessionInterface->AddOnFindSessionsCompleteDelegate_Handle(
        FOnFindSessionsCompleteDelegate::CreateUObject(
            this, &ThisClass::HandleFindSessionsComplete));

    if (!SessionInterface->FindSessions(0, SessionSearch.ToSharedRef()))
    {
        SessionInterface->ClearOnFindSessionsCompleteDelegate_Handle(FindHandle);
    }
}

void UCaptureSessionSubsystem::HandleFindSessionsComplete(bool bSuccess)
{
    SessionInterface->ClearOnFindSessionsCompleteDelegate_Handle(FindHandle);
    UE_LOG(LogTemp, Display, TEXT("Find success=%d Results=%d"),
        bSuccess, SessionSearch.IsValid() ? SessionSearch->SearchResults.Num() : 0);
}

void UCaptureSessionSubsystem::JoinFirstSession()
{
    if (!SessionInterface.IsValid() || !SessionSearch.IsValid()
        || SessionSearch->SearchResults.IsEmpty()) return;

    JoinHandle = SessionInterface->AddOnJoinSessionCompleteDelegate_Handle(
        FOnJoinSessionCompleteDelegate::CreateUObject(
            this, &ThisClass::HandleJoinSessionComplete));

    if (!SessionInterface->JoinSession(
        0, NAME_GameSession, SessionSearch->SearchResults[0]))
    {
        SessionInterface->ClearOnJoinSessionCompleteDelegate_Handle(JoinHandle);
    }
}

void UCaptureSessionSubsystem::HandleJoinSessionComplete(
    FName Name, EOnJoinSessionCompleteResult::Type Result)
{
    SessionInterface->ClearOnJoinSessionCompleteDelegate_Handle(JoinHandle);
    if (Result != EOnJoinSessionCompleteResult::Success) return;

    FString ConnectString;
    if (!SessionInterface->GetResolvedConnectString(Name, ConnectString)) return;

    if (APlayerController* PC = GetGameInstance()->GetFirstLocalPlayerController())
    {
        PC->ClientTravel(ConnectString, TRAVEL_Absolute);
    }
}

Deinitialize에서는 유효한 Handle을 모두 Clear하고 검색 객체를 Reset합니다. 이미 세션이 있으면 새 Create 전에 DestroySession 완료를 기다리는 상태 머신을 추가해야 합니다. UI 버튼은 작업 중 비활성화해 중복 Delegate와 요청을 막습니다.

→5. 코드가 동작하는 이유

GameInstanceSubsystem은 맵 Travel보다 오래 살아 메뉴·로비 사이의 비동기 세션 작업을 관리하기 적합합니다. 호스트는 세션 광고 성공 뒤 listen Lobby를 열고, 참가자는 검색 결과를 Join한 뒤 Online Subsystem이 제공하는 주소로 ClientTravel합니다. GameMode는 서버 경기 규칙, SessionSubsystem은 프로세스의 온라인 접속 흐름을 맡습니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• CreateSession 반환 true를 완료로 해석: 완료 Delegate의 성공 값을 기다립니다.
• Join 성공 뒤 Travel 누락: GetResolvedConnectString과 로컬 PlayerController ClientTravel을 실행합니다.
• Delegate Handle 해제 누락: 완료·실패·Deinitialize에서 등록한 Handle을 정리합니다.
• Null LAN 코드와 특정 플랫폼 설정을 같은 결과로 가정: Subsystem 이름, 플러그인, 계정·App ID와 패키지 환경을 별도 검증합니다.

✎7. 직접 실습

✎직접 실습

별도 프로세스 두 개에서 호스트 Create → Lobby listen, 참가자 Find → Join → ClientTravel을 실행하세요. Create/Find/Join 시작 반환값, 완료 결과, 검색 수, Connect String 존재 여부와 최종 Map을 순서대로 기록합니다. 같은 버튼을 빠르게 두 번 눌러 중복 방지 상태도 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 세션 Join 성공과 실제 게임 서버 접속은 어떤 단계로 연결되나요?
2. 세션 코드를 GameMode보다 GameInstanceSubsystem에 두는 이유는 무엇인가요?
3. 비동기 Delegate Handle을 해제하지 않으면 어떤 중복 문제가 생길 수 있나요?

■9. 핵심 요약

■핵심 요약

세션은 Create·Find·Join 비동기 수명이고 실제 접속은 Connect String과 ClientTravel이 완성합니다. 맵보다 오래 사는 GameInstanceSubsystem에서 Delegate를 명시적으로 관리하고 Null LAN과 플랫폼 온라인 환경을 구분합니다.