Unreal5中是否有类似GetAllActorsOfClass()的范围Actor查询方法？

针对大量Actor场景下的球体范围影响需求，以下是几种高效过滤非目标对象的方案：

1. 优先使用引擎内置空间查询函数 #

Unreal引擎底层基于Octree空间分区实现了高效的范围查询，直接调用OverlapActors或SphereTraceMulti等函数，无需手动遍历所有Actor，引擎会自动过滤出范围内的对象。

示例代码（球体重叠查询）： #

// 配置查询目标的碰撞通道（提前在项目设置中定义专属通道）
FCollisionObjectQueryParams ObjectQueryParams;
ObjectQueryParams.AddObjectTypesToQuery(ECC_CustomAffectedActor);

// 设置球体碰撞形状（半径根据需求调整）
FCollisionShape SphereShape;
SphereShape.SetSphere(600.0f);

// 存储查询结果
TArray<AActor*> AffectedActors;

// 执行查询：以球体当前位置为中心，查询范围内匹配通道的Actor
GetWorld()->OverlapActors(
    AffectedActors,
    BallActor->GetActorLocation(),
    FQuat::Identity,
    ObjectQueryParams,
    FCollisionQueryParams::DefaultQueryParam
);

// 遍历处理结果
for (AActor* Actor : AffectedActors)
{
    // 跳过发射球自身
    if (Actor == BallActor) continue;
    
    // 执行你的影响逻辑（如触发接口、施加力等）
    if (IAffectedByBall* AffectInterface = Cast<IAffectedByBall>(Actor))
    {
        AffectInterface->HandleBallImpact();
    }
}

2. 用碰撞通道与Actor标签缩小查询范围 #

• 在项目设置→碰撞中创建专属碰撞通道（如ECC_AffectedByBall），将需要被影响的Actor的碰撞组件设置为该通道。
• 或给目标Actor添加统一标签（如Tag_AffectedByBall），查询时通过FCollisionQueryParams的TagsToMatch过滤，进一步减少结果数量。

3. 预维护目标Actor列表（静态/半静态场景） #

如果场景中需要被影响的Actor数量固定、位置变动少，可以在游戏初始化时将它们存入一个全局数组：

// 全局或GameInstance中的数组
TArray<AActor*> PreRegisteredAffectedActors;

// 初始化时收集（如在GameMode的BeginPlay中）
void AMyGameMode::BeginPlay()
{
    Super::BeginPlay();
    UGameplayStatics::GetAllActorsOfClass(GetWorld(), AMyAffectedActor::StaticClass(), PreRegisteredAffectedActors);
}

后续查询时仅遍历该数组，配合FVector::DistSquared（比Dist更快，无需开根号）快速过滤范围内对象：

const FVector BallPos = BallActor->GetActorLocation();
const float RadiusSquared = 600.0f * 600.0f;

for (AActor* Actor : PreRegisteredAffectedActors)
{
    if (FVector::DistSquared(Actor->GetActorLocation(), BallPos) <= RadiusSquared)
    {
        // 执行影响逻辑
    }
}

4. 手动空间分区（超大规模场景） #

如果场景Actor数量极多（数千级），可以基于Unreal的FOctree类手动构建空间分区，将目标Actor按位置划分到不同节点。查询时仅遍历球体覆盖的Octree节点，进一步降低检测量。不过该方案仅在引擎内置查询无法满足性能需求时使用。

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