游戏客户端架构 / 系统课时

Raycast 能解决哪些检测问题

Raycast 能解决哪些检测问题

当角色需要判断前方有没有墙、脚下是否存在地面,或者准星正对哪个目标时,可以使用 Raycast 主动查询碰撞世界,而不必等待真实碰撞发生。本课将解释射线的关键参数、命中信息与使用边界,并通过 Unity 示例完成一次可验证的检测。

学习目标

  • 理解射线起点、方向、最大距离与命中结果的含义。
  • 能使用 Unity Physics.Raycast 查询并读取碰撞信息。
  • 判断视线、落地和瞄准场景是否适合使用射线检测。

一条射线如何描述空间查询

Raycast 可以理解为从指定位置沿某个方向发出一条没有厚度的检测线,询问物理世界:这条线在限定距离内会不会与碰撞体相交?它是空间查询,不会自动推动物体或产生碰撞响应。

一次基本查询需要明确四项信息:

  • origin:世界坐标中的射线起点,例如摄像机位置或角色脚底附近。
  • direction:射线方向,例如 transform.forward 或 Vector3.down。建议使用单位方向向量。
  • maxDistance:允许检测的最大距离,避免命中过远的对象。
  • layerMask:参与检测的物理层集合,用于排除角色自身、特效等无关对象。

射线从起点出发,沿方向寻找符合过滤条件的碰撞体。Unity 的单次 Physics.Raycast 查询在命中时返回最近的有效交点;没有命中则返回 false。

射线起点、检测方向、最大距离与命中信息的空间关系

注意,Raycast 检测的是物理碰撞体 Collider,而不是屏幕上看得见的所有模型。一个物体即使具有精细的 Visual Mesh,只要没有可参与查询的 Collider,就无法被普通物理射线命中。

命中结果怎样用于判断

Unity 使用 RaycastHit 保存命中信息。其中最常使用的字段包括:

字段 含义 常见用途
collider 被命中的碰撞体 识别交互目标或障碍物
point 世界坐标中的命中位置 放置命中特效、定位落点
normal 命中表面的法线方向 判断表面朝向或坡度
distance 从射线起点到命中点的距离 判断交互范围、离地高度
rigidbody 命中对象关联的刚体,可能为 null 查找可施加力的物理对象

命中位置和命中法线不是同一个概念。point 告诉你碰到了哪里,normal 告诉你该位置的表面朝向哪里。例如,向下射向水平地面时,命中法线通常接近 Vector3.up。

只有在查询返回 true 后,才能把 RaycastHit 当作有效命中信息使用。如果需要沿同一条射线获取多个目标,则应考虑 Physics.RaycastAll 或 Physics.RaycastNonAlloc,并根据需要自行处理多个结果及其顺序。

在 Unity 中验证一次命中

下面使用 Unity 3D 物理 API 完成最小实验。实验在进入 Play Mode 时执行一次查询,打印被命中的物体名称与距离,同时在 Scene 视图中绘制检测线。

准备场景:

  1. 新建空的 3D 场景,创建一个空 GameObject,位置设为 (0, 0, 0),旋转设为 (0, 0, 0)。
  2. 创建默认 Cube,位置设为 (0, 0, 4),缩放保持 (1, 1, 1),保留其 BoxCollider。
  3. 创建脚本 RaycastProbe.cs,将以下代码完整写入,并挂载到空 GameObject 上。
  4. 确保射线路径上没有其他碰撞体,且 Cube 不属于 Ignore Raycast 层。
csharp
using UnityEngine;

public sealed class RaycastProbe : MonoBehaviour
{
    private void Start()
    {
        Ray ray = new Ray(transform.position, transform.forward);
        const float maxDistance = 10f;

        // 过滤 Ignore Raycast 层,同时不检测 Trigger
        if (Physics.Raycast(ray, out RaycastHit hit, maxDistance,
            Physics.DefaultRaycastLayers, QueryTriggerInteraction.Ignore))
        {
            Debug.Log($"Hit: {hit.collider.name}; distance: {hit.distance:F1}");

            // 绘制命中线和表面法线,不施加物理作用力
            Debug.DrawLine(ray.origin, hit.point, Color.green, 5f);
            Debug.DrawRay(hit.point, hit.normal, Color.cyan, 5f);
        }
        else
        {
            Debug.Log("Miss");
            Debug.DrawRay(ray.origin, ray.direction * maxDistance,
                Color.red, 5f);
        }
    }
}

预期输出:按照上述场景配置运行,Console 会显示:

text
Hit: Cube; distance: 3.5

Cube 的中心距离起点为 4 个世界单位,默认立方体在 Z 轴上的半尺寸为 0.5,因此射线首先接触到距离起点 3.5 个单位的前表面。

在 Scene 视图启用 Gizmos 后,可以看到绿色命中线和青色法线。绘制内容持续约 5 秒。将 Cube 移到射线范围外,再重新运行,预期输出变成:

text
Miss

这里使用 Start() 方便观察单次查询。真实玩法中的持续检测通常放在合适的更新流程中,例如瞄准检测可在 Update() 中进行,配合物理运动的查询则需要考虑 FixedUpdate() 与物理世界的更新时机。

在三类游戏检测中落地

视线检测

敌人需要判断玩家是否被墙壁遮挡时,可以从敌人的观察位置向玩家目标位置发射射线。方向由目标位置减去观察位置得到,最大距离设为两者之间的距离。

如果最近命中的是目标碰撞体,说明这条检测线上没有其他被纳入查询的障碍物;如果首先命中墙体,则视线受到阻挡。

落地检测

角色可以从脚底附近向下发射短射线,检测地面碰撞体。命中距离用于判断脚底与地面的间隙,命中法线用于区分平地和斜坡。

不过,单条射线只能代表一个采样位置。角色站在平台边缘时,中心射线可能已经悬空,而碰撞体的一部分仍然受到平台支撑。因此,落地检测有时需要多条射线或球形检测。

瞄准与交互检测

第一人称游戏可以通过 Camera.ScreenPointToRay 将屏幕位置转换为世界空间射线,再查询准星指向的物体。交互系统可以利用 hit.collider 找到目标组件,并根据 hit.distance 限制可交互范围。

瞄准射线适合确定玩家选择的目标,但并不自动代表子弹的实际飞行路径。如果枪口与摄像机不在同一位置,需要另外考虑枪口到目标之间是否存在障碍物。

避免误判的边界

使用 Raycast 时,应重点检查以下情况:

  • 起点已经位于碰撞体内部:Unity 的普通 Raycast 不会报告包含射线起点的碰撞体,不能用它可靠判断初始重叠。
  • 层过滤不正确:目标处于被排除的层时,即使射线穿过其形状也不会命中。
  • Trigger 设置不匹配:QueryTriggerInteraction.Ignore 会排除触发器,Collide 才会将其纳入查询。
  • 检测线没有厚度:细小障碍或角色边缘可能与射线错开,造成中心检测通过但实际物体无法通过。
  • 物理变换尚未同步:通过 Transform 刚刚移动碰撞体后立即查询,需要注意物理世界的同步时机。

Raycast 最适合回答沿某个方向,指定距离内首先碰到了什么。如果需要判断一个有体积的角色能否通过狭窄空间,就不能只依赖一条中心射线,而应使用与物体形状接近的体积扫描。

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

目录与阅读设置

阅读设置

17

记录一个想法

Raycast 能解决哪些检测问题

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

登录哪都通