Loading and Unloading Levels using C++

이번 예시에서 파티오 레벨 스트리밍을 받기 시작하여 플레이어가 모퉁이를 돌아 파티오에 접근할 때쯤에는 스트리밍 레벨이 완전히 로드되어 화면에 나타나도록 만들겠습니다.

초기 설정으로 SunTemple_Persistent 와 SunTemple_Streaming 두 레벨이 준비되어 있습니다. 플레이어 스타트(Player Start) 는 SunTemple_Persistent 에 있으며, 게임 속 플레이어는 캐릭터(Character) 로 표현됩니다.

콘텐츠 브라우저(Content Browser) 에서 SunTemple_Persistent 를 엽니다.
플레이어 스타트 를 사원의 시작 지점으로 이동합니다.
창(Windows) 을 클릭한 다음 레벨(Levels) 을 선택합니다.
레벨 드롭다운 메뉴를 클릭한 다음, 기존 추가(Add Existing...) 를 선택하여 새로운 서브레벨을 추가합니다.
레벨 열기(Open Level) 대화창에서 추가할 SunTemple_Streaming 을 선택한 다음, 열기(Open) 를 클릭합니다.
퍼시스턴트 레벨(Persistent Level) 을 우클릭 한 다음, 드롭다운 메뉴에서 현재로 만들기(Make Current) 를 선택합니다.

C++로 레벨 스트리밍 받기

콘텐츠 브라우저 를 열고 새 C++ 클래스(C++ Class) 를 생성합니다. 이 클래스는 액터(Actor) 에 기반할 것이므로 액터 를 선택하고 다음(Next) 을 클릭합니다.
새 C++ 클래스 이름을 'LevelStreamerActor'로 지정한 다음, 클래스 생성(Create Class) 을 클릭합니다. 이제 새 클래스가 Visual Studio나 XCode에서 열립니다.

이 시나리오에서는 캐릭터(Character) 가 LevelStreamerActor에 있는 OverlapVolume이라는 박스 컴포넌트와 오버랩되면 두 번째 레벨을 스트리밍으로 받겠습니다.

LevelStreamerActor.h 에 VisibleAnywhere, BlueprintReadOnly이고 AllowPrivateAccess 메타 플래그가 있는 OverlapVolume을 선언합니다.

private:
// 레벨 스트리밍을 트리거하는 볼륨을 오버랩함
UPROPERTY(VisibleAnywhere, BlueprintReadOnly, meta = (AllowPrivateAccess = "true"))
UBoxComponent* OverlapVolume;

LevelStreamerActor.cpp 의 LevelStreamerActor 생성자에서 OverlapVolume을 생성하고 이를 RootComponent로 만듭니다.
```
OverlapVolume = CreateDefaultSubobject<UBoxComponent>(TEXT("OverlapVolume"));
RootComponent = OverlapVolume;
```
LevelStreamerActor.h 로 돌아가 BoxComponent의 OnComponentBeginOverlap 함수에 바운딩될 프로텍티드 OverlapBegins 함수를 선언합니다. 이 바인딩이 의미하는 바는 OverlapBegins에 반드시 UFUNCTION 매크로 태그가 지정되어져야 하며, OnComponentBeginOverlap과 같은 시그니처가 있어야 한다는 뜻입니다.
```
protected:

UFUNCTION()
void OverlapBegins(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex,bool bFromSweep,const FHitResult & SweepResult);
```
또한 LevelStreamerActor.h 에서 LevelToLoad라고 하는 EditAnywhere인 프로텍티드 FName 변수를 만듭니다. 그러면 인스턴스별로 LevelToLoad를 변경할 수 있습니다.
```
UPROPERTY(EditAnywhere)
FName LevelToLoad;
```
GameplayStatics 라이브러리의 함수를 몇 가지 사용할 예정이니 LevelStreamerActor.cpp 의 맨 위에 포함시킵니다.
```
#include "Kismet/GameplayStatics.h"
```

이제 OverlapBegins 함수 기능을 생성할 준비를 마쳤습니다. LevelStreamerActor.cpp 에서 함수를 정의하기 시작합니다. GameplayStatics 함수인 GetPlayerCharacter 함수를 사용하여 인덱스 0에서 캐릭터를 가져올 수 있습니다.

void ALevelStreamerActor::OverlapBegins(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor, UPrimitiveComponent* OtherComp, int32 OtherBodyIndex,bool bFromSweep,const FHitResult & SweepResult)
{
        ACharacter* MyCharacter = UGameplayStatics::GetPlayerCharacter(this, 0);
}

MyCharacter를 가져온 다음, BoxComponent와 오버랩되는 OtherActor와 대조합니다. 또한, LevelToLoad가 비어 있지 않음을 확인한 다음, LoadStreamLevel을 호출합니다.
```
if (OtherActor == MyCharacter && LevelToLoad != "")
{
    FLatentActionInfo LatentInfo;
    UGameplayStatics::LoadStreamLevel(this, LevelToLoad,true,true, LatentInfo);
}
```