Unreal: Dynamic load map from Pak file

567 0 0

作者:皮斯卡略夫

Unreal: Dynamic load map from Pak file

目标：在程序运行时加载自定义 Pak 文件，并打开指定关卡，显示其中的完整 map 内容

Unreal 的 Pak 文件内包括了物体，材质，blueprint，map等等。Level 以 map 的形式保存。

Firsr of all, Pak 相关的调试需要 Package Project 执行，不能在 Editor 里面直接 Launch，否则 FCoreDelegates::MountPak IsBound 为 false ，则无法执行后续操作。

Code

在 GameMode 的 InitGame() 内调用如下代码。

void MyMainClass::MyMainClass::Exe(UWorld *world) {
    UE_LOG(LogTemp, Warning, TEXT("Init Main class"));
    if (FCoreDelegates::MountPak.IsBound())
    {
        UE_LOG(LogTemp, Warning, TEXT("LoadPakDelegate(): OnMountPak.IsBound()"));
        FString pakPath = TEXT("../../../MyProject3/Content/Paks/MyProject1-MacNoEditor.pak");
        IPakFile *pakFile = FCoreDelegates::MountPak.Execute(pakPath, 4);
      if (pakFile)
      {
        const auto& mountPoint = pakFile->PakGetMountPoint();
              UE_LOG(LogTemp, Warning, TEXT("LoadPakDelegate(): MountPoint %s"), *mountPoint);
        FString pakContentPath = mountPoint + "MyProject1/Content/";
      // FPackageName::RegisterMountPoint("/Game/", "../../../MyProject1/Content/");
      FPackageName::RegisterMountPoint("/Game/", pakContentPath);

      UGameplayStatics::OpenLevel(world, FName(TEXT("Map2")) );
      }
    }
    else
    {
        UE_LOG(LogTemp, Warning, TEXT("LoadPakDelegate(): OnMountPak.IsBound() Falied"));
    }
}

RegisterMountPoint 的分析

static void  RegisterMountPoint
(
    const FString  & RootPath,
    const FString  & ContentPath
)

This will insert a mount point at the head of the search chain (so it can overlap an existing mount point and win).

参数解释:

RootPath: Logical Root Path.

ContentPath: Content Path on disk.

Logical Path 是程序运行时会去找的 path 并非实际路径，根据反复尝试，只有在这个参数写成 “/Game/” 的时候才能正确加载到所有资源，若随意命名可能只能加载到 map 资源，连 map_builtdata 都找不到。会有如下报错：
LogStreaming: Error: Couldn't find file for package /Game/StarterContent/Maps/Map2_BuiltData requested by async loading code. NameToLoad: /Game/StarterContent/Maps/Map2_BuiltData

我的猜测是当前运行的程序的默认加载路径是 Game 所以这样写可以成功，应该也有方法自定义加载的路径，但是我暂时不知道。

Content Path 是指需要 mount 到前面这个目录的内容的父路径，这个路径取决于加载的Pak 的当前挂载点和 Pak 内部的文件路径。

通过 PakGetMountPoint() 函数得到挂载点为 "../../../"
而且 Pak 内部文件如下

MyProject1/Content/StarterContent/Blueprints/...
MyProject1/Content/StarterContent/Maps/...
MyProject1/Content/StarterContent/Materials/...
MyProject1/Content/StarterContent/Shapes/...
...

故最终路径为 “../../../MyProject1/Content/”

Missing shader resource

成功加载 map 但是模型材质和 shader 丢失，log 如下：

[UE4] [2021.05.17-03.57.53:734][  0]LogShaders: Error: Missing shader resource for hash '589973CAE03D7F0ECFEC6B825B774136FF9FCB9D' for shader platform 16 in the shader library
LogMaterial: Error: Tried to access an uncooked shader map ID in a cooked application
[UE4] [2021.05.17-08.02.25:186][  0]LogMaterial: Can't compile BasicShapeMaterial with cooked content, will use default material instead

这个问题原因是在要加载 Pak 的工程设置里面启用了 Share Material Shader Code，启用这个选项会 “Save shader only once” 这样的优化选项导致了外部的 shader 无法被找到。
在工程中关闭此开关即可。