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

速度正常但角色就是不走

速度正常但角色就是不走

角色控制器出现移动异常时,最容易误判的情况是:日志中的速度始终正常,但画面里的角色完全没有移动。本课建立一条从输入采集、状态限制、碰撞检测到最终位移的排查链,并通过 Unity 实例定位真正阻止角色移动的环节。

学习目标

  • 区分输入速度、期望位移和实际位移,避免只凭速度日志判断移动成功。
  • 按执行顺序检查状态机、碰撞、物理组件和最终位置写入。
  • 使用可复现的诊断脚本定位阻断点,并验证修复结果。

为什么速度正常不代表角色移动

角色移动通常不是简单地把速度赋值给对象,而是经过多个处理环节。以 Unity 的 CharacterController 为例,输入首先转换为移动方向,再结合速度和帧时间计算期望位移,随后由碰撞系统决定实际能移动多少。

需要区分三个量:

  • 期望速度:控制器希望角色以多快的速度移动,单位通常为米每秒。
  • 期望位移:本帧准备提交的位移,由速度乘以帧时间得到。
  • 实际位移:经过移动 API 和碰撞处理后,角色真正发生的位置变化。

例如,水平速度为每秒 5 米,一帧耗时 0.02 秒,期望水平位移就是 0.1 米。但如果角色正贴着不可穿透的墙体向墙内移动,实际水平位移可能接近零。

角色移动诊断链路

排查时必须沿着执行链逐段验证,而不是直接调整移动速度。速度参数再大,也无法解决状态禁用、碰撞阻挡或位置被覆盖的问题。

按移动链逐段定位阻断点

先让角色在开阔区域持续向前移动,并保持相同的输入条件。随后按以下顺序检查,找到第一个与预期不符的环节。

  1. 输入采集:确认移动输入不是零,输入系统对应的 Action 已启用,且当前没有被 UI 或输入模式切换屏蔽。
  2. 状态机:检查角色是否处于死亡、眩晕、交互或过场状态,以及这些状态是否禁止执行移动。
  3. 速度计算:验证速度的大小和方向。仅打印 magnitude 不够,还应查看向量的各个分量。
  4. 期望位移:检查是否正确乘以 Time.deltaTime,以及是否意外重复乘帧时间。
  5. 碰撞求解:确认胶囊体没有卡入墙壁、地板或其他碰撞体,检查 CharacterController.Move 返回的碰撞标志。
  6. 最终位置:比较执行移动前后的位置,排除动画 Root Motion、其他脚本或父物体运动造成的覆盖和抵消。

如果输入向量正常,但状态机返回禁止移动,问题出在业务逻辑。如果 Move 已执行,水平位置仍没有变化,则优先检查碰撞阻挡和本帧的实际位移。

用诊断脚本观察真实位移

下面以 Unity 2022.3 LTS 的经典输入系统为例。新建一个具有 CharacterController 组件的角色对象,将以下脚本保存为 MovementDiagnostic.cs 并挂载到该对象。

示例使用方向键或 WASD 输入,不包含跳跃和重力,仅用于隔离水平移动问题。项目的 Active Input Handling 应启用旧版 Input Manager 或 Both。

csharp
using UnityEngine;

[RequireComponent(typeof(CharacterController))]
public class MovementDiagnostic : MonoBehaviour
{
    [SerializeField, Min(0f)] private float moveSpeed = 5f;
    [SerializeField] private bool movementAllowed = true;

    private CharacterController controller;
    private float nextLogTime;

    private void Awake()
    {
        controller = GetComponent<CharacterController>();
    }

    private void Update()
    {
        Vector2 input = new Vector2(
            Input.GetAxisRaw("Horizontal"),
            Input.GetAxisRaw("Vertical")
        );
        input = Vector2.ClampMagnitude(input, 1f);

        // 分开保存期望速度与实际位移,避免把速度计算成功误认为移动成功。
        Vector3 desiredVelocity = new Vector3(input.x, 0f, input.y) * moveSpeed;
        Vector3 requestedDelta = movementAllowed
            ? desiredVelocity * Time.deltaTime
            : Vector3.zero;

        Vector3 before = transform.position;
        CollisionFlags flags = controller.Move(requestedDelta);
        Vector3 actualDelta = transform.position - before;

        // 限制日志频率,避免每帧输出淹没关键诊断信息。
        if (Time.time >= nextLogTime)
        {
            Debug.Log($"input={input}, allowed={movementAllowed}, " +
                      $"desired={desiredVelocity}, requested={requestedDelta}, " +
                      $"actual={actualDelta}, flags={flags}");
            nextLogTime = Time.time + 0.5f;
        }
    }
}

预期结果:在角色前方没有障碍物、组件启用且 movementAllowed 为 true 时,按住 W 键,input.y 应接近 1,desired.z 应接近 5,requested.z 和 actual.z 应为接近的正数。

以下是为便于阅读而简化的示意输出,具体小数取决于帧时间和碰撞环境:

text
input=(0.00, 1.00), allowed=True, desired=(0.00, 0.00, 5.00), requested=(0.00, 0.00, 0.08), actual=(0.00, 0.00, 0.08), flags=None

当 movementAllowed 被改为 false 时,输入和期望速度仍可能正常,但 requested 与 actual 都为零。这说明移动命令被状态条件阻断,并非碰撞系统故障。

当角色持续向正前方的墙壁移动时,requested.z 仍可能大于零,但 actual.z 接近零,flags 可能包含 Sides。这表明当前方向存在侧向碰撞限制,而不是移动速度参数失效。

诊断脚本在没有重力的情况下可能无法让角色始终贴地,实际使用时应让测试场景和角色初始位置保持稳定;不要直接把该脚本当成完整的生产移动控制器。

处理碰撞与位置覆盖

如果期望位移不为零,实际位移却异常,先将角色放到没有障碍物的测试平面上。若此时恢复移动,说明问题与原场景的碰撞配置或几何关系有关。

重点检查 CharacterController 的 Radius、Height、Center、Skin Width、Step Offset 和 Slope Limit,以及墙壁、地面是否存在重叠碰撞体。碰撞体交叠或角色出生位置嵌入几何体,都可能影响运动结果。

如果 Move 调用后实际位移正常,但屏幕里角色仍不动,应考虑其他系统在同一帧重新设置位置。常见来源包括:

  • Animator 的 Root Motion 在动画阶段改变角色位姿。
  • 其他脚本在 LateUpdate 中覆盖 transform.position。
  • 网络同步组件持续应用服务器或远端的旧位置。
  • 摄像机跟随方式使角色在屏幕上保持固定,看起来没有位移。

可在移动调用后和 LateUpdate 中分别采样世界坐标。若两个时间点的位置不同,就应寻找后续写入者,而不是继续修改速度。

同一角色应尽量明确唯一的位移所有者。使用 CharacterController 时,避免其他脚本同时通过刚体速度、动画和 Transform 直接驱动同一根对象。

用最小场景验证修复

修复完成后,不要只在原场景按一次移动键。建立包含平地、墙壁和可通行斜坡的最小测试场景,按相同的控制逻辑进行验证。

  1. 在开阔平地持续输入,检查期望位移与实际位移是否一致。
  2. 面向墙壁移动,确认角色被合理阻挡,且不会穿透碰撞体。
  3. 切换禁止移动状态,确认实际位移为零,恢复状态后能够继续行走。
  4. 启用正常动画与相机跟随逻辑,确认不会覆盖控制器最终位置。
  5. 在帧率发生变化时重复验证,确认移动速度不会明显依赖帧率。

需要特别注意:角色的最终世界位移并不一定与期望位移逐分量相等。沿墙滑动、台阶处理和坡面约束都可能改变实际方向。因此正确的验收标准不是要求二者永远相等,而是要求差异能够由明确的碰撞或状态规则解释。

当日志显示速度正常但角色不动时,最有效的方法是记录完整的 输入、移动许可、期望位移、碰撞标志和实际位移。找到第一个产生异常的环节,通常比反复修改速度更快、更可靠。

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

目录与阅读设置

阅读设置

17

记录一个想法

速度正常但角色就是不走

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

登录哪都通