游戏引擎 / 系统课时
把资源加载改成异步
把资源加载改成异步
同步加载最危险的地方不是 API 本身,而是它可能把磁盘读取、反序列化和依赖处理直接变成游戏线程的等待点。本课用软引用配合 FStreamableManager 完成一次可验证的异步加载,并说明异步完成回调为什么仍要控制初始化量。
学习目标
- 理解软引用、异步请求、完成回调与游戏线程等待点之间的关系
- 能使用
TSoftObjectPtr和FStreamableManager::RequestAsyncLoad加载资源 - 能识别“异步加载后仍然卡”的常见原因
先把硬依赖改成可延迟解析的引用
如果对象持有硬资源引用,资源常会随着所属对象或包一起成为加载依赖;而 TSoftObjectPtr 保存的是可解析的软引用,不要求资源此刻已经驻留内存。这样你才能决定“什么时候发起请求”,而不是在首次使用时被迫同步等待。
异步加载的主链路可以看成:游戏线程提交资源路径,异步加载系统处理读取与加载,完成后触发回调,游戏线程再把资源挂到实际对象上。真正要避免的是在关键帧中途突然调用同步加载并等待结果。

用软引用发起异步加载
下面示例定义一个 Actor,在 BeginPlay 时异步加载一个静态网格。把 MeshAsset 在编辑器中指向任意 UStaticMesh 资源即可。示例保留 FStreamableHandle,避免请求生命周期完全失去控制。
// AsyncAssetLoaderActor.h
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Engine/StreamableManager.h"
#include "AsyncAssetLoaderActor.generated.h"
UCLASS()
class MYGAME_API AAsyncAssetLoaderActor : public AActor
{
GENERATED_BODY()
public:
AAsyncAssetLoaderActor();
UPROPERTY(EditAnywhere, Category = "Loading")
TSoftObjectPtr<UStaticMesh> MeshAsset;
protected:
virtual void BeginPlay() override;
private:
TSharedPtr<FStreamableHandle> LoadHandle;
void StartAsyncLoad();
void OnMeshLoaded();
};
// AsyncAssetLoaderActor.cpp
#include "AsyncAssetLoaderActor.h"
#include "Components/SceneComponent.h"
#include "Components/StaticMeshComponent.h"
#include "Engine/AssetManager.h"
AAsyncAssetLoaderActor::AAsyncAssetLoaderActor()
{
RootComponent = CreateDefaultSubobject<USceneComponent>(TEXT("Root"));
}
void AAsyncAssetLoaderActor::BeginPlay()
{
Super::BeginPlay();
StartAsyncLoad();
}
void AAsyncAssetLoaderActor::StartAsyncLoad()
{
if (MeshAsset.IsNull())
{
UE_LOG(LogTemp, Warning, TEXT("MeshAsset is not assigned"));
return;
}
if (MeshAsset.IsValid())
{
OnMeshLoaded();
return;
}
FStreamableManager& StreamableManager =
UAssetManager::GetStreamableManager();
LoadHandle = StreamableManager.RequestAsyncLoad(
MeshAsset.ToSoftObjectPath(),
FStreamableDelegate::CreateUObject(
this,
&AAsyncAssetLoaderActor::OnMeshLoaded
)
);
}
void AAsyncAssetLoaderActor::OnMeshLoaded()
{
UStaticMesh* Mesh = MeshAsset.Get();
if (!Mesh)
{
UE_LOG(LogTemp, Error, TEXT("Async load failed"));
return;
}
UStaticMeshComponent* MeshComponent =
NewObject<UStaticMeshComponent>(this, TEXT("LoadedMesh"));
MeshComponent->SetupAttachment(RootComponent);
MeshComponent->SetStaticMesh(Mesh);
AddInstanceComponent(MeshComponent);
MeshComponent->RegisterComponent();
UE_LOG(
LogTemp,
Display,
TEXT("Async load complete: %s"),
*Mesh->GetPathName()
);
LoadHandle.Reset();
}预期输出
Async load complete: <PATH><PATH> 是你实际选择的静态网格对象路径。更重要的验证现象是:调用 RequestAsyncLoad 后当前函数可以返回,资源尚未就绪时不会因为主动等待而卡在这里;资源可用后才执行 OnMeshLoaded。
不要在异步流程里重新制造同步等待
最常见的反例,是已经保存了软引用,却在需要资源时直接调用 LoadSynchronous。这会让当前线程等待资源可用,等于把延迟重新塞回关键帧。另一种隐蔽问题是请求异步加载后马上通过某种等待逻辑阻塞当前流程,效果同样接近同步加载。
正确做法是把“资源暂时不可用”当成正常状态:提前发起请求,在回调中切换状态或创建依赖该资源的对象;如果玩家必须等资源齐备,则显示加载界面或保持旧场景可运行,而不是冻结游戏线程等待。
异步完成后仍要控制每帧工作量
异步加载主要解决的是等待点,不会自动消除所有初始化成本。回调触发后,如果一次创建数百个组件、生成大量 Actor、构建复杂动态材质或执行重型蓝图逻辑,Game Thread 仍可能出现长帧。
因此验收时要同时观察两件事:加载期间关键帧是否还出现同步等待,以及完成回调所在帧是否形成新的峰值。若后者仍高,应把回调后的工作拆成小批次,例如每帧处理固定数量对象,并把非首屏、非交互资源延后到真正需要前再加载。
当资源依赖可以提前预知、但不要求立刻使用时,软引用加异步请求通常是合适方案;当资源体积极小且确定常驻,异步化反而可能增加状态管理成本。优化目标不是“所有资源都异步”,而是让不可预测或高成本加载不再阻塞关键游戏帧。