游戏引擎 / 系统课时
实现射线检测交互
实现射线检测交互
交互键按下后,角色需要把“我正看着什么”转换成稳定、可验证的命中结果。本课从玩家摄像机取得视点,沿视线发出一条碰撞射线,再用命中 Actor 的标记决定是否可交互,并用调试线和日志验证整个链路。
学习目标
- 能从玩家摄像机计算射线起点、方向和终点。
- 能用
LineTraceSingleByChannel获取第一个阻挡命中并读取FHitResult。 - 能通过碰撞响应与 Actor 标记区分可交互对象和普通场景物体。
从摄像机确定射线
第三人称角色的 Actor 朝向不一定等于屏幕中央的观察方向,因此交互射线更适合从玩家视点出发。APlayerController::GetPlayerViewPoint 会给出视点位置和旋转;将旋转转换为前向向量后,就能按交互距离得到终点。
计算关系很简单:TraceEnd = ViewLocation + Forward * InteractionDistance。例如距离设为 500.0f 时,射线只检查镜头前方 500 Unreal Units 内的对象,既能限制交互范围,也避免把远处物体误判为当前目标。

实现一次交互查询
下面是片段示例:把类加入一个启用 C++ 的 UE5 项目,并让现有输入逻辑调用 TryInteract()。示例使用 ECC_Visibility 作为查询通道,并忽略角色自身;命中后只把带有 Interactable Actor Tag 的对象视为可交互目标。
// 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;
};// 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 中出现:
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;如果始终没有命中,检查碰撞是否启用以及目标对查询通道的响应;如果总是先命中自己,则确认查询参数确实忽略了当前角色。这样可以把“视点错误、碰撞过滤错误、玩法判断错误”三类问题快速分开。