游戏客户端架构 / 系统课时
跳跃为什么要和离地状态联动
跳跃为什么要和离地状态联动
角色跳跃不能只在按键时增加一个向上的速度,还需要知道角色是否接地、何时真正离地,以及什么时候允许再次起跳。本课通过一个可运行的 Unity 示例,将跳跃输入、起跳速度、重力和接地判断组合为明确的状态迁移规则。
学习目标
- 理解接地、上升、下降和落地之间的状态转换。
- 能够利用起跳高度与重力计算初始竖直速度。
- 实现跳跃请求消费、离地检测和落地后重新允许跳跃的规则。
为什么只检查跳跃按键会出问题
假设角色每帧检查一次跳跃键,只要按键被按下就设置一个向上的速度。如果没有结合接地状态,角色可能在空中反复起跳,形成意外的无限跳跃。
另一个常见问题是角色刚执行起跳,却仍被地面检测认定为接地。此时如果控制器立即清零竖直速度,起跳速度就会在同一帧被抵消,表现为按下跳跃键但角色无法离开地面。
因此,跳跃规则至少要区分四个状态:
- Grounded(接地):角色站在有效地面上,可以接受普通跳跃请求。
- Rising(上升):角色已经起跳,竖直速度为正。
- Falling(下降):角色正在向下运动,可能是跳跃后的下落,也可能是直接走出平台。
- Landing(落地过渡):角色从空中重新接触有效地面,准备恢复接地控制。
这些状态不只是动画标签,还承担行为约束。例如,只有接地状态允许普通起跳,空中状态需要持续施加重力,落地后才能重新获得起跳资格。
跳跃状态如何转换
跳跃可以看成由输入事件与物理检测共同驱动的状态机,而不是某一个按键回调独立完成的动作。

典型转换顺序是 Grounded → Rising → Falling → Landing → Grounded。不过并非每次离地都会经过上升阶段:角色直接走出悬崖时,应从 Grounded 直接转换为 Falling。
物理状态也不应完全依赖速度符号判断。例如,角色向上移动时碰到天花板,竖直速度必须被碰撞求解器修正;只有速度值而没有碰撞检测,无法可靠确定当前状态。
本课使用 Landing 表示落地确认发生的一个物理更新阶段。实际项目可以将其合并为一个落地事件,但必须确保着地后的输入资格和速度修正只执行一次。
起跳速度与重力如何配合
对于使用恒定向下重力的简单跳跃模型,起跳高度可以用来反推初始竖直速度。
设起跳时竖直速度为 ,重力加速度大小为 ,希望最高点比起跳点高 。不考虑空气阻力时,最高点竖直速度为零,得到:
例如,希望角色跳起 1.2 米,重力加速度取 20 米每二次方秒,则起跳速度约为 6.93 米每秒。
这个公式只决定起跳瞬间的初始速度。此后每次物理更新都需要根据时间步长施加重力,才能形成上升减速、到达顶点和向下加速的运动过程。
需要特别注意:不能每一帧都根据跳跃高度重新赋予起跳速度,否则角色会持续被推向上方。初始速度只应在一次有效起跳发生时设置。
在 Unity 中实现跳跃状态控制
下面使用 Unity 3D 的 CharacterController 实现最小跳跃控制器。示例采用新版和旧版 Unity 项目都常见的旧输入接口 Input.GetButtonDown,需要在项目的 Active Input Handling 中启用 Input Manager 或 Both,并配置默认的 Jump 输入。
脚本负责水平移动、跳跃、重力和状态变化,碰撞位移通过 CharacterController.Move 完成。脚本挂载对象必须存在 CharacterController 组件。
using UnityEngine;
[RequireComponent(typeof(CharacterController))]
public sealed class JumpStateController : MonoBehaviour
{
private enum JumpState { Grounded, Rising, Falling, Landing }
[SerializeField] private float moveSpeed = 4f;
[SerializeField] private float jumpHeight = 1.2f;
[SerializeField] private float gravity = 20f;
private CharacterController controller;
private JumpState state = JumpState.Falling;
private float verticalSpeed;
private Vector3 horizontalInput;
private bool jumpRequested;
private void Awake()
{
controller = GetComponent<CharacterController>();
}
private void Update()
{
// 在渲染帧采集按键,避免物理更新遗漏短按事件。
horizontalInput = new Vector3(Input.GetAxisRaw("Horizontal"), 0f,
Input.GetAxisRaw("Vertical"));
horizontalInput = Vector3.ClampMagnitude(horizontalInput, 1f);
if (Input.GetButtonDown("Jump")) jumpRequested = true;
}
private void FixedUpdate()
{
float dt = Time.fixedDeltaTime;
bool groundedBeforeMove = controller.isGrounded;
if (state == JumpState.Landing)
state = JumpState.Grounded;
if (groundedBeforeMove && verticalSpeed <= 0f)
{
verticalSpeed = -1f; // 保持轻微向下速度,便于持续接触地面。
if (state != JumpState.Grounded)
state = JumpState.Grounded;
}
else if (!groundedBeforeMove && state == JumpState.Grounded)
{
state = JumpState.Falling;
}
if (jumpRequested && state == JumpState.Grounded)
{
verticalSpeed = Mathf.Sqrt(2f * gravity * jumpHeight);
state = JumpState.Rising;
}
jumpRequested = false; // 每次输入只消费一次,不自动连跳。
verticalSpeed -= gravity * dt;
Vector3 velocity = horizontalInput * moveSpeed;
velocity.y = verticalSpeed;
CollisionFlags flags = controller.Move(velocity * dt);
bool groundHit = (flags & CollisionFlags.Below) != 0;
bool ceilingHit = (flags & CollisionFlags.Above) != 0;
if (ceilingHit && verticalSpeed > 0f)
verticalSpeed = 0f;
if (groundHit && verticalSpeed <= 0f)
{
verticalSpeed = -1f;
if (state == JumpState.Rising || state == JumpState.Falling)
state = JumpState.Landing;
}
else if (verticalSpeed <= 0f && state == JumpState.Rising)
{
state = JumpState.Falling;
}
else if (!groundHit && state == JumpState.Grounded)
{
state = JumpState.Falling;
}
}
}本示例故意保持简单:水平移动使用世界坐标,跳跃输入只在下一次物理更新消费,不实现二段跳、输入缓冲、土狼时间或移动平台速度继承。项目需要更复杂的操作手感时,应在此基础上扩展输入有效期和状态规则。
CharacterController.isGrounded 反映最近一次 Move 的接地情况,不是任意时刻实时更新的独立探测器。因此,示例在移动前读取上一次结果,再通过当前 Move 返回的 CollisionFlags 判断本次是否触地。
另外,CharacterController 不会像动态 Rigidbody 那样自动施加重力,必须由脚本维护竖直速度。不要在同一个角色上同时让多个移动脚本分别调用 Move,否则接地状态和碰撞结果容易相互覆盖。
预期结果:角色接地时按下默认跳跃键,会获得一次向上速度,随后逐渐减速、到达最高点并下落;空中重复按键不会再次起跳;落地后恢复起跳资格。由于代码没有输出调试日志,控制台不会自动显示状态名称,可在 Inspector 或调试器中观察 state 与 verticalSpeed。
离地边界与常见问题
最容易被忽略的是起跳帧、平台边缘和落地帧之间的差异。
| 场景 | 正确行为 |
|---|---|
| 接地时按下跳跃 | 设置初始向上速度并进入上升状态 |
| 上升过程中再次按键 | 普通单次跳跃不增加新速度 |
| 走出平台边缘 | 不执行起跳,直接进入下降状态 |
| 头顶撞到障碍 | 取消剩余向上速度并转向下降 |
| 下落碰到有效地面 | 确认落地并恢复接地控制 |
在斜坡、台阶或崎岖地面上,角色可能因为短暂失去碰撞接触而进入下降状态。这类情形不能依靠不断放宽 isGrounded 判断解决,而应在统一地面检测中区分可行走表面、台阶贴附与真正离地。
实际制作中可以加入两个常见的手感优化:土狼时间允许角色刚离开平台后的极短时间内仍接受跳跃,跳跃输入缓冲允许角色落地前短暂记录按键。但它们都应该是有明确时间窗口的状态规则,而不是无限延长跳跃请求。
验证跳跃状态是否可靠
建立平面、悬崖边缘和低矮天花板三个测试区域,在固定物理时间步长下检查以下行为:
- 平地按一次跳跃键,应只发生一次起跳,不能在空中连续刷新竖直速度。
- 角色从平台直接走下去,应进入下降状态,而不是错误触发上升动画。
- 上升过程中碰到天花板,应立即取消向上速度,随后进入下降阶段。
- 下落接触地面后,应完成落地过渡并允许下一次跳跃。
- 在不同渲染帧率下测试短按跳跃,检查
Update采集输入与FixedUpdate消费输入是否一致。
如果跳跃高度不符合预期,还要检查角色起点是否已经接地、碰撞体是否碰到天花板,以及离散时间积分造成的高度误差。公式给出的是连续运动的理想高度,实际离散模拟结果允许存在小幅偏差。
跳跃控制的核心原则是让输入决定是否发起动作,让竖直速度和重力决定运动趋势,让碰撞检测决定是否真正离地或落地。只有这些信息共同参与状态转换,角色才不会因为按键、接地检测和物理更新之间的时序差异而出现意外行为。