游戏引擎 / 系统课时

用组件拆分Gameplay能力

用组件拆分Gameplay能力

当交互、血量、拾取都直接写进角色或道具 Actor,类会很快同时承担输入、状态和业务规则。Actor Component 更适合承载可复用的 Gameplay 能力:Actor 决定“我拥有哪些能力”,组件负责各能力自己的状态与行为。本课用三个组件划清边界,并给出可编译的血量组件示例。

学习目标

  • 判断哪些 Gameplay 逻辑适合拆成 UActorComponent。
  • 为交互、血量和拾取能力划分清晰的状态与职责边界。
  • 用组件事件把能力结果暴露给 Actor、UI 或蓝图,而不是制造组件之间的强耦合。

先按能力边界拆,而不是按函数数量拆

一个组件应该围绕一组会一起变化的状态与规则。例如血量组件拥有最大血量、当前血量和受伤规则;交互组件负责“这个 Actor 能否被交互、交互时发生什么”;拾取组件负责一次性拾取、是否已消费以及拾取结果。

Actor 与可复用 Gameplay 组件的职责结构

拆分后,Actor 仍然负责组合。例如敌人可以只有血量组件,门只有交互组件,补给品同时拥有交互和拾取组件。是否挂载组件本身就表达了 Actor 的能力集合,避免在一个超大的基类里堆大量布尔开关。

写一个真正可复用的血量组件

下面示例把最大血量、当前血量和伤害处理放进 UHealthComponent,并通过动态多播事件通知外部。它不直接访问 HUD,也不假设 Owner 一定是玩家或敌人,因此可以挂到不同 Actor 上。

cpp
// HealthComponent.h
#pragma once

#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "HealthComponent.generated.h"

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(
    FOnHealthChanged,
    float, CurrentHealth,
    float, MaxHealth
);

UCLASS(ClassGroup=(Gameplay), meta=(BlueprintSpawnableComponent))
class UHealthComponent : public UActorComponent
{
    GENERATED_BODY()

public:
    UHealthComponent();

    UFUNCTION(BlueprintCallable, Category="Health")
    void ApplyDamage(float Amount);

    UFUNCTION(BlueprintPure, Category="Health")
    float GetHealth() const { return CurrentHealth; }

    UPROPERTY(BlueprintAssignable, Category="Health")
    FOnHealthChanged OnHealthChanged;

protected:
    virtual void BeginPlay() override;

    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Health", meta=(ClampMin="1.0"))
    float MaxHealth = 100.0f;

    UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category="Health")
    float CurrentHealth = 0.0f;
};
cpp
// HealthComponent.cpp
#include "HealthComponent.h"

UHealthComponent::UHealthComponent()
{
    PrimaryComponentTick.bCanEverTick = false;
}

void UHealthComponent::BeginPlay()
{
    Super::BeginPlay();
    CurrentHealth = MaxHealth;
    OnHealthChanged.Broadcast(CurrentHealth, MaxHealth);
}

void UHealthComponent::ApplyDamage(float Amount)
{
    if (Amount <= 0.0f || CurrentHealth <= 0.0f)
    {
        return;
    }

    CurrentHealth = FMath::Clamp(CurrentHealth - Amount, 0.0f, MaxHealth);
    OnHealthChanged.Broadcast(CurrentHealth, MaxHealth);
}

预期结果

text
组件开始运行后:CurrentHealth = MaxHealth
调用 ApplyDamage(25):CurrentHealth 从 100 变为 75,并广播 OnHealthChanged(75, 100)
重复伤害直到 0:CurrentHealth 不会变成负数
Amount <= 0:忽略本次调用

在角色 C++ 构造函数中可用 CreateDefaultSubobject<UHealthComponent> 固定挂载,也可以在 Actor 蓝图里使用 Add Component 添加它。组件不 Tick 时应像示例一样关闭 Tick,避免为纯事件驱动能力付出无意义的每帧成本。

给交互与拾取组件划清职责

交互与拾取经常被写成一件事,但二者不是同一层。交互解决“玩家对目标发起了什么动作”,拾取解决“这个物体被领取后如何进入已消费状态”。门可以交互却不能拾取,道具可以既能交互又能拾取。

组件 自己保存的状态 对外入口 典型事件
UInteractableComponent 是否启用、交互提示或交互类型 Interact(AActor* Interactor) OnInteracted
UHealthComponent 最大血量、当前血量 ApplyDamage(float Amount) OnHealthChanged
UPickupComponent 是否已拾取、可否重复拾取 TryPickup(AActor* Picker) OnPickedUp

交互组件不应直接把物品塞进某个具体背包类;更稳妥的做法是先广播“发生了交互”。拾取组件收到交互后再判断是否可领取,并广播拾取结果;背包、任务或音效系统订阅结果,各自处理后续动作。这样换 UI、换库存系统时,不需要改交互组件。

在 Actor 中组合能力并连接事件

组件化不等于所有组件彼此通信。优先让 Owner 或更高层 Gameplay 对象负责组装关系:Actor 在构造阶段挂载组件,在 BeginPlay 或蓝图事件图中绑定组件事件,再把事件转成该 Actor 的表现或业务行为。

片段示例:以下代码依赖前面的 UHealthComponent,展示一个角色如何把组件作为能力挂载;它不是独立程序入口。

cpp
// MyCharacter.cpp
#include "MyCharacter.h"
#include "HealthComponent.h"

AMyCharacter::AMyCharacter()
{
    HealthComponent = CreateDefaultSubobject<UHealthComponent>(TEXT("HealthComponent"));
}

生效行为:该角色实例创建时会同时创建一个血量组件;组件的 MaxHealth 可在蓝图默认值中配置,UI 或死亡逻辑可以绑定 OnHealthChanged,而不需要把这些职责写回 UHealthComponent。

什么时候不要继续拆组件

只有一个 Actor 使用、没有独立状态、也没有复用或替换需求的两三行逻辑,留在 Actor 内通常更清楚。反过来,如果一个组件开始直接查找 HUD、GameMode、库存、任务和音频对象,它已经重新变成“万能类”,只是从 Actor 换了位置。

实际项目中可以用一个简单标准判断:组件应当拥有明确能力边界、独立状态和少量稳定入口;跨系统协作通过事件、接口或 Owner 组装完成。这样交互、血量和拾取才能真正成为可组合能力,而不是把原来的耦合复制到三个新文件里。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用组件拆分Gameplay能力

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通