第4章 Actor 与 Component

第4章：Actor 与 Component：Actor 生命周期、SceneComponent、ActorComponent 的使用

好，咱们今天聊聊 Actor 和 Component。这是 Unreal 里最核心的一对搭档。说白了，Actor 就是舞台上那个演员，Component 就是演员身上的装备——武器、盔甲、甚至走路姿势。没有 Component，Actor 就是个空壳子。

我个人习惯把 Actor 比作一个「容器」。它本身几乎啥也干不了，真正干活的是挂在上面的 Component。你想想看，一个 StaticMeshComponent 让 Actor 有了外观，一个 MovementComponent 让它能移动，一个 AudioComponent 让它能发声。嗯，这就是 Unreal 的组件化设计哲学。

4.1 Actor 的生命周期

每个 Actor 从出生到销毁，都有一套固定的流程。我在项目中遇到过不少新手，直接在构造函数里写网络同步逻辑，结果发现根本跑不通——因为那时候 Actor 还没完全准备好。

生命周期主要分三个阶段：

初始化阶段：构造函数 → PostInitProperties → BeginPlay
运行阶段：Tick → 事件回调 → 网络同步
销毁阶段：EndPlay → BeginDestroy → FinishDestroy

核心要点：BeginPlay 是你在游戏运行时第一个能安全操作的地方。构造函数里别碰其他 Actor，也别做网络相关的事。

为什么会这样？因为 Actor 在构造时，它的 World 指针可能还是空的。我曾经在构造函数里调用 GetWorld()->SpawnActor()，结果编辑器直接崩了。从那以后，我所有初始化逻辑都放在 BeginPlay 里。

// 正确的生命周期使用方式
void AMyActor::BeginPlay()
{
    Super::BeginPlay();
    
    // 这里可以安全地获取 World
    if (GetWorld())
    {
        // 生成其他 Actor 或 Component
    }
}

void AMyActor::EndPlay(const EEndPlayReason::Type EndPlayReason)
{
    // 清理工作放在这里
    // 比如停止定时器、销毁动态创建的 Component
    
    Super::EndPlay(EndPlayReason);
}

注意：EndPlay 不一定会被调用！如果游戏直接关闭，某些 Actor 可能跳过 EndPlay 直接进入销毁流程。所以关键数据一定要在 SaveGame 里持久化。

4.2 SceneComponent：有位置的组件

SceneComponent 是所有带 Transform（位置、旋转、缩放）的组件的基类。你想想看，一个 StaticMeshComponent、一个 CameraComponent、一个 LightComponent，它们都继承自 SceneComponent。

我建议你把 SceneComponent 想象成一个「空间锚点」。它本身不渲染任何东西，但它决定了子组件的位置。这在做复杂机械结构时特别有用——比如一个机器人的手臂，每个关节都是一个 SceneComponent，挂上不同的 Mesh。

组件类型	是否有 Transform	常见用途
SceneComponent	是	作为空间锚点、挂载点
PrimitiveComponent	是	有碰撞和渲染的组件
ActorComponent	否	纯逻辑组件

// 创建一个挂载点
USceneComponent* MountPoint = CreateDefaultSubobject<USceneComponent>(TEXT("MountPoint"));
RootComponent = MountPoint;

// 在挂载点上附加一个 Mesh
UStaticMeshComponent* MeshComp = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("Mesh"));
MeshComp->SetupAttachment(MountPoint);

小技巧：如果你需要多个子物体围绕一个中心旋转，用 SceneComponent 做父级，所有子组件附加到它上面。这样你只需要旋转父级 SceneComponent，所有子物体都会跟着动。

4.3 ActorComponent：纯逻辑组件

ActorComponent 没有位置信息。它只负责逻辑。比如一个 HealthComponent 管理血量，一个 InventoryComponent 管理背包。这些东西不需要知道自己在世界里的位置。

我记得有一次重构项目，把所有血量、护甲、状态效果都从 Actor 里抽出来，放到独立的 ActorComponent 里。结果代码清晰了不止一个档次。每个组件只关心自己的事，Actor 只负责协调。

// 一个简单的血量组件
UCLASS()
class UHealthComponent : public UActorComponent
{
    GENERATED_BODY()

public:
    UFUNCTION()
    void TakeDamage(float DamageAmount)
    {
        CurrentHealth -= DamageAmount;
        if (CurrentHealth <= 0)
        {
            OnDeath.Broadcast();
        }
    }

private:
    UPROPERTY()
    float CurrentHealth = 100.0f;

    UPROPERTY(BlueprintAssignable)
    FOnDeathSignature OnDeath;
};

设计原则：一个组件只做一件事。如果你发现一个组件里既有移动逻辑又有伤害逻辑，拆！拆成两个组件。这样复用性会好很多。

4.4 组件间的通信

组件之间怎么通信？我见过有人直接在组件里保存其他组件的指针，然后互相调用。嗯，这其实是个坏习惯。耦合度太高了。

更好的方式是通过 Actor 来中转。或者用事件分发器。我曾经在一个项目里，所有组件都通过一个全局事件系统来通信，结果调试起来简直噩梦。后来改成每个 Actor 自己管理组件间通信，清爽多了。

// 通过 Actor 中转
void AMyActor::SomeFunction()
{
    UHealthComponent* HealthComp = FindComponentByClass<UHealthComponent>();
    UMovementComponent* MoveComp = FindComponentByClass<UMovementComponent>();
    
    if (HealthComp && MoveComp)
    {
        // 让 Actor 协调两个组件
        if (HealthComp->IsAlive())
        {
            MoveComp->SetActive(true);
        }
    }
}

避坑指南：我曾经在组件里直接调用 GetOwner()->FindComponentByClass()，每帧都调用。结果性能分析一看，这个查找操作占了 5% 的 CPU 时间。正确的做法是在 BeginPlay 里缓存好组件指针。

4.5 动态创建与销毁组件

不是所有组件都要在构造函数里创建。有时候你需要运行时动态添加组件。比如一个角色捡起武器后，动态挂载一个武器 Mesh 组件。

// 动态添加组件
UStaticMeshComponent* WeaponMesh = NewObject<UStaticMeshComponent>(this);
WeaponMesh->SetupAttachment(GetRootComponent());
WeaponMesh->RegisterComponent(); // 别忘了注册！

// 动态移除组件
if (WeaponMesh)
{
    WeaponMesh->DestroyComponent();
}

关键点：动态创建的组件必须调用 RegisterComponent()，否则它不会参与 Tick 和渲染。我刚开始做的时候经常忘，结果组件创建了但啥也不显示，排查了半天。

嗯，关于 Actor 和 Component 的核心内容就这些。说白了就是：Actor 是骨架，Component 是血肉。把逻辑拆到组件里，你的代码会更容易维护，也更容易复用。下一章咱们聊聊更具体的 Gameplay 框架，看看 PlayerController 和 Pawn 是怎么配合的。

📚 课程目录