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

把输入、状态、移动拆成三层

把输入、状态、移动拆成三层

角色控制器经常从几行按键判断开始,却逐渐混入速度计算、跳跃判定、碰撞处理和动画切换。本课将控制链路拆成输入层、运动状态层和移动执行层,让玩家操作、角色规则与引擎能力各司其职,最终建立一套便于测试、扩展和跨引擎迁移的控制器结构。

学习目标

  • 理解输入层、运动状态层和执行层各自负责什么。
  • 掌握从输入意图到实际移动结果的数据传递方式。
  • 使用简化代码实现三层解耦,并识别常见的职责混乱问题。

为什么控制器需要分层

假设玩家按住向右方向键,同时角色处于空中。最初的实现可能直接判断按键并修改坐标,但很快就会遇到三个问题:角色在空中能否改变方向、撞到墙时如何处理、AI 控制的角色能否复用同一套移动规则。

这些问题实际属于不同职责。按键只表达玩家想做什么;空中转向属于运动规则;墙体阻挡则取决于碰撞执行结果。如果全部写在一个输入回调里,修改任意一条规则都可能影响其他行为。

合理的边界是:输入产生意图,运动状态计算目标,执行层处理真实移动。 三层之间通过明确的数据结构传递信息,而不是彼此直接读取和修改内部变量。

角色控制器三层架构与数据流

输入层只负责描述操作意图

输入层把键盘、手柄或 AI 指令转换成统一的控制意图。例如,二维横向移动可以使用 moveX 表示方向:-1 为向左,0 为不移动,1 为向右。模拟摇杆还可以提供两者之间的数值。

跳跃最好区分持续按住和本次按下。普通跳跃触发通常需要的是一次按下事件,否则角色落地后可能因为按键仍处于按住状态而自动再次起跳。

输入层不应该判断角色是否在地面,也不应该写入物理速度。它只负责采集、归一化和缓存意图,保证键盘操作与 AI 行为能够使用同一个下游接口。

运动状态层负责解释规则

运动状态层接收输入意图,同时参考角色当前速度、接地结果和运动参数,计算期望速度或动作请求。

例如,向右移动并不意味着立即把水平速度设置为最大值。为了让角色逐渐加速,控制器可以根据加速度和时间步长更新水平速度;松开方向键后,再逐渐减速。

跳跃也需要规则判断:只有角色满足接地等条件时,才允许把竖直速度设置为起跳速度。这里的接地信息必须来自执行层的真实检测,而不是根据玩家是否按下方向键进行推测。

为避免歧义,可以区分两类状态:

  • 运动状态:水平速度、竖直速度、是否允许跳跃等控制逻辑需要的数据。
  • 环境反馈:是否接地、是否撞墙、实际位移等执行层检测得到的结果。

运动状态层可以利用环境反馈更新规则,但不负责亲自查询引擎碰撞接口。

用纯逻辑代码实现职责边界

下面使用 Python 标准库编写一个可运行的最小示例。它只实现水平移动的意图归一化、加减速和执行边界,不依赖 Unity、Unreal 或 Godot。执行层暂时采用无限制空间中的位置积分,因此不包含真实碰撞检测。

python
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()

预期输出:

text
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 操控就更容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

把输入、状态、移动拆成三层

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

登录哪都通