游戏客户端架构 / 系统课时
把输入、状态、移动拆成三层
把输入、状态、移动拆成三层
角色控制器经常从几行按键判断开始,却逐渐混入速度计算、跳跃判定、碰撞处理和动画切换。本课将控制链路拆成输入层、运动状态层和移动执行层,让玩家操作、角色规则与引擎能力各司其职,最终建立一套便于测试、扩展和跨引擎迁移的控制器结构。
学习目标
- 理解输入层、运动状态层和执行层各自负责什么。
- 掌握从输入意图到实际移动结果的数据传递方式。
- 使用简化代码实现三层解耦,并识别常见的职责混乱问题。
为什么控制器需要分层
假设玩家按住向右方向键,同时角色处于空中。最初的实现可能直接判断按键并修改坐标,但很快就会遇到三个问题:角色在空中能否改变方向、撞到墙时如何处理、AI 控制的角色能否复用同一套移动规则。
这些问题实际属于不同职责。按键只表达玩家想做什么;空中转向属于运动规则;墙体阻挡则取决于碰撞执行结果。如果全部写在一个输入回调里,修改任意一条规则都可能影响其他行为。
合理的边界是:输入产生意图,运动状态计算目标,执行层处理真实移动。 三层之间通过明确的数据结构传递信息,而不是彼此直接读取和修改内部变量。

输入层只负责描述操作意图
输入层把键盘、手柄或 AI 指令转换成统一的控制意图。例如,二维横向移动可以使用 moveX 表示方向:-1 为向左,0 为不移动,1 为向右。模拟摇杆还可以提供两者之间的数值。
跳跃最好区分持续按住和本次按下。普通跳跃触发通常需要的是一次按下事件,否则角色落地后可能因为按键仍处于按住状态而自动再次起跳。
输入层不应该判断角色是否在地面,也不应该写入物理速度。它只负责采集、归一化和缓存意图,保证键盘操作与 AI 行为能够使用同一个下游接口。
运动状态层负责解释规则
运动状态层接收输入意图,同时参考角色当前速度、接地结果和运动参数,计算期望速度或动作请求。
例如,向右移动并不意味着立即把水平速度设置为最大值。为了让角色逐渐加速,控制器可以根据加速度和时间步长更新水平速度;松开方向键后,再逐渐减速。
跳跃也需要规则判断:只有角色满足接地等条件时,才允许把竖直速度设置为起跳速度。这里的接地信息必须来自执行层的真实检测,而不是根据玩家是否按下方向键进行推测。
为避免歧义,可以区分两类状态:
- 运动状态:水平速度、竖直速度、是否允许跳跃等控制逻辑需要的数据。
- 环境反馈:是否接地、是否撞墙、实际位移等执行层检测得到的结果。
运动状态层可以利用环境反馈更新规则,但不负责亲自查询引擎碰撞接口。
用纯逻辑代码实现职责边界
下面使用 Python 标准库编写一个可运行的最小示例。它只实现水平移动的意图归一化、加减速和执行边界,不依赖 Unity、Unreal 或 Godot。执行层暂时采用无限制空间中的位置积分,因此不包含真实碰撞检测。
from dataclasses import dataclass
@dataclass(frozen=True)
class MoveIntent:
move_x: float
@dataclass
class MotionState:
velocity_x: float = 0.0
def normalize_input(raw_axis: float) -> MoveIntent:
# 输入层只限制输入范围,不处理角色位置
return MoveIntent(max(-1.0, min(1.0, raw_axis)))
def update_motion(
intent: MoveIntent, state: MotionState, dt: float
) -> float:
# 状态层用有限加速度逼近期望速度
max_speed = 5.0
acceleration = 10.0
target = intent.move_x * max_speed
change = max(-acceleration * dt,
min(acceleration * dt, target - state.velocity_x))
state.velocity_x += change
return state.velocity_x
def execute_movement(position_x: float, velocity_x: float, dt: float) -> float:
# 演示用执行层:无障碍场景下积分位置
return position_x + velocity_x * dt
def main() -> None:
state = MotionState()
position_x = 0.0
dt = 0.1
for raw_axis in (1.0, 1.0, 0.0, 0.0):
intent = normalize_input(raw_axis)
velocity_x = update_motion(intent, state, dt)
position_x = execute_movement(position_x, velocity_x, dt)
print(f"velocity={velocity_x:.1f}, position={position_x:.1f}")
if __name__ == "__main__":
main()预期输出:
velocity=1.0, position=0.1
velocity=2.0, position=0.3
velocity=1.0, position=0.4
velocity=0.0, position=0.4前两次更新持续向右加速,后两次因为输入归零而减速。输入值始终只是运动意图,位置改变发生在执行层。示例使用固定的 0.1 秒时间步长;实际游戏中应使用引擎提供的时间步长,并遵守对应物理更新机制。
这个实现也有明确边界:它没有重力、障碍物、斜坡或平台,因此不能直接当作生产级角色控制器。接入真实引擎时,应将 execute_movement 替换为引擎提供的运动与碰撞接口,并把实际接地及碰撞结果反馈给状态层。
让三层适配不同的控制来源
三层拆分最大的收益不是减少代码行数,而是控制变化的影响范围。
玩家输入从键盘换成手柄时,只需修改输入适配器;NPC 从寻路系统得到方向后,也可以生成相同的 MoveIntent。运动状态层不需要知道指令来自谁。
切换 Unity、Godot 或其他引擎时,通常需要重写执行层与引擎的连接方式,但加速度、最大速度以及跳跃规则可以尽量保留为不依赖引擎的纯逻辑。
还要避免反向耦合:输入层不应直接调用引擎的移动方法;状态层不应读取具体按键;执行层不应决定玩家是否允许二段跳。对于滑墙、冲刺和攀爬,可以在运动状态层扩展规则,再由执行层负责落实移动。
真正清晰的控制器应当能够分别回答三个问题:角色想做什么、规则允许怎样运动、引擎实际让角色移动了多少。只要三者没有混为一谈,后续加入碰撞、动画、网络同步或 AI 操控就更容易维护。