游戏客户端架构 / 系统课时
站在地上到底怎么判定
站在地上到底怎么判定
角色脚底看起来贴着地面,不代表物理系统已经确认接地。本课比较射线、球形检测和碰撞法线三种方法,使用 Unity 物理查询建立稳定的 Grounded 状态,并解决台阶边缘误判、墙面误判和跳跃瞬间错误接地的问题。
学习目标
- 理解不同接地检测方式的覆盖范围和局限。
- 使用球形扫描与表面法线实现可运行的接地判断。
- 为边缘离地、跳跃和检测抖动制定明确规则。
为什么脚底接触不等于接地
常见的错误做法是只检查角色下方是否存在碰撞体。角色靠在墙边、接触陡坡或者脚底刚刚越过平台边缘时,这种判断都可能得到错误结果。
可靠的 Grounded 状态至少回答三个问题:脚下是否存在有效表面、表面是否允许站立、当前角色是否正在主动离地。
接地检测通常需要结合以下信息:
- 检测距离:脚底到地面的距离是否处于允许范围。
- 表面法线:碰撞面的朝向是否满足最大可站立坡度。
- 运动状态:跳跃刚触发时是否应该暂时忽略重新接地。
其中表面法线是垂直于碰撞面的单位向量。水平地面的法线接近世界向上方向,墙壁的法线则接近水平方向。
三种接地检测方式如何选择
| 方式 | 优点 | 主要局限 |
|---|---|---|
| 向下射线 Raycast | 成本低,距离直观 | 单点容易漏掉边缘与不平整地形 |
| 向下球形扫描 SphereCast | 覆盖一定面积,可获得距离与法线 | 球体侧面可能命中墙壁,起点重叠需要额外处理 |
| 碰撞接触法线 | 能利用真实碰撞接触判断支撑面 | 依赖碰撞回调及物理步时序,接触也不代表可站立 |
对于胶囊形角色,推荐使用向下球形扫描作为主要检测方式,再根据法线筛选可站立表面。如果控制器已经通过碰撞回调收集接触点,可以将接触信息作为补充,而不是简单地把所有碰撞都算作接地。
下面的示意图展示三种检测方式在平台边缘的差异。中央射线已经落空时,球形扫描仍可能覆盖平台边缘;接触法线则用于判断命中的表面能否提供有效支撑。

用 SphereCast 实现接地检测
下面使用 Unity 3D 的 Rigidbody 与 CapsuleCollider。示例要求胶囊保持竖直,角色缩放为 (1,1,1),脚本与两个组件挂在同一对象上,并在 Inspector 中指定 groundMask。示例只负责判定接地,不负责移动或施加跳跃速度。
创建 GroundDetector.cs:
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 秒的起跳许可。
跳跃输入缓冲则解决玩家在落地前略早按下跳跃键的问题。可以缓存输入时间,在真正落地后判断是否执行跳跃。这属于跳跃规则,不应该通过延长地面检测距离实现,否则会产生悬空接地。
还有两个需要额外处理的边界:球形扫描从重叠碰撞体内部开始时可能无法报告预期命中;高速下落或复杂边缘同时存在多个碰撞面时,单次扫描命中的法线不一定代表最佳支撑面。生产控制器可通过重叠检查、多点扫描或接触点汇总增强鲁棒性。
如何验证接地判断可靠
建立水平平台、斜坡、竖直墙壁以及带边缘的平台,逐项执行检查:
- 站在水平地面,确认接地为真,法线接近向上。
- 缓慢走出平台边缘,确认脚下不再有有效支撑后进入空中状态。
- 靠墙下落,确认墙面碰撞不会让接地状态变为真。
- 在坡度超过阈值的坡面停留,确认它不被识别为可站立地面。
- 触发跳跃并调用
BeginJump(),确认起跳初期不会立即重新接地。
稳定的接地系统应让碰撞查询提供几何证据,让坡度判断确定支撑面是否合法,再由跳跃状态决定当前是否接受接地。三者职责分开,后续加入二段跳、移动平台和贴地控制时才容易维护。