Unreal C++如何正确编写GetActorOfClass获取单个Actor引用

前提检查 #

确保cpp文件顶部已引入必要头文件：

#include "Kismet/GameplayStatics.h"
#include "你的目标Actor类路径/GameManager.h" // 若要获取AActorB则替换为AActorB的实际头文件路径

正确代码实现 #

以获取AGameManager引用的需求为例，BeginPlay中的代码写法如下：

void ALocalMaster::BeginPlay()
{
    Super::BeginPlay();

    // 第一个参数传入当前World上下文，第二个参数传入目标类的静态类标识
    AActor* TempFoundActor = UGameplayStatics::GetActorOfClass(GetWorld(), AGameManager::StaticClass());
    // 类型+空值双重校验，避免空指针崩溃
    if (IsValid(TempFoundActor))
    {
        GameManager = Cast<AGameManager>(TempFoundActor);
    }
}

如果是获取AActorB的引用，只需要把代码中的AGameManager替换为AActorB即可。

错误点说明 #

你之前的代码存在以下问题：

• GetActorOfClass是UGameplayStatics的静态方法，调用时必须加类名前缀UGameplayStatics::
• 入参规则错误：第一个参数需要传入当前世界上下文，Actor类中可以直接用GetWorld()，第二个参数需要传入目标类的StaticClass()
• 不要直接用static_cast做UE对象类型转换，用UE原生的Cast会自动做类型合法性校验，安全性更高
• 必须加空值判断：如果当前场景中没有生成目标类的实例，GetActorOfClass会返回nullptr，直接赋值会触发空指针崩溃

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