UPROPERTY#

在虚幻 5 中，UObject 类型字段更推荐写成 TObjectPtr<T>，尤其是组件引用，这样更符合当前引擎的对象引用习惯。

重要： 如果不添加 UPROPERTY 反射宏，随时都有可能被垃圾回收（因为继承自 UObject）。

声明时在括号内部，可以增加反射说明符：

• VisibleAnywhere：可以在编辑器窗口中看见，但是无法编辑。也就是以只读的方式显示在编辑器窗口中

UFUNCTION#

常见函数说明符：

• BlueprintCallable：允许在蓝图中调用
• BlueprintPure：纯函数，没有执行引脚，适合 Get 类逻辑
• BlueprintImplementableEvent：仅声明，由蓝图实现
• BlueprintNativeEvent：可在 C++ 中给默认实现，也可被蓝图覆写

典型写法：

1
UFUNCTION(BlueprintCallable, Category = "Combat")
2
void StartAttack();

创建#

常见有两种创建方式：

• 构造函数中通过 CreateDefaultSubobject 创建默认组件
• 运行时通过 NewObject 动态创建，然后 RegisterComponent

1
HealthComponent = CreateDefaultSubobject<UMyHealthComponent>(TEXT("HealthComponent"));

1
UMyLogicComponent* RuntimeComponent = NewObject<UMyLogicComponent>(this);
2
RuntimeComponent->RegisterComponent();

如果是 USceneComponent，运行时还要额外处理附着关系：

1
RuntimeSceneComponent->AttachToComponent(GetRootComponent(), FAttachmentTransformRules::KeepRelativeTransform);

注册流程#

组件真正开始参与世界逻辑，关键在于“注册”：

1. 创建组件对象
2. 绑定到所属 Actor
3. OnRegister
4. InitializeComponent
5. 跟随 Actor 进入 BeginPlay

默认子对象通常由引擎自动完成注册；运行时动态组件要自己记得 RegisterComponent()。

销毁#

可以获取对应的 ActorComponent，然后调用 DestroyComponent()。

注意： 在调用销毁过后，一定要将该指针置空。

1
MyLogicComponent->DestroyComponent();
2
MyLogicComponent = nullptr;

运行阶段常见入口#

• BeginPlay()：游戏开始
• TickComponent()：每帧更新
• EndPlay()：结束前清理
• OnRegister()：注册到世界时调用
• OnUnregister()：取消注册时调用

如果组件需要 Tick，还要在构造中开启：

1
PrimaryComponentTick.bCanEverTick = true;

获取#

关于获取组件，可以在 Actor 上使用以下方法：

• FindComponentByClass<T>()：开销较大
• FindComponentByTag<T>()：开销相对较小