游戏引擎 / 系统课时

用 Raycast 做交互检测

用 Raycast 做交互检测

玩家按下交互键却拾取不到准星中的物体,或脚下明明有地面却被判为空中,通常需要检查射线的起点、方向、过滤范围和命中处理。本课实现可运行的准星拾取,并用另一条向下射线确认接地状态。

学习目标

  • 理解 Physics.Raycast 的射线参数与 RaycastHit 命中信息。
  • 实现对准物体按 E 拾取的交互,并正确处理遮挡。
  • 用向下射线探测地面,排查漏检与误检。

射线检测返回什么

Physics.Raycast 从世界坐标中的起点沿指定方向检测碰撞体;命中时返回 true,并可通过 RaycastHit 取得 collider、point、normal 和 distance。它是空间查询,不会自动推动刚体或触发拾取逻辑,后续动作必须由脚本决定。

准星交互从摄像机视口中心 (0.5, 0.5) 发射射线;接地检测则从角色脚部上方朝 Vector3.down 发射短射线。两条射线的起点和筛选层不同,不能混用检测范围。

准星交互射线与脚部接地射线的空间关系

搭建可验证的场景

  1. 在场景放置 Plane 作为地面,保留 Collider,并新建 Ground Layer 后赋给地面。
  2. 创建带 BoxCollider 的立方体,命名 PickupBox;新建 Interactable Tag 并赋给它。让立方体位于摄像机正前方 3 米内。
  3. 在玩家脚部附近添加空子物体 FootProbe,将其放在地面上方约 0.2 米;确认玩家有主摄像机可引用。
  4. 新建 RaycastInteractor.cs 并挂到玩家对象上,将 View Camera、Foot Probe 赋值,Ground Mask 只选 Ground;Look Mask 应包含目标和可能遮挡它的墙体层,排除玩家自身的层。

示例采用经典 Input.GetKeyDown;如果项目只启用了新 Input System,需要改用对应输入动作,或在 Player Settings 中启用兼容的旧输入处理方式。

编写拾取与接地脚本

csharp
using UnityEngine;

public sealed class RaycastInteractor : MonoBehaviour
{
    [SerializeField] private Camera viewCamera;
    [SerializeField] private Transform footProbe;
    [SerializeField] private LayerMask lookMask = ~0;
    [SerializeField] private LayerMask groundMask;
    [SerializeField] private float reach = 3f;
    [SerializeField] private float groundRange = 0.35f;

    private bool wasGrounded;

    private void Update()
    {
        if (viewCamera == null) return;

        // 视口中心不依赖屏幕分辨率,射线首先命中最近的有效碰撞体。
        Ray ray = viewCamera.ViewportPointToRay(new Vector3(0.5f, 0.5f, 0f));
        bool hasHit = Physics.Raycast(
            ray, out RaycastHit hit, reach, lookMask,
            QueryTriggerInteraction.Ignore);

        Debug.DrawRay(ray.origin,
            ray.direction * (hasHit ? hit.distance : reach),
            hasHit ? Color.green : Color.red);

        if (!hasHit || !Input.GetKeyDown(KeyCode.E)) return;
        if (!hit.collider.CompareTag("Interactable")) return;

        GameObject target = hit.collider.gameObject;
        Debug.Log("拾取成功:" + target.name);
        target.SetActive(false);
    }

    private void FixedUpdate()
    {
        if (footProbe == null) return;

        // 地面只在 Ground Layer 查询,避免命中角色自身。
        bool grounded = Physics.Raycast(
            footProbe.position, Vector3.down, groundRange,
            groundMask, QueryTriggerInteraction.Ignore);
        Debug.DrawRay(footProbe.position, Vector3.down * groundRange,
            grounded ? Color.green : Color.yellow);

        if (grounded != wasGrounded)
            Debug.Log("接地状态:" + grounded);
        wasGrounded = grounded;
    }
}

预期输出:玩家站在地面上,准星对准 PickupBox 并按 E 后,Console 依次可见:

text
接地状态:True
拾取成功:PickupBox

PickupBox 随即消失;在 Scene 视图开启 Gizmos 后能看到射线颜色。接地日志只在状态发生变化时打印,不会每个物理步刷屏。

遇到不命中时怎么排查

  • 射线看得见却拾取不了:检查最近命中物是否为墙体;不要只勾选交互物层而排除遮挡墙,否则可能隔墙拾取。
  • 目标始终漏检:确认物体有启用的 Collider、距离不超过 reach、Look Mask 包含其 Layer;本例忽略 Is Trigger 碰撞体。
  • 脚下地面漏检:核对 FootProbe 是否高于地面且在 groundRange 范围内,并检查 Ground Mask。
  • 射线从物体内部发出:3D Raycast 通常不会报告包住射线起点的碰撞体,应移出起点或调整探针位置。

可以在摄像机与 PickupBox 之间放置有 Collider 的墙体,再按 E 验证无法穿墙拾取。交互查询放在 Update 响应按键,依赖物理状态的接地探针则在 FixedUpdate 中采样,两种用途各自保持清晰。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Raycast 做交互检测

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

登录哪都通