游戏引擎 / 系统课时

用地面检测修正移动异常

用地面检测修正移动异常

角色出现贴地抖动、走出平台仍被判定接地,或明明有地面却持续下落时,先确认碰撞体,再检查接地探测的位置和过滤条件。本课用一条向下射线建立可观察的接地信号,并按现象逐层定位穿地、悬空与坡面问题。

学习目标

  • 解释碰撞阻挡和接地查询为什么不是同一件事。
  • 用射线距离、地面层与表面法线判断能否站立。
  • 根据可见射线和状态日志定位常见移动异常。

碰撞体正常不等于接地状态准确

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 的项目。

csharp
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 仅在首次检查与接地状态切换时显示以下消息正文):

text
接地=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 的射线或球形投射。处理悬空与穿地时,先把“物理上有没有挡住角色”和“逻辑上有没有识别到地面”分开验证,避免靠增大检测距离掩盖真正问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

用地面检测修正移动异常

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

登录哪都通