游戏引擎 / 系统课时

用射线检测可交互目标

用射线检测可交互目标

第三人称角色靠近宝箱时,应只选中面朝方向、距离足够且未被墙体遮挡的物品。本课以角色胸前的交互点发射射线,筛选最近碰撞体并保存当前目标,使进入、离开和目标切换都能被准确识别。

学习目标

  • 区分检测掩码与可交互对象掩码,避免射线穿墙选中物品。
  • 使用 Physics.Raycast、RaycastHit 和 LayerMask 实现三米范围检测。
  • 验证目标进入、遮挡消失、离开及 A/B 切换时的状态变化。

确定检测起点与遮挡规则

使用角色胸前的 InteractionOrigin 作为射线起点,沿其 forward 方向检测 3 m。第三人称相机通常在角色身后,直接以相机位置计算三米距离,容易使角色附近的物品落在检测范围外;胸前起点更适合面向物品的近距离交互。

Physics.Raycast 返回指定图层中最近的碰撞体。因此需要两个掩码:raycastMask 同时包含 Default(墙、门等遮挡物)与 Interactable(物品),interactableMask 仅包含 Interactable。先用第一个掩码决定射线被谁挡住,再用第二个掩码判断命中物是否允许交互。若先排除墙体,射线就可能穿墙选中宝箱。

角色胸前射线的距离限制、墙体遮挡与图层筛选

编写目标检测与切换逻辑

在 Assets/Scripts/InteractionRaycaster.cs 中创建以下完整脚本,挂到角色根节点。CurrentTarget 保存当前命中的物品;只在对象引用变化时输出日志,因此持续看向同一个宝箱不会每帧刷屏。

csharp
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 按顺序显示以下日志(时间戳可能不同):

text
进入: Chest_A
离开: Chest_A
进入: Chest_B
离开: Chest_B

代码使用 QueryTriggerInteraction.Ignore,所以演示物品需使用未勾选 Is Trigger 的碰撞体。日志是目标变化时的输出,不代表按键拾取已经实现。

搭建可复现的测试场景

在 Unity 6 中按以下步骤设置。以角色根节点初始世界坐标 (0, 0, 0)、朝世界 +Z 方向为例。

  1. 打开 Edit > Project Settings > Tags and Layers,添加 Interactable 和 Player 两个 Layer。将角色及其碰撞体子节点设为 Player,避免射线打中自己。
  2. 在角色下创建空物体 InteractionOrigin,设置局部 Position = (0, 1.3, 0.2)、局部 Rotation = (0, 0, 0);它的蓝色 Z 轴应朝角色正前方。
  3. 创建 Cube 并命名 Chest_A,设置世界 Position = (0, 1.3, 2.2),Layer 为 Interactable,保留 Box Collider。再创建 Chest_B,位置 (2.2, 1.3, 0),同样使用 Interactable。
  4. 创建 Wall 立方体,世界位置 (0, 1.3, 1)、Scale = (1.5, 2, 0.2),Layer 保持 Default。先取消物体左上角的激活勾选,测试遮挡时再启用。
  5. 将 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 应再使用挂在根节点的交互组件归一化对象身份,否则射线从一个子碰撞体移到另一个时,可能被误判为目标切换。

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

目录与阅读设置

阅读设置

17

记录一个想法

用射线检测可交互目标

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

登录哪都通