首先创建继承自UActorComponent的自定义组件类如UBlinkComponent，实现StartBlink和StopBlink方法并在TickComponent中处理闪烁逻辑；然后在C++ Actor类如AMyCharacter中通过CreateDefaultSubobject添加该组件，并在BeginPlay中调用StartBlink；接着使用UFUNCTION(BlueprintCallable)和UPROPERTY(BlueprintReadWrite)将组件方法和属性暴露给蓝图；最后可在蓝图中可视化使用组件，适用于血量显示、受击反馈等独立模块，提升代码复用性与维护性。
在UE5中使用C++创建自定义Actor组件是扩展游戏功能的核心方式之一。通过自定义组件，你可以将特定行为（如伤害检测、音效控制、状态管理）模块化，并灵活地附加到任意Actor上，实现高复用性和清晰的代码结构。
1. 创建自定义Actor组件类
要在项目中添加一个C++组件，首先需要生成一个新的类继承自UActorComponent。可以通过虚幻编辑器的“新建C++类”向导选择“Actor Component”作为父类。
假设你正在创建一个用于管理角色闪烁效果的组件，命名为UBlinkComponent：
// BlinkComponent.h #pragma onceinclude "CoreMinimal.h"
include "Components/ActorComponent.h"
include "BlinkComponent.generated.h"
UCLASS(ClassGroup = (Custom), meta = (BlueprintSpawnableComponent)) class YOURGAME_API UBlinkComponent : public UActorComponent { GENERATED_BODY()
public: // 组件构造函数 UBlinkComponent();
// 启动闪烁 UFUNCTION(BlueprintCallable, Category = "Blink") void StartBlink(float Duration); // 停止闪烁 void StopBlink();protected: virtual void TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickInterval* ThisTickInterval) override;
private: float ElapsedTime = 0.0f; bool bIsBlinking = false; };
立即学习“C++免费学习笔记（深入）”；
// BlinkComponent.cpp #include "BlinkComponent.h" #include "DrawDebugHelpers.h"UBlinkComponent::UBlinkComponent() { PrimaryComponentTick.bCanEverTick = true; PrimaryComponentTick.TickGroup = TG_PrePhysics; }
void UBlinkComponent::StartBlink(float Duration) { bIsBlinking = true; ElapsedTime = 0.0f; }
void UBlinkComponent::StopBlink() { bIsBlinking = false; }
void UBlinkComponent::TickComponent(float DeltaTime, ELevelTick TickType, FActorComponentTickInterval* ThisTickInterval) { Super::TickComponent(DeltaTime, TickType, ThisTickInterval);
if (!bIsBlinking) return; ElapsedTime += DeltaTime; // 示例：每0.2秒打印一次位置（可替换为材质切换逻辑） if (FMath::Fmod(ElapsedTime, 0.2f) < DeltaTime) { if (AActor* Owner = GetOwner()) { UE_LOG(LogTemp, Warning, TEXT("Blink effect active at %.2f seconds"), ElapsedTime); } } if (ElapsedTime >= 3.0f) // 假设持续3秒 { StopBlink(); }}
2. 在C++ Actor中使用该组件
创建完组件后，可以在自定义的Character或Actor类中添加并初始化它。
// MyCharacter.h UCLASS() class YOURGAME_API AMyCharacter : public ACharacter { GENERATED_BODY()public: AMyCharacter();
protected: virtual void BeginPlay() override;
private: UPROPERTY(VisibleAnywhere) UBlinkComponent* BlinkComp; };
立即学习“C++免费学习笔记（深入）”；
// MyCharacter.cpp AMyCharacter::AMyCharacter() { BlinkComp = CreateDefaultSubobject(TEXT("BlinkComponent")); } void AMyCharacter::BeginPlay() { Super::BeginPlay(); if (BlinkComp) { BlinkComp->StartBlink(3.0f); } }
3. 暴露给蓝图以便可视化使用
通过在头文件中使用UFUNCTION(BlueprintCallable)和UPROPERTY(BlueprintReadWrite)，可以让设计师在蓝图中调用组件方法或查看状态。
编译完成后，在蓝图编辑器中选中使用该组件的Actor，即可在细节面板看到组件，并通过事件图表调用StartBlink等函数。
4. 实际应用场景建议
- 用于实现血量显示、受击反馈、技能冷却等独立逻辑
- 避免将所有功能写在Actor内部，提升代码维护性
- 多个组件可协同工作，例如“生命组件”触发“闪烁组件”进行视觉反馈
- 结合Gameplay Ability System时，常用于承载Attribute Set或Effect处理器
基本上就这些。只要掌握UActorComponent的生命周期和与Owner的交互方式，就能高效构建可复用的游戏模块。
