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

站在地上到底怎么判定

站在地上到底怎么判定

角色脚底看起来贴着地面,不代表物理系统已经确认接地。本课比较射线、球形检测和碰撞法线三种方法,使用 Unity 物理查询建立稳定的 Grounded 状态,并解决台阶边缘误判、墙面误判和跳跃瞬间错误接地的问题。

学习目标

  • 理解不同接地检测方式的覆盖范围和局限。
  • 使用球形扫描与表面法线实现可运行的接地判断。
  • 为边缘离地、跳跃和检测抖动制定明确规则。

为什么脚底接触不等于接地

常见的错误做法是只检查角色下方是否存在碰撞体。角色靠在墙边、接触陡坡或者脚底刚刚越过平台边缘时,这种判断都可能得到错误结果。

可靠的 Grounded 状态至少回答三个问题:脚下是否存在有效表面、表面是否允许站立、当前角色是否正在主动离地。

接地检测通常需要结合以下信息:

  • 检测距离:脚底到地面的距离是否处于允许范围。
  • 表面法线:碰撞面的朝向是否满足最大可站立坡度。
  • 运动状态:跳跃刚触发时是否应该暂时忽略重新接地。

其中表面法线是垂直于碰撞面的单位向量。水平地面的法线接近世界向上方向,墙壁的法线则接近水平方向。

三种接地检测方式如何选择

方式 优点 主要局限
向下射线 Raycast 成本低,距离直观 单点容易漏掉边缘与不平整地形
向下球形扫描 SphereCast 覆盖一定面积,可获得距离与法线 球体侧面可能命中墙壁,起点重叠需要额外处理
碰撞接触法线 能利用真实碰撞接触判断支撑面 依赖碰撞回调及物理步时序,接触也不代表可站立

对于胶囊形角色,推荐使用向下球形扫描作为主要检测方式,再根据法线筛选可站立表面。如果控制器已经通过碰撞回调收集接触点,可以将接触信息作为补充,而不是简单地把所有碰撞都算作接地。

下面的示意图展示三种检测方式在平台边缘的差异。中央射线已经落空时,球形扫描仍可能覆盖平台边缘;接触法线则用于判断命中的表面能否提供有效支撑。

射线、球形扫描和碰撞法线在平台边缘的接地检测对比

用 SphereCast 实现接地检测

下面使用 Unity 3D 的 Rigidbody 与 CapsuleCollider。示例要求胶囊保持竖直,角色缩放为 (1,1,1),脚本与两个组件挂在同一对象上,并在 Inspector 中指定 groundMask。示例只负责判定接地,不负责移动或施加跳跃速度。

创建 GroundDetector.cs:

csharp
using UnityEngine;

[RequireComponent(typeof(Rigidbody), typeof(CapsuleCollider))]
public class GroundDetector : MonoBehaviour
{
    [SerializeField] private LayerMask groundMask;
    [SerializeField, Range(0f, 89f)] private float maxSlopeAngle = 50f;
    [SerializeField, Min(0.001f)] private float probeDistance = 0.12f;
    [SerializeField, Min(0.001f)] private float skin = 0.02f;

    public bool IsGrounded { get; private set; }
    public Vector3 GroundNormal { get; private set; } = Vector3.up;

    private CapsuleCollider capsule;
    private Rigidbody body;
    private float ignoreGroundUntil;

    private void Awake()
    {
        capsule = GetComponent<CapsuleCollider>();
        body = GetComponent<Rigidbody>();
        body.freezeRotation = true;
    }

    private void FixedUpdate()
    {
        // 按胶囊底部计算扫描起点,避免从角色中心直接检测。
        Vector3 center = transform.TransformPoint(capsule.center);
        float radius = capsule.radius;
        float halfHeight = Mathf.Max(capsule.height * 0.5f, radius);
        Vector3 origin = center - Vector3.up * (halfHeight - radius - skin);

        // 扫描长度包含初始球心到脚底的间隔及允许的离地余量。
        float distance = radius + skin + probeDistance;
        bool hitGround = Physics.SphereCast(
            origin, radius * 0.9f, Vector3.down,
            out RaycastHit hit, distance, groundMask,
            QueryTriggerInteraction.Ignore);

        bool walkable = hitGround &&
            Vector3.Angle(hit.normal, Vector3.up) <= maxSlopeAngle;
        bool descending = body.linearVelocity.y <= 0.05f;

        IsGrounded = Time.fixedTime >= ignoreGroundUntil &&
            walkable && descending;
        GroundNormal = IsGrounded ? hit.normal : Vector3.up;
    }

    public void BeginJump(float ignoreSeconds = 0.12f)
    {
        // 跳跃起步时短暂禁止重新接地,避免扫描范围造成误判。
        IsGrounded = false;
        ignoreGroundUntil = Time.fixedTime + ignoreSeconds;
    }
}

此示例面向支持 Rigidbody.linearVelocity 的 Unity 6。使用较早版本时,将该属性改为 Rigidbody.velocity。胶囊半径与高度必须保持有效关系,且本示例未覆盖缩放、旋转胶囊、复合碰撞体以及移动平台的全部情形。

skin 用于调整球形扫描起点;扫描半径略小于胶囊半径,降低紧贴侧墙时命中侧面障碍物的概率。即使扫描命中墙壁,后续法线角度检查也会将其排除。

代码读取 Unity 的物理状态,不会自动将角色吸附到地面。BeginJump() 应由跳跃控制逻辑在实际起跳时调用,并与施加向上速度保持一致。

预期结果:在允许坡度的静止地面上,IsGrounded 为 true;离开平台足够远后变为 false;碰到墙壁而脚下无地面时保持 false。这些结果可通过 Inspector 调试或在调用方打印属性验证。

处理边缘抖动与跳跃边界

接地判断并不只是碰撞查询,还涉及状态更新时机。建议将物理检测放在 FixedUpdate,并让跳跃控制逻辑明确区分检测结果与允许起跳的条件。

角色离地、跳跃与重新落地的状态转换图

短暂离地容错通常称为 Coyote Time,即角色刚离开平台后的短时间内仍允许跳跃。它与 IsGrounded 不应混为一谈:物理状态可以已经变成空中,而游戏规则仍保留约 0.1 秒的起跳许可。

跳跃输入缓冲则解决玩家在落地前略早按下跳跃键的问题。可以缓存输入时间,在真正落地后判断是否执行跳跃。这属于跳跃规则,不应该通过延长地面检测距离实现,否则会产生悬空接地。

还有两个需要额外处理的边界:球形扫描从重叠碰撞体内部开始时可能无法报告预期命中;高速下落或复杂边缘同时存在多个碰撞面时,单次扫描命中的法线不一定代表最佳支撑面。生产控制器可通过重叠检查、多点扫描或接触点汇总增强鲁棒性。

如何验证接地判断可靠

建立水平平台、斜坡、竖直墙壁以及带边缘的平台,逐项执行检查:

  1. 站在水平地面,确认接地为真,法线接近向上。
  2. 缓慢走出平台边缘,确认脚下不再有有效支撑后进入空中状态。
  3. 靠墙下落,确认墙面碰撞不会让接地状态变为真。
  4. 在坡度超过阈值的坡面停留,确认它不被识别为可站立地面。
  5. 触发跳跃并调用 BeginJump(),确认起跳初期不会立即重新接地。

稳定的接地系统应让碰撞查询提供几何证据,让坡度判断确定支撑面是否合法,再由跳跃状态决定当前是否接受接地。三者职责分开,后续加入二段跳、移动平台和贴地控制时才容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

站在地上到底怎么判定

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

登录哪都通