【UE5】虚幻引擎函数说明

UGameplayStatics::LoadStreamLevel

// 函数原型
static void LoadStreamLevel(
    const UObject* WorldContextObject,
    FName LevelName,
    bool bMakeVisibleAfterLoad,
    bool bShouldBlockOnLoad,
    FLatentActionInfo LatentInfo
);

参数说明

• WorldContextObject：
  • 世界上下文对象
  • 通常传递this（在AActor/UActorComponent内调用），或者传递GetWorld()
• LevelName:
  • 要加载的子关卡名（FName类型）
• bMakeVisibleAfterLoad:
  • true：加载完成后立即显示子关卡内容
  • false：加载但保持隐藏，后续需要调用SetLevelStreamingState或SetShouldBeVisible
• bShouldBlockOnLoad:
  • true：阻塞加载（会卡一下，但确保加载完才继续执行）
  • false：异步加载
• LatentInfo:

  • 用于异步等待（Latent Action的标识）

  • 通常用法

    
    FLatentActionInfo LatentInfo;
    LatentInfo.CallbackTarget = this; // 谁来接收回调

  • 如果不关心可以传递一个默认构造：FLatentActionInfo()