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

输入数据怎么进入 World

输入数据怎么进入 World

本课把键盘、手柄等设备输入转换为 World 中可查询的 MoveIntent,让移动系统不再调用具体引擎的输入 API。完成后,你将建立“采样—映射—写组件—固定步消费”的边界,并验证快速按下跳跃键不会在物理更新前丢失。

学习目标

  • 区分设备输入、玩家意图和 ECS 消费者的职责。
  • 实现方向归一化与跳跃边沿保留的输入适配器。
  • 验证多次渲染帧采样与固定步更新之间的数据交接。

输入层只负责翻译,不负责移动

引擎输入层可能提供键码、手柄摇杆、触摸滑动或动作事件。游戏系统真正需要的却是“向哪个方向移动”“这一段时间是否请求跳跃”,而不是某个设备是否按下了 W 键。适配器负责把设备差异转换为统一语义,写入玩家实体的 MoveIntent 组件。

建议把移动方向表示为二维轴,把跳跃表示为一次性请求。输入采样在引擎的逐帧更新中进行;移动系统在固定步里读取组件,再根据角色配置计算速度或提交物理命令。网络输入、AI 意图和录制回放也可以写入相同类型,但必须明确每个实体的写入者,避免同一帧互相覆盖。

输入采样到 ECS 固定步消费的数据流

用一个可运行示例连接两种更新频率

以下 Python 3.10+ 示例用简化的 World 字典模拟组件存储,不依赖任何引擎。RawInput.jump_pressed 表示本次采样检测到的“按下边沿”,不是按键持续按住的状态。适配器在两次采样间合并待处理请求,固定步只消费一次。

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

预期输出:

text
move=(0.707,0.707) jump=True
move=(0.707,0.707) jump=False

同一固定步前即使第二次采样没有新的跳跃边沿,旧请求仍在;首次消费后,下一固定步不会再次跳跃。方向保留则符合持续移动的语义。此示例只演示输入交接,不包含角色落地检测,因此真实跳跃是否执行还要由运动系统判断。

接入引擎时设置清晰边界

采样端读取输入动作,不应把键盘键码存进组件;摇杆还需在适配器中设置死区,方向需要按游戏约定转换到局部或世界空间。UI 菜单优先消费输入时,应屏蔽对应玩法动作。失去窗口焦点、设备断开或控制权切换时,及时写入零方向,避免保留上一次移动值。

MoveIntent 是 ECS 的交接数据,而不是永久事件日志。针对“按下”“释放”这类瞬时动作,可以采用一次性位、命令队列或带序号的事件;若要求同一固定步保留多次独立按下,布尔位不够,需要排队。实际引擎若在其他线程回调输入,先进入线程安全缓冲区,再由 World 的指定更新阶段统一提交。

检查是否真的解耦

验证时先同时给出横向和纵向输入,确认长度不会超过 1;再在一个固定步前采样一次跳跃和一次无跳跃,确认只触发一次;最后暂停或断开设备,确认方向归零。移动系统的代码应只认识 MoveIntent 和实体,不出现引擎键码或输入设备对象。满足这些条件后,换手柄、回放或网络控制时就只需更换输入来源,无须重写移动逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

输入数据怎么进入 World

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

登录哪都通