虚幻引擎中ProjectileMovement组件的碰撞检测问题与解决方案

1. 问题现象与背景分析

在虚幻引擎开发中，我们经常需要实现发射物（Projectile）功能。一个典型的实现方式是为Actor添加ProjectileMovement组件，使其具备物理运动特性。然而在实际开发中，我发现一个奇怪的现象：当为Actor添加ProjectileMovement组件后，原本正常工作的重叠委托（OnComponentBeginOverlap）突然无法获取正确的碰撞坐标信息。

这个问题特别容易出现在需要精确检测碰撞位置的场景中，比如：

• 子弹命中特效需要在碰撞点生成
• 需要根据命中位置计算伤害区域
• 物理交互需要精确的碰撞点坐标

2. 问题复现与初步排查

2.1 基础实现代码

首先，让我们看一个标准的发射物Actor实现。以下代码展示了如何创建一个带有碰撞检测的发射物：

cpp复制// 头文件声明
UCLASS()
class AMyProjectile : public AActor
{
    GENERATED_BODY()
    
public:
    // 碰撞组件
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly)
    USphereComponent* CollisionComponent;
    
    // 发射物移动组件
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly)
    UProjectileMovementComponent* ProjectileMovement;
    
    // 构造函数
    AMyProjectile();
    
    // 重叠事件处理函数
    UFUNCTION()
    void OnOverlapBegin(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor, 
                       UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, 
                       bool bFromSweep, const FHitResult& SweepResult);
};

// 源文件实现
AMyProjectile::AMyProjectile()
{
    // 创建碰撞组件
    CollisionComponent = CreateDefaultSubobject<USphereComponent>(TEXT("CollisionComp"));
    CollisionComponent->InitSphereRadius(5.0f);
    CollisionComponent->BodyInstance.SetCollisionProfileName("Projectile");
    RootComponent = CollisionComponent;
    
    // 绑定重叠事件
    CollisionComponent->OnComponentBeginOverlap.AddDynamic(this, &AMyProjectile::OnOverlapBegin);
    
    // 创建发射物移动组件
    ProjectileMovement = CreateDefaultSubobject<UProjectileMovementComponent>(TEXT("ProjectileComp"));
    ProjectileMovement->UpdatedComponent = CollisionComponent;
    ProjectileMovement->InitialSpeed = 3000.f;
    ProjectileMovement->MaxSpeed = 3000.f;
    ProjectileMovement->bRotationFollowsVelocity = true;
}

void AMyProjectile::OnOverlapBegin(UPrimitiveComponent* OverlappedComponent, AActor* OtherActor,
                                  UPrimitiveComponent* OtherComp, int32 OtherBodyIndex,
                                  bool bFromSweep, const FHitResult& SweepResult)
{
    // 这里获取的SweepResult.Location经常是错误的！
    UE_LOG(LogTemp, Warning, TEXT("Hit at location: %s"), *SweepResult.Location.ToString());
}

2.2 问题表现

当发射物与其他物体碰撞时，OnOverlapBegin事件会被触发，但SweepResult中的Location值经常出现以下问题：

1. 坐标明显偏离实际碰撞点
2. 有时返回的是发射物的初始位置
3. 在高速移动时尤其明显

3. 问题根源分析

3.1 ProjectileMovement组件的工作原理

ProjectileMovement组件通过每帧更新拥有Actor的位置来模拟物理运动。它内部使用了一种优化算法来预测移动轨迹，这会导致：

1. 预测移动（Predictive Movement）：组件会提前计算未来位置，可能导致碰撞检测时实际位置与预测位置不符
2. 子步长模拟（Sub-stepping）：高速移动时使用子步长确保精度，但可能干扰碰撞检测
3. 物理模拟优先级：当存在物理模拟时，某些碰撞信息可能被覆盖

3.2 重叠委托与碰撞检测的差异

虚幻引擎中有两种主要的碰撞检测方式：

ProjectileMovement组件更倾向于使用Hit检测，这解释了为什么Overlap事件获取的信息不准确。

4. 解决方案与最佳实践

4.1 方案一：改用Hit事件替代Overlap

这是最推荐的解决方案。修改代码如下：

cpp复制// 修改构造函数中的绑定
CollisionComponent->OnComponentHit.AddDynamic(this, &AMyProjectile::OnHit);

// 新的Hit事件处理函数
void AMyProjectile::OnHit(UPrimitiveComponent* HitComp, AActor* OtherActor,
                         UPrimitiveComponent* OtherComp, FVector NormalImpulse,
                         const FHitResult& Hit)
{
    // Hit.Location现在会返回精确的碰撞点
    UE_LOG(LogTemp, Warning, TEXT("精确碰撞位置: %s"), *Hit.Location.ToString());
    
    // 可以在这里生成命中特效等
    if(ImpactEffect)
    {
        UGameplayStatics::SpawnEmitterAtLocation(GetWorld(), ImpactEffect, Hit.Location);
    }
}

4.2 方案二：调整碰撞检测参数

如果必须使用Overlap事件，可以尝试以下调整：

cpp复制// 在构造函数中添加
CollisionComponent->SetCollisionEnabled(ECollisionEnabled::QueryAndPhysics);
CollisionComponent->SetCollisionResponseToAllChannels(ECR_Overlap);
CollisionComponent->SetUseCCD(true);  // 启用连续碰撞检测

// 在ProjectileMovement组件设置
ProjectileMovement->bForceSubStepping = true;
ProjectileMovement->SetUpdateComponent(CollisionComponent);

4.3 方案三：自定义Tick处理

对于需要最高精度的情况，可以禁用ProjectileMovement的自动更新，改为手动处理：

cpp复制// 在构造函数中
PrimaryActorTick.bCanEverTick = true;
ProjectileMovement->SetActive(false);

// Tick函数
void AMyProjectile::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
    
    FHitResult Hit;
    FVector MoveDelta = Velocity * DeltaTime;
    
    if(GetWorld()->SweepSingleByChannel(Hit, GetActorLocation(), GetActorLocation() + MoveDelta,
       FQuat::Identity, ECC_WorldStatic, CollisionComponent->GetCollisionShape()))
    {
        // 处理精确碰撞
        OnHit(CollisionComponent, Hit.GetActor(), Hit.GetComponent(),
              FVector::ZeroVector, Hit);
    }
    else
    {
        SetActorLocation(GetActorLocation() + MoveDelta);
    }
}

5. 实际项目中的经验分享

5.1 性能考量

在大型项目中，需要权衡检测精度和性能：

1. 对于大量小威力子弹，使用Overlap+粗略检测即可
2. 对于关键命中判定（如狙击枪），必须使用Hit检测
3. 可以考虑使用对象池管理发射物，避免频繁创建销毁

5.2 常见陷阱与解决方案

问题1：高速物体穿透

• 解决方案：启用CCD（连续碰撞检测）

cpp复制CollisionComponent->SetUseCCD(true);
ProjectileMovement->bForceSubStepping = true;

问题2：碰撞信息延迟

• 解决方案：减少Tick间隔或提高物理子步数

cpp复制// 在项目设置中调整
PhysicsSubSteps.Default = 8;

问题3：网络同步问题

• 解决方案：确保在复制的Actor上正确处理RPC

cpp复制// 在服务器上检测碰撞，然后RPC到客户端
if(HasAuthority())
{
    ProcessHit(Hit);
    ClientPlayImpactEffect(Hit.Location);
}

6. 高级应用：混合检测系统

对于需要同时处理Overlap和Hit的复杂场景，可以实现混合系统：

cpp复制// 在发射物类中添加
UPROPERTY()
TArray<FHitResult> PendingHits;

void AMyProjectile::OnHit(UPrimitiveComponent* HitComp, AActor* OtherActor,
                         UPrimitiveComponent* OtherComp, FVector NormalImpulse,
                         const FHitResult& Hit)
{
    PendingHits.Add(Hit);
}

void AMyProjectile::OnOverlapBegin(...)
{
    for(const FHitResult& Hit : PendingHits)
    {
        if(Hit.GetComponent() == OtherComp)
        {
            // 使用精确的Hit信息处理Overlap
            ProcessCollision(Hit);
            return;
        }
    }
    // 没有找到匹配的Hit，使用Overlap数据
    ProcessCollision(SweepResult);
}

void AMyProjectile::Tick(float DeltaTime)
{
    PendingHits.Empty();
    Super::Tick(DeltaTime);
}

7. 引擎源码分析（进阶）

对于想深入了解问题的开发者，可以研究引擎源码中的相关部分：

1. ProjectileMovementComponent.cpp

   • 重点查看UpdateComponentVelocity()和MoveUpdatedComponent()方法
   • 注意bInterpolateMove和bForceSubStepping的处理逻辑

2. PrimitiveComponent.cpp

   • 研究BeginComponentOverlap()和DispatchBlockingHit()的区别
   • 查看ConvertTraceResults()如何处理碰撞数据

3. PhysScene_Chaos.cpp

   • 物理引擎底层的碰撞检测实现
   • 特别关注CCD（连续碰撞检测）的实现

理解这些底层机制有助于在遇到类似问题时更快定位原因。