游戏引擎 / 系统课时
用射线检测可交互目标
用射线检测可交互目标
第三人称角色靠近宝箱时,应只选中面朝方向、距离足够且未被墙体遮挡的物品。本课以角色胸前的交互点发射射线,筛选最近碰撞体并保存当前目标,使进入、离开和目标切换都能被准确识别。
学习目标
- 区分检测掩码与可交互对象掩码,避免射线穿墙选中物品。
- 使用
Physics.Raycast、RaycastHit和LayerMask实现三米范围检测。 - 验证目标进入、遮挡消失、离开及 A/B 切换时的状态变化。
确定检测起点与遮挡规则
使用角色胸前的 InteractionOrigin 作为射线起点,沿其 forward 方向检测 3 m。第三人称相机通常在角色身后,直接以相机位置计算三米距离,容易使角色附近的物品落在检测范围外;胸前起点更适合面向物品的近距离交互。
Physics.Raycast 返回指定图层中最近的碰撞体。因此需要两个掩码:raycastMask 同时包含 Default(墙、门等遮挡物)与 Interactable(物品),interactableMask 仅包含 Interactable。先用第一个掩码决定射线被谁挡住,再用第二个掩码判断命中物是否允许交互。若先排除墙体,射线就可能穿墙选中宝箱。

编写目标检测与切换逻辑
在 Assets/Scripts/InteractionRaycaster.cs 中创建以下完整脚本,挂到角色根节点。CurrentTarget 保存当前命中的物品;只在对象引用变化时输出日志,因此持续看向同一个宝箱不会每帧刷屏。
using UnityEngine;
public sealed class InteractionRaycaster : MonoBehaviour
{
[SerializeField] private Transform rayOrigin;
[SerializeField, Min(0.1f)] private float maxDistance = 3f;
[SerializeField] private LayerMask raycastMask;
[SerializeField] private LayerMask interactableMask;
private GameObject currentTarget;
public GameObject CurrentTarget => currentTarget;
private void Update()
{
GameObject nextTarget = null;
if (rayOrigin != null)
{
// 从角色交互点发射,检测掩码必须包含墙体。
Ray ray = new Ray(rayOrigin.position, rayOrigin.forward);
Debug.DrawRay(ray.origin, ray.direction * maxDistance, Color.cyan);
if (Physics.Raycast(ray, out RaycastHit hit, maxDistance,
raycastMask, QueryTriggerInteraction.Ignore))
{
// 只把最近命中且属于交互层的物体当作目标。
int layerBit = 1 << hit.collider.gameObject.layer;
if ((interactableMask.value & layerBit) != 0)
nextTarget = hit.collider.gameObject;
}
}
// 避免同一目标每帧重复触发进入事件。
if (nextTarget == currentTarget) return;
if (currentTarget != null) Debug.Log($"离开: {currentTarget.name}");
currentTarget = nextTarget;
if (currentTarget != null) Debug.Log($"进入: {currentTarget.name}");
}
}预期结果:完成下方场景配置后,依次对准 Chest_A、开启遮挡墙、转向 Chest_B、移出范围,Console 按顺序显示以下日志(时间戳可能不同):
进入: Chest_A
离开: Chest_A
进入: Chest_B
离开: Chest_B代码使用 QueryTriggerInteraction.Ignore,所以演示物品需使用未勾选 Is Trigger 的碰撞体。日志是目标变化时的输出,不代表按键拾取已经实现。
搭建可复现的测试场景
在 Unity 6 中按以下步骤设置。以角色根节点初始世界坐标 (0, 0, 0)、朝世界 +Z 方向为例。
- 打开
Edit > Project Settings > Tags and Layers,添加Interactable和Player两个 Layer。将角色及其碰撞体子节点设为Player,避免射线打中自己。 - 在角色下创建空物体
InteractionOrigin,设置局部Position = (0, 1.3, 0.2)、局部Rotation = (0, 0, 0);它的蓝色 Z 轴应朝角色正前方。 - 创建
Cube并命名Chest_A,设置世界Position = (0, 1.3, 2.2),Layer 为Interactable,保留Box Collider。再创建Chest_B,位置(2.2, 1.3, 0),同样使用Interactable。 - 创建
Wall立方体,世界位置(0, 1.3, 1)、Scale = (1.5, 2, 0.2),Layer 保持Default。先取消物体左上角的激活勾选,测试遮挡时再启用。 - 将
InteractionRaycaster挂到角色,拖入InteractionOrigin。Inspector 中设Max Distance = 3、Raycast Mask = Default + Interactable、Interactable Mask = Interactable。
运行后在 Scene 窗口开启 Gizmos,可见胸前延伸出的青色调试射线。它表示检测方向及最大长度,并不表示一定命中了物体。
验收目标进入、离开与切换
| 操作 | 预期 Console 行为 |
|---|---|
初始朝 +Z 面向 Chest_A |
输出一次 进入: Chest_A,保持朝向不再重复 |
启用 Wall 遮挡 A |
输出一次 离开: Chest_A,墙体不是交互目标 |
禁用墙体并转向 +X 面向 B |
输出 进入: Chest_B |
| 移动到 B 的碰撞体距交互点超过 3 m | 输出 离开: Chest_B |
| 无墙时由 A 直接转向 B | 依次输出 离开: Chest_A、进入: Chest_B |
切换操作可以先对准 A,再旋转角色根节点到 B;旋转过程中若短暂指向空处,可能先收到 A 的离开,再收到 B 的进入,这是正确行为。后续 UI 可以读取 CurrentTarget 决定是否显示“按键交互”提示。
定位漏检与穿墙误选
出现漏检时,先检查 InteractionOrigin 的蓝色 Z 轴是否指向目标,再核对目标是否具有非 Trigger 的 Collider,以及 Raycast Mask 是否包含该碰撞体实际所在的 Layer。射线起点若已处于某个碰撞体内部,也不能依赖 Raycast 从内部命中它,应调整检测点位置。
如果隔着墙仍选中宝箱,常见原因是 Raycast Mask 只包含 Interactable,把 Default 墙体过滤掉了。修正后重新执行遮挡验收;不要仅靠交互物品 Layer 过滤来判断可见性。
本示例把命中碰撞体所在的 GameObject 视为一个交互对象,适合每个宝箱只有一个主碰撞体的场景。多子碰撞体 Prefab 应再使用挂在根节点的交互组件归一化对象身份,否则射线从一个子碰撞体移到另一个时,可能被误判为目标切换。