完整教程:Unreal Engine UObject

Unreal Engine - UObject


定义

  • UObjectUnreal Engine 中所有对象的基类
  • 提供 核心功能:内存管理、反射系统、序列化、垃圾回收。
  • 所有游戏对象、组件、资源(如 AActor, UComponent, UMaterial)都直接或间接继承自 UObject

类继承关系

UObject
├── UActorComponent
├── UAssetUserData
├── UUserWidget
└── AActor
└── ... 其他 Actor 派生类
  • UObject:基础对象类,支持 GC、序列化、反射。
  • AActor:世界中的可放置对象。
  • UActorComponent:Actor 的组件,可组合行为。
  • UUserWidget:UI 基类,可在蓝图中可视化编辑。

⚙️ 关键特性

  • 反射系统(Reflection)
    • 支持 UCLASS(), UPROPERTY(), UFUNCTION() 宏。
    • 可在运行时访问类信息、属性、函数。
    • 蓝图和编辑器可以直接操作对象属性和函数。
  • 垃圾回收(Garbage Collection, GC)
    • 对象通过 NewObject<>() 创建,由 UE 自动管理生命周期。
    • 不需要手动 delete。
    • 支持 RootSet、标记引用对象防止被回收。
  • 序列化(Serialization)
    • 对象属性可以保存/加载。
    • 支持标记如 SaveGame, Transient, Config
    • 蓝图资产和游戏状态可以持久化。
  • 生命周期管理
    • 核心回调:
      • Constructor:对象构造
      • PostInitProperties():初始化完成
      • BeginDestroy():开始销毁
      • FinishDestroy():销毁完成
    • 支持动态创建、复制、重置。
  • 蓝图支持
    • 可作为蓝图基类创建资产。
    • 反射系统支持在蓝图中访问对象属性和调用函数。

使用方法

1. 创建 UObject 对象

// 创建一个 UObject 派生类实例
UMyObject* MyObj = NewObject<UMyObject>();
  // 设置属性
  MyObj->Health = 100;
  // 调用函数
  MyObj->
  Initialize();
  • 建议使用 NewObject<>()ConstructObject<>(),避免直接用 new

2. 属性与函数绑定

  • 使用 UPROPERTY() 控制序列化和 GC
  • 使用 UFUNCTION() 暴露函数给蓝图
UCLASS()
class UMyObject
: public UObject
{
GENERATED_BODY()
public:
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Stats")
int32 Health;
UFUNCTION(BlueprintCallable, Category="Actions")
void Initialize();
};

常见子类与用途

用途
AActor世界中可放置对象
UActorComponentActor 的组件行为
UUserWidgetUI 界面基类
UMaterial材质资源
UTexture纹理资源
USoundBase声音资源
UGameInstance游戏实例生命周期管理

小结

  • UObject = UE 核心对象基类
  • ✅ 提供 反射、序列化、GC、生命周期管理
  • ✅ 所有游戏对象、组件、资源都继承自 UObject
  • ✅ 可在蓝图和 C++ 中统一管理对象

posted @ 2025-08-23 21:06  yfceshi  阅读(53)  评论(0)    收藏  举报