首先创建继承自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 once
<h1>include "CoreMinimal.h"</h1><h1>include "Components/ActorComponent.h"</h1><h1>include "BlinkComponent.generated.h"</h1><p>UCLASS(ClassGroup = (Custom), meta = (BlueprintSpawnableComponent))
class YOURGAME_API UBlinkComponent : public UActorComponent
{
GENERATED_BODY()</p><p>public:
// 组件构造函数
UBlinkComponent();</p><pre class='brush:php;toolbar:false;'>// 启动闪烁
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"
<p>UBlinkComponent::UBlinkComponent()
{
PrimaryComponentTick.bCanEverTick = true;
PrimaryComponentTick.TickGroup = TG_PrePhysics;
}</p><p>void UBlinkComponent::StartBlink(float Duration)
{
bIsBlinking = true;
ElapsedTime = 0.0f;
}</p><p>void UBlinkComponent::StopBlink()
{
bIsBlinking = false;
}</p><p>void UBlinkComponent::TickComponent(float DeltaTime, ELevelTick TickType,
FActorComponentTickInterval* ThisTickInterval)
{
Super::TickComponent(DeltaTime, TickType, ThisTickInterval);</p><pre class='brush:php;toolbar:false;'>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()
<p>public:
AMyCharacter();</p><p>protected:
virtual void BeginPlay() override;</p><p>private:
UPROPERTY(VisibleAnywhere)
UBlinkComponent* BlinkComp;
};</p>
立即学习“C++免费学习笔记（深入）”；
// MyCharacter.cpp
AMyCharacter::AMyCharacter()
{
BlinkComp = CreateDefaultSubobject<UBlinkComponent>(TEXT("BlinkComponent"));
}
<p>void AMyCharacter::BeginPlay()
{
Super::BeginPlay();
if (BlinkComp)
{
BlinkComp->StartBlink(3.0f);
}
}</p>3. 暴露给蓝图以便可视化使用
通过在头文件中使用UFUNCTION(BlueprintCallable)和UPROPERTY(BlueprintReadWrite)，可以让设计师在蓝图中调用组件方法或查看状态。
编译完成后，在蓝图编辑器中选中使用该组件的Actor，即可在细节面板看到组件，并通过事件图表调用StartBlink等函数。
4. 实际应用场景建议
- 用于实现血量显示、受击反馈、技能冷却等独立逻辑
- 避免将所有功能写在Actor内部，提升代码维护性
- 多个组件可协同工作，例如“生命组件”触发“闪烁组件”进行视觉反馈
- 结合Gameplay Ability System时，常用于承载Attribute Set或Effect处理器
基本上就这些。只要掌握UActorComponent的生命周期和与Owner的交互方式，就能高效构建可复用的游戏模块。
