游戏客户端架构 / 系统课时
输入数据怎么进入 World
输入数据怎么进入 World
本课把键盘、手柄等设备输入转换为 World 中可查询的 MoveIntent,让移动系统不再调用具体引擎的输入 API。完成后,你将建立“采样—映射—写组件—固定步消费”的边界,并验证快速按下跳跃键不会在物理更新前丢失。
学习目标
- 区分设备输入、玩家意图和 ECS 消费者的职责。
- 实现方向归一化与跳跃边沿保留的输入适配器。
- 验证多次渲染帧采样与固定步更新之间的数据交接。
输入层只负责翻译,不负责移动
引擎输入层可能提供键码、手柄摇杆、触摸滑动或动作事件。游戏系统真正需要的却是“向哪个方向移动”“这一段时间是否请求跳跃”,而不是某个设备是否按下了 W 键。适配器负责把设备差异转换为统一语义,写入玩家实体的 MoveIntent 组件。
建议把移动方向表示为二维轴,把跳跃表示为一次性请求。输入采样在引擎的逐帧更新中进行;移动系统在固定步里读取组件,再根据角色配置计算速度或提交物理命令。网络输入、AI 意图和录制回放也可以写入相同类型,但必须明确每个实体的写入者,避免同一帧互相覆盖。

用一个可运行示例连接两种更新频率
以下 Python 3.10+ 示例用简化的 World 字典模拟组件存储,不依赖任何引擎。RawInput.jump_pressed 表示本次采样检测到的“按下边沿”,不是按键持续按住的状态。适配器在两次采样间合并待处理请求,固定步只消费一次。
from dataclasses import dataclass, replace
from math import hypot
@dataclass(frozen=True)
class RawInput:
horizontal: float
vertical: float
jump_pressed: bool
@dataclass(frozen=True)
class MoveIntent:
x: float
z: float
jump_requested: bool
class World:
def __init__(self) -> None:
self.intents: dict[int, MoveIntent] = {}
def write_input(self, entity_id: int, x: float, z: float, pressed: bool) -> None:
# 多次采样时保留尚未被固定步消费的跳跃边沿
old = self.intents.get(entity_id)
pending = pressed or (old.jump_requested if old else False)
self.intents[entity_id] = MoveIntent(x, z, pending)
def take_for_fixed_step(self, entity_id: int) -> MoveIntent:
intent = self.intents[entity_id]
# 方向是持续状态,跳跃请求则一次性消费
self.intents[entity_id] = replace(intent, jump_requested=False)
return intent
def capture(raw: RawInput, world: World, entity_id: int) -> None:
x, z = raw.horizontal, raw.vertical
length = hypot(x, z)
# 对角方向长度不能超过 1,否则速度会偏快
if length > 1.0:
x, z = x / length, z / length
world.write_input(entity_id, x, z, raw.jump_pressed)
def fixed_step(world: World, entity_id: int) -> None:
intent = world.take_for_fixed_step(entity_id)
print(f"move=({intent.x:.3f},{intent.z:.3f}) jump={intent.jump_requested}")
if __name__ == "__main__":
world = World()
capture(RawInput(1, 1, True), world, 7)
capture(RawInput(1, 1, False), world, 7)
fixed_step(world, 7)
fixed_step(world, 7)预期输出:
move=(0.707,0.707) jump=True
move=(0.707,0.707) jump=False同一固定步前即使第二次采样没有新的跳跃边沿,旧请求仍在;首次消费后,下一固定步不会再次跳跃。方向保留则符合持续移动的语义。此示例只演示输入交接,不包含角色落地检测,因此真实跳跃是否执行还要由运动系统判断。
接入引擎时设置清晰边界
采样端读取输入动作,不应把键盘键码存进组件;摇杆还需在适配器中设置死区,方向需要按游戏约定转换到局部或世界空间。UI 菜单优先消费输入时,应屏蔽对应玩法动作。失去窗口焦点、设备断开或控制权切换时,及时写入零方向,避免保留上一次移动值。
MoveIntent 是 ECS 的交接数据,而不是永久事件日志。针对“按下”“释放”这类瞬时动作,可以采用一次性位、命令队列或带序号的事件;若要求同一固定步保留多次独立按下,布尔位不够,需要排队。实际引擎若在其他线程回调输入,先进入线程安全缓冲区,再由 World 的指定更新阶段统一提交。
检查是否真的解耦
验证时先同时给出横向和纵向输入,确认长度不会超过 1;再在一个固定步前采样一次跳跃和一次无跳跃,确认只触发一次;最后暂停或断开设备,确认方向归零。移动系统的代码应只认识 MoveIntent 和实体,不出现引擎键码或输入设备对象。满足这些条件后,换手柄、回放或网络控制时就只需更换输入来源,无须重写移动逻辑。