UE5 C++如何访问场景中其他蓝图Actor的组件并调用方法

算力阿峰

2026-8-27

问题描述

本人为Unreal引擎新手，从Unity转用UE，目前对引擎核心概念仍不熟悉，使用UE5版本（UE4对应解决方案也可适用），需要解决纯C++访问场景其他对象及组件的问题。

当前场景结构

场景中放置了名为Target的蓝图类Actor，该Actor挂载了自定义C++编写的movement组件，组件内包含更新位置的公有函数
场景中放置了Experiment蓝图Actor，挂载了自定义C++编写的TrialProcedure组件

具体需求

需要在Experiment Actor的TrialProcedure组件逻辑中，调用Target Actor的movement组件的位置更新函数。已知获取Target Actor引用后可通过GetComponentByClass()接口拿到目标组件再调用对应方法，但不希望通过蓝图逻辑传递引用，也不需要通过代码生成该Actor，需要纯C++逻辑实现获取场景中已存在的Target Actor引用。

解决方案

以下方案全部为纯C++实现，不需要蓝图传参，也不需要动态生成Actor，UE4/UE5通用：

方案1：通过Actor名称直接查找（最贴合当前场景）

你已经明确知道场景中目标Actor的名称是Target，直接用UE自带的TActorIterator遍历世界查找即可，逻辑和Unity里的GameObject.Find()类似。
首先引入必要头文件：

#include "EngineUtils.h"
#include "YourMovementComponent.h" // 替换成你自己写的movement组件头文件路径

把查找逻辑写在TrialProcedure组件的BeginPlay或者你需要触发调用的业务函数中，不要写在构造函数里，构造函数执行时世界还未初始化，拿不到场景对象：

AActor* TargetActor = nullptr;
// 遍历当前关卡所有Actor
for (TActorIterator<AActor> It(GetWorld()); It; ++It)
{
    if (It->GetName() == TEXT("Target"))
    {
        TargetActor = *It;
        break;
    }
}

// 必须加有效性判断，避免空引用崩溃
if (IsValid(TargetActor))
{
    // 查找挂载的movement组件
    UYourMovementComponent* MoveComp = TargetActor->FindComponentByClass<UYourMovementComponent>();
    if (IsValid(MoveComp))
    {
        // 直接调用你写的公有位置更新函数即可
        MoveComp->CallYourUpdatePositionFunc();
    }
}

如果后续你给Target蓝图做了C父类，把TActorIterator<AActor>的模板参数换成你的自定义C类即可，遍历效率会更高，不需要扫描关卡所有Actor。

方案2：通过Actor标签查找（更易维护）

如果后续可能修改Target的Actor名称，可以提前在编辑器细节面板给Target Actor加一个自定义标签（比如ExperimentTarget），用标签查找不会因为改名失效，逻辑和Unity的GameObject.FindGameObjectsWithTag一致。
需要引入头文件：

#include "Kismet/GameplayStatics.h"
#include "YourMovementComponent.h"

实现代码：

TArray<AActor*> FoundTargets;
UGameplayStatics::GetAllActorsWithTag(GetWorld(), FName("ExperimentTarget"), FoundTargets);

if (FoundTargets.IsEmpty() == false)
{
    AActor* TargetActor = FoundTargets[0];
    UYourMovementComponent* MoveComp = TargetActor->FindComponentByClass<UYourMovementComponent>();
    if (IsValid(MoveComp))
    {
        MoveComp->CallYourUpdatePositionFunc();
    }
}

方案3：通过类查找（适合单实例Actor）

如果你的关卡里全局只会存在一个Target类型的Actor，可以直接用类查找接口，代码最简洁：

// 如果Target没有自定义C++父类，不推荐用这个方案，加载蓝图类路径硬编码维护成本高
ATargetCppClass* TargetActor = UGameplayStatics::GetActorOfClass(GetWorld(), ATargetCppClass::StaticClass());
if (IsValid(TargetActor))
{
    UYourMovementComponent* MoveComp = TargetActor->FindComponentByClass<UYourMovementComponent>();
    if (IsValid(MoveComp))
    {
        MoveComp->CallYourUpdatePositionFunc();
    }
}

注意事项

所有查找逻辑不要放在构造函数里，最早在BeginPlay阶段执行，否则GetWorld()为空会拿不到对象
只要涉及对象、组件引用，调用函数前必须加IsValid()判空，避免空引用导致编辑器或打包版本崩溃
如果这段逻辑会高频触发，不要每次调用都重新遍历查找，在BeginPlay里查一次把引用存为组件的成员变量，后续直接用缓存的引用即可，减少不必要的性能开销
就算Target是纯蓝图类没有C父类，以上查找逻辑也可以正常运行，只要FindComponentByClass传入的是你自定义movement组件的C类，就能正确拿到组件实例调用公有函数。

内容的提问来源于stack exchange，提问作者Lerat94

UE5 C++如何访问场景中其他蓝图Actor的组件并调用方法

当前场景结构 #

具体需求 #

方案1：通过Actor名称直接查找（最贴合当前场景） #

方案2：通过Actor标签查找（更易维护） #

方案3：通过类查找（适合单实例Actor） #