游戏引擎 / 系统课时

实现射线检测交互

实现射线检测交互

交互键按下后,角色需要把“我正看着什么”转换成稳定、可验证的命中结果。本课从玩家摄像机取得视点,沿视线发出一条碰撞射线,再用命中 Actor 的标记决定是否可交互,并用调试线和日志验证整个链路。

学习目标

  • 能从玩家摄像机计算射线起点、方向和终点。
  • 能用 LineTraceSingleByChannel 获取第一个阻挡命中并读取 FHitResult。
  • 能通过碰撞响应与 Actor 标记区分可交互对象和普通场景物体。

从摄像机确定射线

第三人称角色的 Actor 朝向不一定等于屏幕中央的观察方向,因此交互射线更适合从玩家视点出发。APlayerController::GetPlayerViewPoint 会给出视点位置和旋转;将旋转转换为前向向量后,就能按交互距离得到终点。

计算关系很简单:TraceEnd = ViewLocation + Forward * InteractionDistance。例如距离设为 500.0f 时,射线只检查镜头前方 500 Unreal Units 内的对象,既能限制交互范围,也避免把远处物体误判为当前目标。

摄像机射线交互的空间关系与判定链路

实现一次交互查询

下面是片段示例:把类加入一个启用 C++ 的 UE5 项目,并让现有输入逻辑调用 TryInteract()。示例使用 ECC_Visibility 作为查询通道,并忽略角色自身;命中后只把带有 Interactable Actor Tag 的对象视为可交互目标。

cpp
// InteractTraceCharacter.h
#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "InteractTraceCharacter.generated.h"

UCLASS()
class AInteractTraceCharacter : public ACharacter
{
    GENERATED_BODY()

public:
    UFUNCTION(BlueprintCallable, Category = "Interaction")
    void TryInteract();

    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Interaction",
        meta = (ClampMin = "1.0"))
    float InteractionDistance = 500.0f;
};
cpp
// InteractTraceCharacter.cpp
#include "InteractTraceCharacter.h"

#include "DrawDebugHelpers.h"
#include "Engine/World.h"
#include "GameFramework/PlayerController.h"

void AInteractTraceCharacter::TryInteract()
{
    APlayerController* PlayerController = Cast<APlayerController>(GetController());
    UWorld* World = GetWorld();
    if (!PlayerController || !World)
    {
        return;
    }

    FVector ViewLocation;
    FRotator ViewRotation;
    PlayerController->GetPlayerViewPoint(ViewLocation, ViewRotation);

    const FVector TraceEnd =
        ViewLocation + ViewRotation.Vector() * InteractionDistance;

    FHitResult Hit;
    FCollisionQueryParams QueryParams(TEXT("InteractionTrace"), false, this);
    const bool bHit = World->LineTraceSingleByChannel(
        Hit,
        ViewLocation,
        TraceEnd,
        ECC_Visibility,
        QueryParams
    );

    DrawDebugLine(
        World,
        ViewLocation,
        TraceEnd,
        bHit ? FColor::Green : FColor::Red,
        false,
        1.0f,
        0,
        1.5f
    );

    if (!bHit)
    {
        UE_LOG(LogTemp, Display, TEXT("Interact: no hit"));
        return;
    }

    DrawDebugSphere(
        World,
        Hit.ImpactPoint,
        8.0f,
        12,
        FColor::Yellow,
        false,
        1.0f
    );

    AActor* HitActor = Hit.GetActor();
    if (IsValid(HitActor) && HitActor->ActorHasTag(TEXT("Interactable")))
    {
        UE_LOG(
            LogTemp,
            Display,
            TEXT("Interactable hit: %s"),
            *HitActor->GetName()
        );
        return;
    }

    UE_LOG(
        LogTemp,
        Display,
        TEXT("Hit non-interactable: %s"),
        *GetNameSafe(HitActor)
    );
}

预期结果:给测试 Actor 添加 Interactable Tag,并确保其参与射线命中的碰撞组件对 Visibility 为 Block。角色看向该 Actor 并触发 TryInteract() 后,视口中会短暂出现绿色调试线和黄色命中点,Output Log 中出现:

text
LogTemp: Display: Interactable hit: <ACTOR_NAME>

<ACTOR_NAME> 会随关卡中的实例名称变化。若没有阻挡命中,调试线为红色,并输出 Interact: no hit。

配置碰撞与可交互标记

射线能否“看到”对象由碰撞响应决定,而不是由 Actor Tag 决定。测试对象的 Mesh、Collision 或其他负责阻挡的 Primitive Component 必须对 Visibility 通道返回 Block;如果设为 Ignore,即使对象就在镜头中央,LineTraceSingleByChannel 也不会把它作为阻挡命中返回。

Actor Tag 则解决“命中了,但能不能交互”的业务判断。示例把 Interactable 放在 Actor 的 Tags 中,因此墙壁可以阻挡射线却不会触发交互。项目变大后,更适合把这个判断替换成 Blueprint Interface 或 C++ 接口,让门、拾取物、NPC 各自实现交互行为,而不是在角色类里堆类型分支。

验证命中与常见失效

先把检测距离调短到容易观察的范围,例如 500,再在关卡中放一个带 Interactable Tag 的立方体。正对它触发交互,确认绿色调试线、黄色命中点和日志三者一致;随后移除 Tag,应仍然命中但输出 Hit non-interactable。最后把组件对 Visibility 改为 Ignore,应变成未命中或命中其后的其他阻挡物。

如果射线起点明显偏离屏幕中心,优先检查是否错误使用了角色位置或 Actor Rotation;如果始终没有命中,检查碰撞是否启用以及目标对查询通道的响应;如果总是先命中自己,则确认查询参数确实忽略了当前角色。这样可以把“视点错误、碰撞过滤错误、玩法判断错误”三类问题快速分开。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现射线检测交互

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通