상수 정의 및 초기화#

#include "MyGameInstance.h"
#include "Student.h"
#include "UObject/SavePackage.h" // 패키지 저장 기능

// 패키지 경로: /Game은 콘텐츠 폴더를 의미
const FString UMyGameInstance::PackageName = TEXT("/Game/Student");
const FString UMyGameInstance::AssetName = TEXT("TopStudent");

void UMyGameInstance::Init()
{
	Super::Init();
    // (이전 시간의 직렬화 실습 코드는 생략...)
    
	SaveStudentPackage();
	LoadStudentPackage();
    LoadStudentObject();
}

패키지 저장 (SaveStudentPackage)#

언리얼 오브젝트를 생성하고 패키지로 묶어 .uasset 파일로 저장한다.

void UMyGameInstance::SaveStudentPackage() const
{
	// 1. 기존 패키지가 있다면 로드 (FullyLoad)
	UPackage* StudentPackage = ::LoadPackage(nullptr, *PackageName, LOAD_None);
	if (StudentPackage)
	{
		StudentPackage->FullyLoad();
	}

	// 2. 패키지 생성
	StudentPackage = CreatePackage(*PackageName);

	// 3. 저장 옵션 설정 (공개, 독립 실행형)
	EObjectFlags ObjectFlag = RF_Public | RF_Standalone;

	// 4. 패키지 내부에 에셋(TopStudent) 생성
    // NewObject의 Outer를 StudentPackage로 지정
	UStudent* TopStudent = NewObject<UStudent>(StudentPackage, UStudent::StaticClass(), *AssetName, ObjectFlag);
	TopStudent->SetName(TEXT("홍길동"));
	TopStudent->SetOrder(36);

	// 5. 에셋 내부에 서브 오브젝트 생성 (10개)
	for (int32 ix = 0; ix < 10; ++ix)
	{
		FString SubObjectName = FString::Printf(TEXT("Student%d"), ix);
		UStudent* SubStudent = NewObject<UStudent>(TopStudent, UStudent::StaticClass(), *SubObjectName, ObjectFlag);
		SubStudent->SetName(FString::Printf(TEXT("서브학생%d"), ix));
		SubStudent->SetOrder(ix);
	}

	// 6. 패키지 파일 저장 (.uasset)
	const FString PackageFileName = FPackageName::LongPackageNameToFilename(PackageName, FPackageName::GetAssetPackageExtension());
	
    FSavePackageArgs SaveArgs;
	SaveArgs.TopLevelFlags = ObjectFlag;

	if (UPackage::SavePackage(StudentPackage, nullptr, *PackageFileName, SaveArgs))
	{
		UE_LOG(LogTemp, Log, TEXT("학생 패키지 저장 성공 : %s"), *PackageFileName);
	}
}

참고: UE 5.4 버전부터는 에셋 생성이 Factory 클래스를 통해서만 가능하도록 정책이 변경되는 추세입니다. 위 코드로 저장 시 콘텐츠 브라우저에 바로 보이지 않을 수 있으나, 파일 시스템에는 정상적으로 저장됩니다.

패키지 로드 (LoadStudentPackage)#

저장된 패키지를 불러와 내부의 에셋을 찾는다.

void UMyGameInstance::LoadStudentPackage() const
{
	// 1. 패키지 로드
	UPackage* LoadedPackage = ::LoadPackage(nullptr, *PackageName, LOAD_None);
	if (nullptr == LoadedPackage)
	{
		UE_LOG(LogTemp, Warning, TEXT("학생 패키지 로드 실패"));
		return;
	}

	// 2. 패키지 내부 에셋 모두 로드
	LoadedPackage->FullyLoad();

	// 3. 패키지 내에서 특정 에셋 찾기 (FindObject)
	UStudent* TopStudent = FindObject<UStudent>(LoadedPackage, *AssetName);
	
	if (TopStudent)
	{
		PrintStudentInfo(TopStudent, TEXT("LoadedPackage"));
	}
}

① 런타임 동기 로딩 (LoadObject)#

게임 실행 중(런타임)에 필요한 시점에 즉시 로딩

void UMyGameInstance::LoadStudentObject() const
{
    // 경로 문자열 조합
	const FString TopSoftObjectPath = FString::Printf(TEXT("%s.%s"), *PackageName, *AssetName);

    // LoadObject 함수로 로딩
	UStudent* TopStudent = LoadObject<UStudent>(nullptr, *TopSoftObjectPath);
	PrintStudentInfo(TopStudent, TEXT("LoadObject Asset"));
}

② 생성자 로딩 (ConstructorHelpers)#

C++ 클래스 생성자에서 미리 에셋을 로딩하여 연결 (주로 컴포넌트나 기본 리소스 설정 시 사용)

UMyGameInstance::UMyGameInstance()
{
	const FString TopSoftObjectPath = FString::Printf(TEXT("%s.%s"), *PackageName, *AssetName);
    
    // 생성자 전용 헬퍼 클래스 사용
	static ConstructorHelpers::FObjectFinder<UStudent> UASSET_TopStudent(*TopSoftObjectPath);
	if (UASSET_TopStudent.Succeeded())
	{
		PrintStudentInfo(UASSET_TopStudent.Object, TEXT("Constructor"));
	}
}

주의: 생성자 로딩은 에디터 실행 시점에 호출되며, 실패 시 크래시가 발생할 수 있으므로 경로 확인이 중요합니다.

③ 런타임 비동기 로딩 (StreamableManager)#

게임 흐름을 멈추지 않고 백그라운드에서 로딩. 로딩이 완료되면 델리게이트(콜백)를 호출

// Init() 내부 등에서 호출
{
	const FString TopSoftObjectPath = FString::Printf(TEXT("%s.%s"), *PackageName, *AssetName);
    
    // 비동기 로드 요청
	Handle = StreamableManager.RequestAsyncLoad(TopSoftObjectPath,
		[&]()
		{
            // 로딩 완료 후 실행될 람다 함수
			if (Handle.IsValid() && Handle->HasLoadCompleted())
			{
				UStudent* TopStudent = Cast<UStudent>(Handle->GetLoadedAsset());
				if (TopStudent)
				{
					PrintStudentInfo(TopStudent, TEXT("AsyncLoad"));
                    
                    // 핸들 해제
					Handle->ReleaseHandle();
					Handle.Reset();
				}
			}
		}
	);
}