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

命中法线和距离信息怎么用

命中法线和距离信息怎么用

射线命中物体后,仅知道命中了谁还不足以完成贴墙、落地判定或瞄准提示。我们还需要命中点、表面法线和命中距离。本篇使用 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。

csharp
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 或目标发生变化时记录一次消息。例如命中墙面时,其格式为:

text
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 或其他多命中查询,并根据业务需求处理命中顺序。

常见误判与验证方法

出现命中结果异常时,应优先按以下顺序排查:

  1. 确认射线起点和方向正确,特别是摄像机视线与实际枪口之间是否存在偏差。
  2. 检查 Collider 是否启用、LayerMask 是否包含目标、Trigger 过滤规则是否正确。
  3. 检查最大射程是否足够,以及射线起点是否已经处于某个 Collider 内部;从内部开始的射线查询可能无法检测该 Collider。
  4. 确认法线来自真实参与物理查询的 Collider,而不是直接假设它与可见网格完全一致。
  5. 检查表面标记的本地朝向轴和法线偏移,避免标记翻面或与表面重叠。

在 Scene 视图中使用射线调试线段和命中点辅助标记,可以分别验证射线方向、命中位置与表面法线。不要只根据 Console 中打印了目标名称就认定全部空间数据正确。

实现可靠的空间交互时,应把 RaycastHit 看作一组相互配合的数据:point 决定在哪里,normal 决定朝向哪里,distance 决定是否够近,collider 决定作用于谁。只有把这四类信息与具体角色控制或武器规则结合,才能得到稳定的落地、贴墙和瞄准行为。

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

目录与阅读设置

阅读设置

17

记录一个想法

命中法线和距离信息怎么用

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

登录哪都通