Actor

What Is :
Actor 是可以放置在关卡中的任何对象，例如摄像机、静态网格体或玩家起始位置。

What Can Do :
Actor 支持 3D 变换，例如平移、旋转和缩放。
Actor 可以通过游戏代码（C++或蓝图）创建（生成）和销毁。
Actor 的支持网络复制属性和函数调用。

组件¶

Actor 视为容纳称为组件的特殊类型对象的容器。不同类型的组件可用于控制 Actor 的移动方式、渲染方式等。

UActorComponent 是所有组件的基类。

USceneComponent 具有变换的 UActorComponent 。
Actor 的变换由 USceneComponent 层级结构根部的 USceneComponent 决定。

UPrimitiveComponent 是所有图形表示几何组件的基类。

根组件¶

What Is :
每个 Actor 都有一个 RootComponent 且 RootComponent 必须是 USceneComponent 的子类。
What Can Do :
提供世界的 Transform 信息。
提供层次化组织 Components 和 Actor 的能力。

类型为 USceneComponent*，是 Actor 的根场景组件，负责定义 Actor 在世界中的位置、旋转和缩放。

所有其他 USceneComponent 类型的组件（例如 UStaticMeshComponent、USkeletalMeshComponent）通过 AttachToComponent 形成层次结构，挂接到 RootComponent 或其他场景组件。

如果 RootComponent 为 nullptr，Actor 不会出现在场景中（无法进行变换）。

UPROPERTY(BlueprintGetter=K2_GetRootComponent, Category="Transformation")
TObjectPtr<USceneComponent> RootComponent;

/**
* Sets root component to be the specified component.  NewRootComponent's owner should be this actor.
* @return true if successful
*/
ENGINE_API bool SetRootComponent(USceneComponent* NewRootComponent);

Actor本身没有变换，Actor的变换由根 RootComponent 决定。

具体来说，如果此 Root Component 是 SceneComponent，它将提供 Actor 的变换信息。否则，Actor 将没有变换信息。

const FTransform& AActor::GetTransform() const  
{  
    return ActorToWorld();  
}

FORCEINLINE const FTransform& AActor::ActorToWorld() const  
{  
    return (RootComponent ? RootComponent->GetComponentTransform() : FTransform::Identity);  
}

组件的绑定和注册¶

静态绑定¶

在 Blueprint 或 C++ 类中定义的组件通过 UPROPERTY() 宏标记组件为 AActor 的成员变量。

在构建函数中通过 CreateDefaultSubobject 创建实例绑定到变量。

如果是 SceneComponent，调用 SetupAttachment 函数设置层次结构。

动态绑定¶

运行时通过 AActor::AddComponent 添加一个新组建到Actor，并分配所有权到该 Actor。

支持自动附加（第一个组件成为根组件，后续组件挂载到根下），但如果设置 bManualAttachment 为 true，则需要手动处理附加逻辑。

注册和注销¶

组件和Actor层级结构¶

graph LR
    A[Actor] --> B["Root Component(SceneComponent)"]
    A --> C[Actor Component]
    A --> D[Actor Component]
    A --> E["..."]
    B --> F[Scene Component]
    B --> G[Scene Component]
    F --> H[Scene Component]
    G --> I[Scene Component]