游戏客户端架构 / 系统课时
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 视图中绘制检测线。
准备场景:
- 新建空的 3D 场景,创建一个空 GameObject,位置设为
(0, 0, 0),旋转设为(0, 0, 0)。 - 创建默认
Cube,位置设为(0, 0, 4),缩放保持(1, 1, 1),保留其BoxCollider。 - 创建脚本
RaycastProbe.cs,将以下代码完整写入,并挂载到空 GameObject 上。 - 确保射线路径上没有其他碰撞体,且 Cube 不属于
Ignore Raycast层。
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 会显示:
Hit: Cube; distance: 3.5Cube 的中心距离起点为 4 个世界单位,默认立方体在 Z 轴上的半尺寸为 0.5,因此射线首先接触到距离起点 3.5 个单位的前表面。
在 Scene 视图启用 Gizmos 后,可以看到绿色命中线和青色法线。绘制内容持续约 5 秒。将 Cube 移到射线范围外,再重新运行,预期输出变成:
Miss这里使用 Start() 方便观察单次查询。真实玩法中的持续检测通常放在合适的更新流程中,例如瞄准检测可在 Update() 中进行,配合物理运动的查询则需要考虑 FixedUpdate() 与物理世界的更新时机。
在三类游戏检测中落地
视线检测
敌人需要判断玩家是否被墙壁遮挡时,可以从敌人的观察位置向玩家目标位置发射射线。方向由目标位置减去观察位置得到,最大距离设为两者之间的距离。
如果最近命中的是目标碰撞体,说明这条检测线上没有其他被纳入查询的障碍物;如果首先命中墙体,则视线受到阻挡。
落地检测
角色可以从脚底附近向下发射短射线,检测地面碰撞体。命中距离用于判断脚底与地面的间隙,命中法线用于区分平地和斜坡。
不过,单条射线只能代表一个采样位置。角色站在平台边缘时,中心射线可能已经悬空,而碰撞体的一部分仍然受到平台支撑。因此,落地检测有时需要多条射线或球形检测。
瞄准与交互检测
第一人称游戏可以通过 Camera.ScreenPointToRay 将屏幕位置转换为世界空间射线,再查询准星指向的物体。交互系统可以利用 hit.collider 找到目标组件,并根据 hit.distance 限制可交互范围。
瞄准射线适合确定玩家选择的目标,但并不自动代表子弹的实际飞行路径。如果枪口与摄像机不在同一位置,需要另外考虑枪口到目标之间是否存在障碍物。
避免误判的边界
使用 Raycast 时,应重点检查以下情况:
- 起点已经位于碰撞体内部:Unity 的普通 Raycast 不会报告包含射线起点的碰撞体,不能用它可靠判断初始重叠。
- 层过滤不正确:目标处于被排除的层时,即使射线穿过其形状也不会命中。
- Trigger 设置不匹配:
QueryTriggerInteraction.Ignore会排除触发器,Collide才会将其纳入查询。 - 检测线没有厚度:细小障碍或角色边缘可能与射线错开,造成中心检测通过但实际物体无法通过。
- 物理变换尚未同步:通过 Transform 刚刚移动碰撞体后立即查询,需要注意物理世界的同步时机。
Raycast 最适合回答沿某个方向,指定距离内首先碰到了什么。如果需要判断一个有体积的角色能否通过狭窄空间,就不能只依赖一条中心射线,而应使用与物体形状接近的体积扫描。