游戏客户端架构 / 系统课时
命中法线和距离信息怎么用
命中法线和距离信息怎么用
射线命中物体后,仅知道命中了谁还不足以完成贴墙、落地判定或瞄准提示。我们还需要命中点、表面法线和命中距离。本篇使用 Unity 的 RaycastHit 读取这些空间信息,驱动一个可运行的瞄准标记,并解释如何将相同数据用于墙面和地面判断。
学习目标
- 正确理解
RaycastHit.point、normal、distance和collider的含义。 - 使用命中位置和法线完成表面标记对齐与地面、墙面分类。
- 利用距离和对象身份构建可靠的瞄准、贴墙与落地判断。
RaycastHit 包含哪些有效信息
Unity 的 Physics.Raycast 可以沿指定射线检测 Collider。使用带有 out RaycastHit 的重载时,查询成功后会得到最近一次命中的详细数据。
| 属性 | 含义 | 常见用途 |
|---|---|---|
hit.point |
命中表面的世界坐标 | 放置特效、瞄准标记 |
hit.normal |
命中表面的法线方向 | 表面朝向、墙面和坡度判断 |
hit.distance |
射线起点到命中点的距离 | 射程、交互距离限制 |
hit.collider |
实际被命中的 Collider | 目标识别、组件查询 |
hit.transform |
关联刚体或碰撞体的 Transform | 获取目标位置和层级信息 |
hit.rigidbody |
命中 Collider 关联的 Rigidbody,可能为 null | 物理力或冲量操作 |
其中最容易混淆的是 point 与 distance。前者是世界空间中的位置,后者是从本次射线起点到命中位置的长度。它不是对象之间的中心距离,也不是到世界原点的距离。
normal 则描述命中位置处碰撞表面的朝外方向。对于水平地面,法线通常接近世界上方向;对于竖直墙面,法线通常接近水平方向。不同 Collider 类型所提供的法线依据其碰撞几何计算,不一定完全匹配可见模型的渲染法线。

上图中的命中法线与射线方向是两个不同向量:射线方向说明检测从哪里射向哪里,法线说明被击中的表面朝向哪里。不能直接把射线方向当成表面法线使用。
实现跟随表面的瞄准标记
一个典型需求是:从摄像机画面中心发射射线,命中时在物体表面显示标记,让标记随表面旋转;没有命中时隐藏标记。
在 Unity 3D 场景中准备带 Collider 的墙壁和地面,创建一个用于显示命中位置的箭头或简单标记对象。标记对象的本地正 Z 轴应定义为表面朝外方向,并且不要让它自身的 Collider 阻挡射线。
新建 RayHitProbe.cs,将脚本挂到任意启用的游戏对象上,在 Inspector 中指定摄像机 View Camera 和标记对象 Aim Marker。
using UnityEngine;
public class RayHitProbe : MonoBehaviour
{
[SerializeField] private Camera viewCamera;
[SerializeField] private Transform aimMarker;
[SerializeField] private float range = 30f;
[SerializeField] private LayerMask hitLayers = ~0;
private Collider lastCollider;
private void Update()
{
if (viewCamera == null) return;
// 从画面中心生成射线,起点位于摄像机近裁剪平面。
Ray ray = viewCamera.ViewportPointToRay(
new Vector3(0.5f, 0.5f, 0f));
if (!Physics.Raycast(ray, out RaycastHit hit, range,
hitLayers, QueryTriggerInteraction.Ignore))
{
if (aimMarker != null)
aimMarker.gameObject.SetActive(false);
lastCollider = null;
return;
}
// 用命中点定位,用法线决定标记朝向。
if (aimMarker != null)
{
aimMarker.gameObject.SetActive(true);
aimMarker.position = hit.point + hit.normal * 0.02f;
aimMarker.rotation = Quaternion.LookRotation(hit.normal);
}
float upDot = Vector3.Dot(hit.normal, Vector3.up);
string surface = upDot >= 0.7f ? "Ground"
: upDot <= -0.7f ? "Ceiling"
: Mathf.Abs(upDot) <= 0.2f ? "Wall" : "Slope";
// 只在命中的Collider改变时记录日志,避免每帧刷屏。
if (hit.collider != lastCollider)
{
Debug.Log($"{surface}: {hit.collider.name}, distance={hit.distance:F2}");
lastCollider = hit.collider;
}
}
}预期结果:运行场景并移动摄像机视角,当画面中心指向墙面或地面时,标记移动到命中点附近,其本地正 Z 方向与命中法线一致;当视线离开可检测对象时,标记隐藏。
Console 在首次命中某个 Collider 或目标发生变化时记录一次消息。例如命中墙面时,其格式为:
Wall: <COLLIDER_NAME>, distance=<DISTANCE><COLLIDER_NAME> 是场景对象名称,<DISTANCE> 是保留两位小数的实际命中距离,具体值取决于摄像机和碰撞表面的相对位置。
代码中的 0.02f 是沿法线方向施加的微小世界单位偏移,用于减少标记与被命中表面重合产生的深度闪烁。Quaternion.LookRotation(hit.normal) 让标记对象的本地正 Z 方向对齐命中法线;如果模型实际使用其他轴作为正面方向,需要额外调整旋转。
如何判断墙面与可站立地面
法线可以用于区分表面的朝向。Vector3.Dot(hit.normal, Vector3.up) 计算命中法线与世界上方向的点积,其值位于 -1 到 1 之间。
- 接近
1:表面朝上,通常是地面或平台。 - 接近
0:表面接近竖直,通常是墙面。 - 接近
-1:表面朝下,通常是天花板。
示例使用 upDot >= 0.7f 将坡度相对较小的表面归为 Ground,使用绝对值不超过 0.2f 识别接近竖直的 Wall。这些阈值是演示用的分类规则,不是 Unity 对地面或墙面的固定定义。
实际落地检测不能简单地用摄像机前方的命中结果替代。角色应从脚底附近向下发射射线,结合命中距离、角色底部位置、地面法线与允许坡度判断是否可以站立。只判断法线朝上,可能把角色头顶上方或者远处的平台错误识别为当前地面。
贴墙逻辑同样需要结合空间距离。可以从角色朝向的方向检测墙面,使用 hit.normal 确定墙的外侧方向,再根据 hit.distance 判断角色是否足够靠近墙面。需要注意,墙面接触与角色位置修正仍应遵循角色控制器或刚体的移动规则,不能仅靠改变旋转解决穿模问题。
命中对象和距离怎样参与瞄准逻辑
瞄准系统通常需要同时满足位置、距离和对象类型条件。
命中点可以作为弹痕、激光终点或交互提示的放置位置;法线用于决定特效朝向;距离用于限制射程;hit.collider 则用于找到被命中的目标组件,例如生命值组件或交互接口。
如果武器最大有效射程为 30 个世界单位,就可以把射线查询的 maxDistance 设置为对应范围。没有命中并不意味着射线终点不存在,只是查询范围内没有返回符合条件的 Collider。此时瞄准系统可以使用射线起点加方向乘射程,计算一个视觉上的远端位置。
还要注意,Camera.ViewportPointToRay 生成的射线起点位于摄像机近裁剪平面,因此 hit.distance 从该射线起点计算,不应直接理解成从摄像机 Transform 位置计算的距离。对于严格的武器射程限制,应明确以枪口、角色位置还是摄像机射线起点为基准。
Physics.Raycast 的这个重载只返回射线方向上的最近有效命中。如果需要检测穿透多个目标的情况,应考虑 RaycastAll 或其他多命中查询,并根据业务需求处理命中顺序。
常见误判与验证方法
出现命中结果异常时,应优先按以下顺序排查:
- 确认射线起点和方向正确,特别是摄像机视线与实际枪口之间是否存在偏差。
- 检查 Collider 是否启用、LayerMask 是否包含目标、Trigger 过滤规则是否正确。
- 检查最大射程是否足够,以及射线起点是否已经处于某个 Collider 内部;从内部开始的射线查询可能无法检测该 Collider。
- 确认法线来自真实参与物理查询的 Collider,而不是直接假设它与可见网格完全一致。
- 检查表面标记的本地朝向轴和法线偏移,避免标记翻面或与表面重叠。
在 Scene 视图中使用射线调试线段和命中点辅助标记,可以分别验证射线方向、命中位置与表面法线。不要只根据 Console 中打印了目标名称就认定全部空间数据正确。
实现可靠的空间交互时,应把 RaycastHit 看作一组相互配合的数据:point 决定在哪里,normal 决定朝向哪里,distance 决定是否够近,collider 决定作用于谁。只有把这四类信息与具体角色控制或武器规则结合,才能得到稳定的落地、贴墙和瞄准行为。