游戏引擎 / 系统课时
用地面检测修正移动异常
用地面检测修正移动异常
角色出现贴地抖动、走出平台仍被判定接地,或明明有地面却持续下落时,先确认碰撞体,再检查接地探测的位置和过滤条件。本课用一条向下射线建立可观察的接地信号,并按现象逐层定位穿地、悬空与坡面问题。
学习目标
- 解释碰撞阻挡和接地查询为什么不是同一件事。
- 用射线距离、地面层与表面法线判断能否站立。
- 根据可见射线和状态日志定位常见移动异常。
碰撞体正常不等于接地状态准确
CharacterController.Move 负责尝试位移并接受 Collider 的阻挡;controller.isGrounded 则报告最近一次 Move 的接地结果。如果在移动前读取它,读到的是上一轮运动后的状态。自定义 Physics.Raycast 是另一套接地查询:它只提供命中信息,不会替代 CharacterController 的碰撞响应。
先核查地面是否有非 Trigger 的 Collider、Player 是否有启用的 CharacterController、双方是否被物理碰撞层矩阵排除。把角色直接用 transform.position 移过去,可能绕开预期的控制器碰撞处理;本例统一调用 Move。
把射线放到正确的位置
单条地面射线从胶囊包围盒中心 controller.bounds.center 向世界负 Y 方向发出。长度取 bounds.extents.y + 0.12f,也就是从胶囊中心穿过近似脚底,再向下留一小段容差。这里假定角色始终保持竖直,0.12 的单位为米,应按角色尺寸调整,不能无限增大。
命中 Collider 后,还要看 RaycastHit.normal 与世界向上方向的夹角。只有坡角不大于 CharacterController.slopeLimit,才把该表面当作可站立地面。LayerMask 只选择地面碰撞体,QueryTriggerInteraction.Ignore 则防止检测到触发区。

射线适合先确定问题发生在哪个位置,但在平台边沿、台阶缝隙或不规则地面上,脚底中心可能恰好悬空。此时单条射线的 false 不一定意味着角色整体已经失去支撑,需要结合碰撞结果或换用有体积的探测方式。
编写可观察的地面检测脚本
创建带 Collider 的地面,将其 Layer 设为单独创建的 Ground;Player 保持在其他 Layer,添加 CharacterController,使胶囊底部靠近地面。将以下完整脚本保存为 GroundRayMover.cs 并挂到 Player,在 Inspector 的 Ground Mask 只勾选 Ground。输入同样依赖启用了旧 Input Manager 或 Both 的项目。
using UnityEngine;
[RequireComponent(typeof(CharacterController))]
public class GroundRayMover : MonoBehaviour
{
[SerializeField] private LayerMask groundMask;
[SerializeField] private float probeExtraDistance = 0.12f;
[SerializeField] private float moveSpeed = 4f;
[SerializeField] private float gravity = -20f;
private CharacterController controller;
private float verticalSpeed;
private bool reported;
private bool previousGrounded;
private void Awake()
{
controller = GetComponent<CharacterController>();
}
private void Update()
{
Vector3 origin = controller.bounds.center;
float distance = controller.bounds.extents.y + probeExtraDistance;
// 先按地面层过滤,再用命中法线排除过陡的坡面
bool hitGround = Physics.Raycast(
origin, Vector3.down, out RaycastHit hit, distance,
groundMask, QueryTriggerInteraction.Ignore);
bool grounded = hitGround &&
Vector3.Angle(hit.normal, Vector3.up) <= controller.slopeLimit;
Debug.DrawRay(origin, Vector3.down * distance,
grounded ? Color.green : Color.red);
// 只在首次检查或接地状态变化时记录,避免刷屏
if (!reported || grounded != previousGrounded)
{
Debug.Log(grounded ? "接地=true" : "接地=false");
reported = true;
previousGrounded = grounded;
}
if (grounded && verticalSpeed < 0f)
verticalSpeed = -2f;
verticalSpeed += gravity * Time.deltaTime;
Vector3 input = new Vector3(
Input.GetAxisRaw("Horizontal"), 0f,
Input.GetAxisRaw("Vertical"));
Vector3 horizontal = Vector3.ClampMagnitude(input, 1f) * moveSpeed;
CollisionFlags flags = controller.Move(
(horizontal + Vector3.up * verticalSpeed) * Time.deltaTime);
if ((flags & CollisionFlags.Below) != 0 && verticalSpeed < 0f)
verticalSpeed = -2f;
}
}预期输出(Console 仅在首次检查与接地状态切换时显示以下消息正文):
接地=true
接地=false
接地=true这三行对应角色从 Ground 平台站立、走出边缘、再落到下方另一个 Ground 平台。运行时打开 Scene 视图的 Gizmos,可见绿色代表射线命中可站立地面,红色代表未命中或坡面过陡。具体切换帧取决于角色位置和场景碰撞体。
按异常现象依次排查
| 现象 | 优先检查 | 修正方式 |
|---|---|---|
| 穿过地板继续下落 | 地面 Collider、Trigger、物理层碰撞矩阵、是否直接改 Transform | 补齐有效碰撞体,并通过 CharacterController.Move 运动 |
脚在地面却一直显示 false |
Ground Mask 是否为空、地面 Layer、射线起点及距离 |
纠正过滤层,观察射线终点,微调容差 |
人已离开平台仍显示 true |
射线过长、下层地面落在检测距离内 | 缩短 probeExtraDistance,只允许足够近的支撑面 |
| 平台边缘或台阶频繁抖动 | 单点射线漏检、胶囊尺寸与台阶高度 | 结合 CollisionFlags.Below,或改用球形探测 |
| 陡坡被当成平地 | 命中法线、slopeLimit、障碍所处 Layer |
保留坡角限制,排除墙面而不是无限放宽阈值 |
如果改用 Physics.CheckSphere,可以扩大脚底覆盖范围,但它只返回是否重叠,不提供命中法线,靠近墙面时也可能误报;需要判断坡度时可选择返回 RaycastHit 的射线或球形投射。处理悬空与穿地时,先把“物理上有没有挡住角色”和“逻辑上有没有识别到地面”分开验证,避免靠增大检测距离掩盖真正问题。