游戏引擎 / 系统课时

处理跳跃重力和接地判定

处理跳跃重力和接地判定

本课使用 Unity 6 的 CharacterController 实现角色跳跃、重力下落和接地恢复。完成后,角色能够从地面起跳,在空中持续受到重力影响,碰到天花板时停止上升,并在落地后恢复正常移动。最后通过斜坡、墙面和平台边缘测试接地判定是否可靠。

学习目标

  • 根据目标跳跃高度和重力加速度计算初始竖直速度。
  • 使用 CharacterController.isGrounded 和 CollisionFlags 判断起跳、触顶与落地。
  • 验证跳跃高度、下落速度及斜坡接触,定位贴墙和边缘起跳异常。

配置独立测试场景

以下操作适用于 Unity 6,输入部分使用 Input System 1.17。CharacterController 是基于碰撞约束的角色移动组件,不需要 Rigidbody,也不会自动受到重力影响。开发者必须计算竖直位移并主动调用 Move。

先建立能够重复测试的场景:

  1. 打开 Window > Package Manager,在 Unity Registry 中安装 Input System。进入 Edit > Project Settings > Player > Other Settings,确认 Active Input Handling 为 Input System Package (New) 或 Both;如提示重启编辑器,按提示完成。
  2. 使用 GameObject > 3D Object > Plane 创建地面,保持位置 (0, 0, 0),确认存在 Collider。
  3. 创建空对象 Player,位置设为 (0, 0, 0),添加 Character Controller 组件。
  4. 在 Player 下创建 Capsule 子物体作为可视模型,将其局部位置设为 (0, 0.9, 0)、缩放设为 (0.6, 0.9, 0.6),删除子物体自带的 Capsule Collider,避免重复碰撞。
  5. 将 Main Camera 放在能够观察角色全身的位置,例如 (0, 3, -8),旋转设为 (12, 0, 0)。

Player 的 Character Controller 使用以下起始参数:

Inspector 参数 建议值 作用
Height 1.8 胶囊高度,单位为米
Radius 0.3 胶囊半径
Center (0, 0.9, 0) 让胶囊底部接近角色原点
Slope Limit 45 允许正常爬升的最大坡度,单位为度
Step Offset 0.3 可跨越的台阶高度
Skin Width 0.04 给碰撞留出适当容差,减少卡住和抖动
Min Move Distance 0 不忽略微小位移,避免影响接地检测

实现跳跃速度和重力积分

跳跃可以拆成三个连续阶段:起跳时赋予向上的初速度,上升期间每帧受到向下的重力,达到最高点后转为下落。

设目标跳跃高度为 hh,重力加速度大小为 ∣g∣|g|,起跳速度可以由运动学公式计算:

v0=2∣g∣hv_0=\sqrt{2|g|h}

例如设置 jumpHeight = 1.5、gravity = -20,得到初始速度约为 7.75 m/s。理论上角色约经过 0.387 s 到达最高点;若起落高度相同,完整腾空时间约为 0.775 s。实际结果会受到帧离散积分和碰撞修正的影响。

在 Assets/Scripts 中创建 PlayerJumpMotor.cs,挂载到 Player 对象。下面是可以独立运行的完整示例,使用 WASD 在世界 XZ 平面移动,空格键起跳。

csharp
using UnityEngine;
using UnityEngine.InputSystem;

[RequireComponent(typeof(CharacterController))]
public sealed class PlayerJumpMotor : MonoBehaviour
{
    [SerializeField] private float moveSpeed = 4f;
    [SerializeField] private float jumpHeight = 1.5f;
    [SerializeField] private float gravity = -20f;
    [SerializeField] private float maxFallSpeed = 25f;
    [SerializeField] private float groundedSpeed = 2f;

    private CharacterController controller;
    private float verticalSpeed;

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

    private void Update()
    {
        var kb = Keyboard.current;
        Vector2 input = Vector2.zero;
        bool jumpPressed = false;

        if (kb != null)
        {
            input.x = (kb.dKey.isPressed ? 1f : 0f)
                    - (kb.aKey.isPressed ? 1f : 0f);
            input.y = (kb.wKey.isPressed ? 1f : 0f)
                    - (kb.sKey.isPressed ? 1f : 0f);
            jumpPressed = kb.spaceKey.wasPressedThisFrame;
        }

        // 起跳条件使用上一次 Move 更新的接地结果
        bool groundedBeforeMove = controller.isGrounded;

        if (groundedBeforeMove && verticalSpeed < 0f)
            verticalSpeed = -groundedSpeed;

        if (groundedBeforeMove && verticalSpeed <= 0f && jumpPressed)
            verticalSpeed = Mathf.Sqrt(2f * -gravity * jumpHeight);

        // 重力先改变速度,再由速度计算本帧位移
        verticalSpeed = Mathf.Max(
            verticalSpeed + gravity * Time.deltaTime,
            -maxFallSpeed
        );

        Vector3 horizontal = new Vector3(input.x, 0f, input.y).normalized
                           * moveSpeed;
        Vector3 displacement = (horizontal + Vector3.up * verticalSpeed)
                             * Time.deltaTime;

        CollisionFlags collisions = controller.Move(displacement);

        // 顶到天花板停止上升,落地时清除累积的下落速度
        if ((collisions & CollisionFlags.Above) != 0 && verticalSpeed > 0f)
            verticalSpeed = 0f;

        if ((collisions & CollisionFlags.Below) != 0 && verticalSpeed < 0f)
            verticalSpeed = -groundedSpeed;
    }
}

预期结果(Game 视图):点击 Play 并使 Game 视图获得键盘焦点,WASD 控制水平移动;按下空格时角色立即向上运动,随后减速、到达最高点并下落。落地后再次按空格可以重新起跳,在空中重复按键不会直接获得新的跳跃速度。示例不会自动向 Console 打印日志。

代码中的 gravity 必须为负值,jumpHeight 必须大于零。maxFallSpeed = 25 表示竖直速度最低被限制在 -25 m/s,避免长时间下落时速度无限增大。

groundedSpeed = 2 则表示接地时保留 -2 m/s 的轻微向下速度,使下一次移动持续检测地面接触。它不是重力加速度,也不应该直接乘以跳跃高度。

理解接地结果和碰撞标志的时序

CharacterController.isGrounded 表示上一次调用 Move 或 SimpleMove 时是否检测到下方接触,而不是每次读取时立即重新扫描地面。因此代码在本帧移动之前读取该值,用它判断是否允许起跳。

CharacterController.Move 接收的是本帧位移,单位为米,而不是速度;其返回值 CollisionFlags 是位掩码,可以包含多个方向的碰撞。

碰撞标志 含义 当前处理
CollisionFlags.Below 下方发生碰撞 下落时把竖直速度重置为 -2 m/s
CollisionFlags.Above 上方发生碰撞 上升时将竖直速度清零
CollisionFlags.Sides 侧面发生碰撞 不改变起跳资格
CollisionFlags.None 未报告碰撞 继续按照重力积分

不要写成 collisions == CollisionFlags.Below,因为同一次移动可能同时触碰地面和墙面。通过 & 检查特定位,才能正确识别组合碰撞。

同样不要先执行一次水平 Move,再执行一次竖直 Move,然后只读取 isGrounded。这样最终接地结果可能主要反映第二次移动,使坡边、墙角或台阶上的判断变得难以预测。本例将两个方向合并,每帧调用一次 Move。

跳跃阶段与地面墙壁边缘接触判定示意图

测量跳跃高度和下落速度

跳跃参数不能只靠视觉感受判断。可以运行场景,在 Scene 视图观察 Player 的 Transform,并记录起跳时与最高点的 Position.y 差值。由于角色原点位置不变形,这个差值能够近似反映跳跃高度。

对于当前参数,建议执行以下测试:

测试项目 操作与计算 验收结果
跳跃高度 平地按一次空格,记录最高点与起点的 Y 差值 60 FPS 附近通常约 1.4~1.5 m
上升时间 从起跳到最高点计时 接近 0.39 s
腾空时间 在相同高度的地面起跳并落回 接近 0.75~0.8 s
下落速度 从最高点开始自由下落约 0.5 s 竖直速度约为 -10 m/s
速度限制 在足够高的平台下落超过 1.25 s 达到约 -25 m/s 后不继续增大速度大小
落地恢复 落地后立即再次跳跃 新跳跃高度接近第一次,不出现异常累积速度

表中的时间和高度是理想运动公式与当前离散积分实现的参考范围,并非每台设备逐帧相同的固定值。测量时应保持相同帧率条件,并确保没有其他脚本修改 Player 的 Transform。

若跳跃明显过低,先检查 gravity 是否被重复施加、Time.deltaTime 是否被重复乘入位移,以及项目中是否仍有另一个移动脚本调用 Move。如果希望更精确地控制跳跃最高点,可以进一步使用解析位移积分,但不要通过随意增大 jumpHeight 掩盖重复计算问题。

排查斜坡、贴墙与边缘起跳异常

建立三个额外测试物体:一个旋转约 30° 的 Cube 斜坡、一个旋转约 55° 的 Cube 陡坡,以及一个具有垂直侧面的 Cube 平台。确保它们都有启用的 Collider。

斜坡接触

当前 Slope Limit = 45°。角色应该能够正常爬升 30° 斜坡,而无法仅凭水平移动正常爬升 55° 陡坡。测试时观察角色是否频繁抖动、突然离地或在坡边发生异常跳跃。

需要区分两个概念:Slope Limit 限制爬坡能力,isGrounded 只说明最近一次移动报告了下方接触。检测到下方接触,不一定代表接触面符合游戏定义的可行走坡度。

如果要求角色只能从坡度不超过 45° 的表面起跳,应在接地判定之外增加向下的 Physics.SphereCast,读取 RaycastHit.normal,再用 Vector3.Angle(hit.normal, Vector3.up) 检查表面角度。检测距离可以先从 0.08~0.12 m 调试,查询必须排除角色自身并使用正确的地面 LayerMask。这个额外检测属于后续增强,不包含在当前最小示例中。

贴墙异常

让角色在空中向垂直墙面移动,观察是否还能通过不断按空格上升。正确结果是只有侧面碰撞时不能再次起跳,只有 CollisionFlags.Above 才会中止向上的速度。

如果贴墙后出现异常起跳,首先检查是否把 Sides 错当作 Below,再检查是否有多个脚本调用 Move。另外,胶囊半径过大或 Skin Width 过小也可能造成墙角卡顿,可以在当前 Radius = 0.3 基础上使用约 0.04 m 的 Skin Width 对比测试。

平台边缘起跳

从平台边缘向外移动,并在即将离开时按空格。由于起跳条件读取的是上一次 Move 的结果,角色可能在视觉上刚越过边缘的一帧内仍被允许起跳。这是接地状态的时序特性,不应误判为重力失效。

如果游戏明确禁止这种边缘起跳,应结合脚底向下的空间查询,检查当前是否仍有合格的支撑面。如果希望动作游戏操作更宽容,也可以有意加入约 0.1 s 的离地宽限时间,但必须由独立计时逻辑控制,不能依赖 isGrounded 的偶然延迟。

最终验收标准是:平地连续跳跃高度稳定,空中不能无条件二段跳,碰到天花板会停止上升,落地后速度正确重置,斜坡遵守设定的爬坡限制,并且贴墙与平台边缘的起跳行为符合预定规则。通过这些测试后,再把示例的键盘读取部分替换为项目现有的 Move、Jump Input Actions 输入意图,保留统一的竖直速度更新和单次 CharacterController.Move 逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理跳跃重力和接地判定

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

登录哪都通