【虚幻引擎UE】UE4/UE5 基于2D屏幕坐标获取场景3D坐标 射线检测（蓝图/C++）

一、射线检测

1）定义

射线检测（Ray Casting） 是一种计算机图形和计算机图形学中的基本技术，用于检测光线或射线是否与三维场景中的物体相交，以确定相交点的位置和其他相关信息。射线检测通常用于实现各种交互功能、渲染效果和物理模拟，包括但不限于鼠标拾取、光线追踪、碰撞检测和物体拾取等。

1）射线与3D场景中的物体交互的流程

2）射线检测蓝图函数

3）蓝图实现根据鼠标点击位置获取场景中的坐标值

4）根据相机中心点获取场景中的坐标值

需要获取到pawn里的相机。

5）射线检测相关C++函数

（仅列举linetrace系列其他大同小异）

1. LineTraceSingleByChannel：
   • 用于检测一条射线与第一个相交物体的碰撞。
   • 返回一个FHitResult结构，其中包含有关碰撞的信息，如碰撞点、碰撞法线和碰撞物体的引用。

bool UWorld::LineTraceSingleByChannel(FHitResult& OutHit, const FVector Start, const FVector End, ECollisionChannel TraceChannel, const FCollisionQueryParams& Params)

2. LineTraceMultiByChannel：
   • 用于检测一条射线与多个相交物体的碰撞。
   • 返回一个TArray<FHitResult>，其中包含所有相交物体的碰撞信息。

int32 UWorld::LineTraceMultiByChannel(TArray<FHitResult>& OutHits, const FVector Start, const FVector End, ECollisionChannel TraceChannel, const FCollisionQueryParams& Params)

3. LineTraceSingleByObjectType：
   • 类似于LineTraceSingleByChannel，但是使用物体类型（EObjectTypeQuery）而不是碰撞通道进行检测。

bool UWorld::LineTraceSingleByObjectType(FHitResult& OutHit, const FVector Start, const FVector End, FObjectQueryParams ObjectQueryParams, const FCollisionQueryParams& Params)

4. LineTraceMultiByObjectType：
   • 类似于LineTraceMultiByChannel，但是使用物体类型（EObjectTypeQuery）而不是碰撞通道进行检测。

int32 UWorld::LineTraceMultiByObjectType(TArray<FHitResult>& OutHits, const FVector Start, const FVector End, FObjectQueryParams ObjectQueryParams, const FCollisionQueryParams& Params)

6）C++实现手动创建射线检测

FVector StartLocation;  // 射线的起点坐标
FVector ForwardVector;  // 射线的方向向量
FHitResult HitResult;  // 用于存储碰撞信息的变量

// 设置射线的起点坐标
StartLocation = PlayerCameraComponent->GetComponentLocation();  // PlayerCameraComponent是摄像机组件

// 设置射线的方向向量
ForwardVector = PlayerCameraComponent->GetForwardVector();  // 获取摄像机的前向向量

// 建立射线
FVector EndLocation = ((ForwardVector * RayLength) + StartLocation);  // 计算射线的终点坐标

// 进行射线检测
if (GetWorld()->LineTraceSingleByChannel(HitResult, StartLocation, EndLocation, ECC_Visibility))
{
    // 射线与物体相交，可以在HitResult中获取碰撞信息
    AActor* HitActor = HitResult.GetActor();
    FVector ImpactPoint = HitResult.ImpactPoint;
    // 进一步处理交互逻辑
}

PlayerCameraComponent：摄像机组件
LineTraceSingleByChannel：射线检测函数
HitResult：碰撞的物体和碰撞点
RayLength：射线的长度；
ECC_Visibility：射线检测所使用的碰撞通道

7）C++实现点击获取场景中的坐标值

void AYourPlayerController::GetSceneLocationFromMouse()
{
    // 获取玩家控制器
    APlayerController* PlayerController = this;

    if (PlayerController)
    {
        // 获取鼠标点击位置
        FVector MouseLocation, MouseDirection;
        PlayerController->DeprojectMousePositionToWorld(MouseLocation, MouseDirection);

        // 创建射线，用于射线检测
        FHitResult HitResult;
        FCollisionQueryParams CollisionParams;

        // 执行射线检测
        if (GetWorld()->LineTraceSingleByChannel(HitResult, MouseLocation, MouseLocation + MouseDirection * YourRayLength, ECC_Visibility, CollisionParams))
        {
            // 获取射线与场景相交的位置
            FVector SceneLocation = HitResult.Location;

            // 打印结果
            UE_LOG(LogTemp, Warning, TEXT("Scene Location: %s"), *SceneLocation.ToString());
        }
    }
}

二、非射线检测的情况

1）根据相机当前位置获取中心点的世界坐标

void AYourPlayerController::GetCameraCenterLocation()
{
    // 获取玩家控制器的视图控制器
    APlayerController* PlayerController = this;

    if (PlayerController)
    {
        // 获取相机组件
        UCameraComponent* CameraComponent = PlayerController->PlayerCameraManager->GetCameraComponent();

        if (CameraComponent)
        {
            // 获取相机位置
            FVector CameraLocation = CameraComponent->GetComponentLocation();

            // 获取相机旋转
            FRotator CameraRotation = CameraComponent->GetComponentRotation();

            // 计算相机中心点的位置（通常位于相机位置的前方，视角方向）
            FVector CameraForwardVector = CameraRotation.Vector();
            FVector CameraCenterLocation = CameraLocation + CameraForwardVector * YourDistance;  // 替换 YourDistance 为相机中心点到相机位置的距离

            // 将相机中心点的位置转换为场景中的坐标
            FVector WorldLocation = CameraCenterLocation;

            // 打印结果
            UE_LOG(LogTemp, Warning, TEXT("Camera Center Location: %s"), *WorldLocation.ToString());
        }
    }
}