强引用（hard reference）
如果A强引用B，那么在加载A时会把B也加载进内存
c++强引用资源
在AMyTest1GameMode的构造函数中加载Blueprint UClass，并赋值给DefaultPawnClass成员变量
那么AMyTest1GameMode类型就强引用着/Game/ThirdPersonCPP/Blueprints/ThirdPersonCharacter的Blueprint UClass
AMyTest1GameMode::AMyTest1GameMode() { // set default pawn class to our Blueprinted character static ConstructorHelpers::FClassFinder<APawn> PlayerPawnBPClass(TEXT("/Game/ThirdPersonCPP/Blueprints/ThirdPersonCharacter")); if (PlayerPawnBPClass.Class != NULL) { DefaultPawnClass = PlayerPawnBPClass.Class; } }
注1：由于使用的是字符串，因此在构建版本时，并不会cook并将/Game/ThirdPersonCPP/Blueprints/ThirdPersonCharacter的Blueprint UClass打进安装包
注2：为了让该资源打进安装包，需要让被cook的地图直接或间接引用该Blueprint UClass；或者在DefaultGame.ini文件的/Script/UnrealEd.ProjectPackagingSettings标签的DirectoriesToAlwaysCook数组中配置包含该资源的目录
[/Script/UnrealEd.ProjectPackagingSettings] +DirectoriesToAlwaysCook=(Path="/Game/ThirdPersonCPP/Blueprints")
资源强引用资源
下图中从MyTest1Character派生的Blueprint中的USkeletalMeshComponent* Mesh组件的USkeletalMesh* SkeletalMesh变量就强引用着SK_Mannequin的Skeletal Mesh资源
UCLASS(hidecategories=Object, config=Engine, editinlinenew, abstract) class ENGINE_API USkinnedMeshComponent : public UMeshComponent { GENERATED_UCLASS_BODY() // ... ... /** The skeletal mesh used by this component. */ UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Mesh") class USkeletalMesh* SkeletalMesh; // ... ... };
注1：由于USkeletalMesh* SkeletalMesh被标为EditAnywhere，因此ThirdPersonCharacter的Blueprint放置到游戏关卡中后，还可以对该Blueprint实例的USkeletalMeshComponent* Mesh组件的USkeletalMesh* SkeletalMesh指向的资源进行再次修改
注2：若被修饰为UPROPERTY(EditDefaultsOnly)，就只能在Blueprint中进行修改
软引用（soft reference）
为了控制何时加载资源，可使用TSoftObjectPtr（或TSoftClassPtr）模板类型来软引用资源（或UClass类型）。
软引用的工作方式与硬引用一样，可直接关联对应的资源（或UClass类型），在编辑器中界面表现是一样，可通过拖拽、下拉框或箭头选择要关联的资源。
在编辑器中，仅仅可通过弹出的Tips来区分
另外，被软引用到的资源会被编辑器中的Reference Viewer（引用查看器）工具识别，也会自动cook进安装包
与指定字符串路径相比，当在编辑器中对被软引用到的资源进行移动、改名等操作时，ue4会进行自动调整。
UCLASS(config=Game) class AMyTest1Character : public ACharacter { GENERATED_BODY() // ... ... public: UPROPERTY(Category = MyTest1, EditAnywhere) TSoftObjectPtr<UTexture2D> SourceTexture1; // 软引用 UPROPERTY(Category = MyTest1, EditAnywhere) UTexture2D* SourceTexture2; // 硬引用 };
在Referece Viewer中，粉色的线为弱引用，白色的线为强引用
UTexture2D* AMyTest1Character::GetLazyTexture2D() { if (!SourceTexture1.IsPending()) // 检查资源是否已准备好 { return SourceTexture1.Get(); } return SourceTexture1.LoadSynchronous(); // 手动来同步加载贴图资源 注：同步加载可能会导致游戏线程卡顿，开发者需要评估该行为是否合理 } UTexture2D* AMyTest1Character::GetLazyTexture2D_2() { if (!SourceTexture1.IsPending()) // 检查资源是否已准备好 { return SourceTexture1.Get(); } const FSoftObjectPath& SourceTextureRef = SourceTexture1.ToSoftObjectPath(); return Cast<UTexture2D>(UAssetManager::GetStreamableManager().LoadSynchronous(SourceTextureRef)); // 手动来同步加载贴图资源 注：同步加载可能会导致游戏线程卡顿，开发者需要评估该行为是否合理 } UTexture2D* AMyTest1Character::GetLazyTexture2D_3() { if (!SourceTexture1.IsPending()) // 检查资源是否已准备好 { return SourceTexture1.Get(); } const FSoftObjectPath& SourceTextureRef = SourceTexture1.ToSoftObjectPath(); UAssetManager::GetStreamableManager().RequestSyncLoad(SourceTextureRef); // 手动来同步加载贴图资源 注：同步加载可能会导致游戏线程卡顿，开发者需要评估该行为是否合理 return FindObject<UTexture2D>(nullptr, *SourceTexture1.ToString()); }
如果希望延迟加载UClass，可使用TSoftClassPtr模版类来引用对应的UClass
UCLASS(config=Game) class AMyTest1Character : public ACharacter { GENERATED_BODY() // ... ... public: UPROPERTY(Category = MyTest1, EditAnywhere) TSoftClassPtr<UMyBPObject> MyObjectClass; // 软引用 };
UClass* AMyTest1Character::GetLazyBPObjectClass() { if (MyObjectClass.IsValid()) // 检查类型是否已准备好 { return MyObjectClass.Get(); } return MyObjectClass.LoadSynchronous(); // 手动来同步加载蓝图Class 注：同步加载可能会导致游戏线程卡顿，开发者需要评估该行为是否合理 } UClass* AMyTest1Character::GetLazyBPObjectClass_2() { if (MyObjectClass.IsValid()) // 检查类型是否已准备好 { return MyObjectClass.Get(); } const FSoftObjectPath& AssetRef = MyObjectClass.ToSoftObjectPath(); return Cast<UClass>(UAssetManager::GetStreamableManager().LoadSynchronous(AssetRef)); // 手动来同步加载蓝图Class 注：同步加载可能会导致游戏线程卡顿，开发者需要评估该行为是否合理 } UClass* AMyTest1Character::GetLazyBPObjectClass_3() { if (MyObjectClass.IsValid()) // 检查类型是否已准备好 { return MyObjectClass.Get(); } const FSoftObjectPath& AssetRef = MyObjectClass.ToSoftObjectPath(); UAssetManager::GetStreamableManager().RequestSyncLoad(AssetRef); // 手动来同步加载蓝图Class 注：同步加载可能会导致游戏线程卡顿，开发者需要评估该行为是否合理 return FindObject<UClass>(nullptr, *MyObjectClass.ToString()); }
使用FSoftClassPath、FSoftObjectPath来软引用UClass和资源
UCLASS(config=Game) class AMyTest1Character : public ACharacter { GENERATED_BODY() // ... ... public: UPROPERTY(Category = MyTest1, EditAnywhere) FSoftClassPath SourceClass1; UPROPERTY(Category = MyTest1, EditAnywhere) FSoftObjectPath SourceObject1; };
注1：FSoftClassPath只能软引用Class、DynamicClass、BlueprintGeneratedClass、WidgetBlueprintGeneratedClass、AnimBluprintGeneratedClass和LinkerPlaceholderClass六大类。这些类的继承关系如下：
Class (632)
DynamicClass (760)
LinkerPlaceholderClass (1072)
BlueprintGeneratedClass (1512)
WidgetBlueprintGeneratedClass (1640)
AnimBlueprintGeneratedClass (2632)
注2：FSoftObjectPath可以软引用任何资源和UClass
注1：黄色的TPersistentObjectPtr、TSoftObjectPtr、TSoftClassPtr为模板类
注2：FSoftObjectPath类中FThreadSafeCounter CurrentTag、TSet<FName> PIEPackageNames（黄色）是static的
它们之间相互转换关系如下：
// === 定义FSoftObjectPath对象 === FSoftObjectPath ObjectPath1(TEXT("Material'/Engine/EngineDebugMaterials/VertexColorMaterial.VertexColorMaterial'")); FSoftObjectPath ObjectPath2; ObjectPath2.SetPath(TEXT("/Engine/EngineMaterials/DefaultDiffuse_TC_Masks.DefaultDiffuse_TC_Masks")); FSoftObjectPath ObjectPath3(UMyObject::StaticClass()->GetDefaultObject()); // ObjectPath3为：/Script/MyTest1.Default__MyObject // FSoftObjectPtr对象与FSoftObjectPath对象相互转换 FSoftObjectPtr FObjectPtr1(ObjectPath2); const FSoftObjectPath& ObjectPath4 = FObjectPtr1.ToSoftObjectPath(); FSoftObjectPtr FObjectPtr2(UMyObject::StaticClass()->GetDefaultObject()); // FObjectPtr2为：/Script/MyTest1.Default__MyObject const FSoftObjectPath& ObjectPath5 = FObjectPtr2.ToSoftObjectPath(); // === 定义TSoftObjectPtr<T>对象 === TSoftObjectPtr<UMyObject> TObjectPtr1(UMyObject::StaticClass()->GetDefaultObject()); // TObjectPtr1为：/Script/MyTest1.Default__MyObject // TSoftObjectPtr<T>对象与FSoftObjectPath对象相互转换 FSoftObjectPath ObjectPath6 = FSoftObjectPath("/Game/ThirdPerson/Meshes/Bump_StaticMesh.Bump_StaticMesh"); TSoftObjectPtr<UStaticMesh> TObjectPtr2(ObjectPath6); const FSoftObjectPath& ObjectPath7 = TObjectPtr2.ToSoftObjectPath(); // === 定义FSoftClassPath对象 === FSoftClassPath ClassPath1 = FSoftClassPath(TEXT("/Script/MyTest1.MyObject")); FSoftClassPath ClassPath2 = FSoftClassPath(UMyObject::StaticClass()); // ClassPath2为：/Script/MyTest1.MyObject FSoftClassPath ClassPath3; ClassPath3.SetPath(TEXT("/Game/ThirdPersonCPP/Blueprints/ThirdPersonCharacter.ThirdPersonCharacter_C")); // === 定义TSoftClassPtr<T>对象 === TSoftClassPtr<UMyObject> TClassPtr1(UMyObject::StaticClass()); // TClassPtr1为：/Script/MyTest1.MyObject // TSoftClassPtr<T>对象与FSoftObjectPath对象相互转换 FSoftObjectPath ObjectPath8(TEXT("/Game/ThirdPersonCPP/Blueprints/MyBPObject.MyBPObject_C")); TSoftClassPtr<UMyBPObject> TClassPtr2(ObjectPath8); const FSoftObjectPath& ObjectPath9 = TClassPtr2.ToSoftObjectPath();
字符串路径
资源（或UClass）通过字符串路径来指定，通过LoadObject（LoadClass）来加载。
该方式不能被Reference Viewer工具识别，资源进行移动、改名等操作时，不会自动调整。也不能自动cook进安装包。
加载资源
// 加载UI蓝图资源 注：不是UI蓝图Class FString MyWidgetBPPath = TEXT("/Game/ThirdPerson/UMG/MyWidgetBlueprint"); UObject* MyWidgetBPObject = LoadObject<UObject>(nullptr, *MyWidgetBPPath); // MyWidgetBPObject的类型为UWidgetBlueprint* // 加载Texture2D资源 FString TexturePath1 = TEXT("/Engine/EngineMaterials/DefaultDiffuse_TC_Masks"); UTexture2D* TextureObj1 = FindObject<UTexture2D>(nullptr, *TexturePath1); // 若之前没有加载，TextureObj1则返回为空 TextureObj1 = LoadObject<UTexture2D>(nullptr, *TexturePath1); // 在LoadObject内部在加载前也会调用FindObject先进行查找，如果不存在，才会从硬盘加载它 // 加载材质资源 FString MaterialPath1 = TEXT("/AnimationSharing/AnimSharingRed.AnimSharingRed"); UMaterialInterface* MaterialObj1 = LoadObject<UMaterialInterface>(nullptr, *MaterialPath1); // 加载StaticMesh资源 FString StaticMeshPath1 = TEXT("/Game/ThirdPerson/Meshes/Bump_StaticMesh.Bump_StaticMesh"); UStaticMesh* MyStaticMesh = Cast<UStaticMesh>(StaticLoadObject(UStaticMesh::StaticClass(), nullptr, *StaticMeshPath1));
如果在UObject类型的构造函数中，可以使用ConstructorHelpers::FObjectFinder来加载资源
static ConstructorHelpers::FObjectFinder<UStaticMesh> MyStaticMeshClass(TEXT("/Game/ThirdPerson/Meshes/Bump_StaticMesh")); UStaticMesh* MyStaticMesh = MyStaticMeshClass.Object;
加载UClass（类型）
// Native UClass FString MyObjectPath = TEXT("/Script/MyTest1.MyObject"); UClass* MyObjectHit = FindObject<UClass>(ANY_PACKAGE, *MyObjectPath); // 在游戏启动初始化时就已创建，因此可以直接Find到 UClass* MyObjectClass = LoadClass<UMyObject>(nullptr, *MyObjectPath); // MyObjectClass为UClass*类型 与MyObjectHit相等 //UClass* MyObjectClass = StaticLoadClass(UMyObject::StaticClass(), nullptr, *MyObjectClassPath); // 与上面语句等价 // UObjcet Blueprint UClass FString MyBPObjectPath = TEXT("/Game/ThirdPersonCPP/Blueprints/MyBlueprintObject.MyBlueprintObject_C"); UClass* MyBPObjectHit = FindObject<UClass>(ANY_PACKAGE, *MyBPObjectPath); UClass* MyBPObjectClass = LoadClass<UObject>(nullptr, *MyBPObjectPath); // MyBPObjectClass为UBlueprintGeneratedClass*类型 //UClass* MyBPObjectClass = StaticLoadClass(UObject::StaticClass(), nullptr, *MyBPObjectPath); // 与上面语句等价 // AActor Blueprint UClass FString PlayerPawnBPPath = TEXT("/Game/ThirdPersonCPP/Blueprints/ThirdPersonCharacter.ThirdPersonCharacter_C"); UClass* PlayerPawnBPClass = StaticLoadClass(APawn::StaticClass(), nullptr, *PlayerPawnBPPath); // PlayerPawnBPClass为UBlueprintGeneratedClass*类型 // 也可使用LoadClass来加载 如：UClass* PlayerPawnBPClass = LoadClass<APawn>(nullptr, *PlayerPawnBPPath); // 也可使用LoadObject来加载 如：UClass* PlayerPawnBPClass = LoadObject<UClass>(nullptr, *PlayerPawnBPPath); // 可以通过FindObject<UClass>函数来查找PlayerPawnBPPath对应的蓝图Class是否已经加载 // 另外，StaticLoadClass、LoadClass、LoadObject函数在加载前也会调用FindObject<UClass>来查找，如果不存在，才会从硬盘加载它 // UClass* PlayerPawnBPClass = FindObject<UClass>(nullptr, *PlayerPawnBPPath); // UUserWidget Blueprint UClass FString MyWidgetBPPath = TEXT("/Game/ThirdPerson/UMG/MyWidgetBlueprint.MyWidgetBlueprint_C"); UClass* MyWidgetBPClass = StaticLoadClass(UObject::StaticClass(), nullptr, *MyWidgetBPPath); // MyWidgetBPClass为UWidgetBlueprintGeneratedClass*类型 // 也可使用LoadClass来加载 如：UClass* MyWidgetBPClass = LoadClass<UObject>(nullptr, *MyWidgetBPPath); // 也可使用LoadObject来加载 如：UClass* MyWidgetBPClass = LoadObject<UClass>(nullptr, *MyWidgetBPPath); UUserWidget* DefaultMyWidgetBPObject = MyWidgetBPClass->GetDefaultObject<UUserWidget>(); UUserWidget* MyWidget = UWidgetBlueprintLibrary::Create(this, MyWidgetBPClass, nullptr); // 基于MyWidgetBPClass类型创建一个UserWidget实例
注1：Native UClass的字符串路径为/Script/【模块名】.【类型名】] // 类型名要去掉U、A等前缀
注2：Blueprint UClass的字符串路径为/【Engine | Game | 插件名】/<XXX>/[名称].[名称] _C
如果在UObject类型的构造函数中，可以使用ConstructorHelpers::FClassFinder来加载UClass（类型）
static ConstructorHelpers::FClassFinder<APawn> PlayerPawnBPClass(TEXT("/Game/ThirdPersonCPP/Blueprints/ThirdPersonCharacter")); UClass* PawnClass = PlayerPawnBPClass.Class; static ConstructorHelpers::FClassFinder<UObject> MyBPObjectClass(TEXT("/Game/ThirdPersonCPP/Blueprints/MyBlueprintObject")); UClass* MyClass = MyBPObjectClass.Class; static ConstructorHelpers::FClassFinder<UObject> MyWidgetBPClass(TEXT("/Game/ThirdPerson/UMG/MyWidgetBlueprint.MyWidgetBlueprint_C")); UClass* MyWidgetClass = MyWidgetBPClass.Class;
注：传给ConstructorHelpers::FClassFinder的Blueprint UClass的字符串路径不为[名称].[名称] _C时，其内部会进行补齐
参考