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

构造可重放的输入流

构造可重放的输入流

当玩家反馈某个操作偶尔失效时,仅凭描述很难复现。本课构造一条可录制、序列化和重放的输入流,将设备事件转化为稳定的逻辑输入记录,并通过统一消费接口离线复现操作顺序,为自动化测试和故障定位提供可重复的数据。

学习目标

  • 理解输入录制边界、时间基准与可重放数据结构。
  • 实现输入事件的录制、JSON 序列化和逐帧回放。
  • 验证回放顺序与消费结果,并识别非确定性来源。

确定录制边界和时间基准

游戏输入通常经历设备采集、按键映射、上下文判断和玩法消费。直接录制键盘扫描码虽然能保留物理操作,但回放依赖设备布局、绑定配置和输入系统实现。录制逻辑动作更适合复现玩法行为,例如移动、跳跃和攻击。

本课选择在动作映射完成之后、玩法消费之前录制事件。每条记录包含帧号、帧内序号、动作名称、动作阶段和数值。使用整数帧号而非真实时间作为主要回放基准,避免操作系统调度和浮点时间误差改变事件顺序。

输入录制与回放的数据流

动作阶段需要具有明确语义。例如 pressed 表示按下沿,released 表示释放沿,held 表示持续输入。连续移动还可以每帧记录归一化轴值。必须提前约定零值和释放事件是否保留,否则回放可能出现角色一直移动或按键无法松开的情况。

实现录制与回放接口

下面使用 Python 标准库实现最小示例。录制器接收逻辑动作,保存为 JSON;回放器按帧读取记录,并调用与实时输入共用的消费函数。示例使用离散动作,不依赖游戏引擎即可运行。

python
import json
from dataclasses import asdict, dataclass
from pathlib import Path


@dataclass(frozen=True)
class InputEvent:
    frame: int
    order: int
    action: str
    phase: str
    value: float


class InputRecorder:
    def __init__(self):
        self.events: list[InputEvent] = []

    def record(self, frame, action, phase, value):
        if frame < 0:
            raise ValueError("frame must be non-negative")
        # 帧内序号由录制顺序决定,避免同帧事件重排。
        order = sum(e.frame == frame for e in self.events)
        self.events.append(InputEvent(frame, order, action, phase, value))

    def save(self, path):
        payload = {
            "version": 1,
            "events": [asdict(event) for event in self.events],
        }
        Path(path).write_text(
            json.dumps(payload, ensure_ascii=False, indent=2),
            encoding="utf-8",
        )


class InputReplayer:
    def __init__(self, path):
        payload = json.loads(Path(path).read_text(encoding="utf-8"))
        if payload.get("version") != 1:
            raise ValueError("unsupported recording version")
        self.events = [InputEvent(**item) for item in payload["events"]]
        self.events.sort(key=lambda e: (e.frame, e.order))
        self.cursor = 0

    def consume_frame(self, frame, consumer):
        if self.cursor < len(self.events) and self.events[self.cursor].frame < frame:
            raise ValueError("replay skipped an event frame")
        while self.cursor < len(self.events):
            event = self.events[self.cursor]
            if event.frame != frame:
                break
            consumer(event)
            self.cursor += 1


def main():
    recorder = InputRecorder()
    recorder.record(10, "Jump", "pressed", 1.0)
    recorder.record(10, "Attack", "pressed", 1.0)
    recorder.record(11, "Jump", "released", 0.0)
    recorder.save("input-recording.json")

    replayer = InputReplayer("input-recording.json")

    def handle_action(event):
        print(f"frame={event.frame} action={event.action} phase={event.phase}")

    for frame in range(12):
        replayer.consume_frame(frame, handle_action)


if __name__ == "__main__":
    main()

将代码保存为 replay_demo.py,使用 Python 3.10 或更高版本执行:

bash
python replay_demo.py

预期输出:

text
frame=10 action=Jump phase=pressed
frame=10 action=Attack phase=pressed
frame=11 action=Jump phase=released

运行目录还会生成 input-recording.json。这个文件保存 version 和 events,每条事件均包含五个字段。由于同一帧按照 order 排序,因此先跳跃再攻击的消费顺序可以被保留。

将回放接入游戏主循环

实际引擎中,应将实时输入源与回放输入源抽象为同一种接口,例如 consume_frame(frame, consumer)。正常游戏从动作映射器读取当前帧事件;回放模式从文件读取对应帧事件。两者最终进入同一个玩法命令处理器,而不是维护两套不同的玩法逻辑。

接入时遵循以下顺序:

  1. 每个逻辑帧开始前确定当前输入源,回放模式下禁止实时输入再次进入玩法消费者。
  2. 读取该帧所有输入事件,并严格按照帧内序号投递。
  3. 在固定的模拟更新阶段处理动作,随后推进游戏状态。
  4. 到达录制结束帧后停止回放,检查全部事件是否消费完毕。

逐帧输入回放时序

示例为了简洁,在 record() 中通过遍历事件计算帧内序号,适合小规模验证。正式实现应使用当前帧计数器,在帧切换时归零,避免录制量增大后的重复扫描。正式回放还应拒绝负帧号、重复的帧内序号和未知动作,并验证事件排序。

验证可重复性与处理边界

输入记录相同不代表游戏结果必然相同。物理模拟步长、随机数种子、初始场景状态、异步加载和网络消息都可能影响结果。要让故障稳定复现,至少需要固定初始状态、模拟时间步长和随机数种子,并记录输入映射版本与游戏构建版本。

可以在关键帧为游戏状态计算摘要,例如玩家位置、生命值和当前动作状态。分别执行两次回放,比较同一逻辑帧的状态摘要。如果输入序列相同而摘要不同,说明还存在输入之外的非确定性来源。

验收时重点检查:同帧多个动作顺序不变;按下和释放事件完整;空帧不会提前消费后续事件;回放结束没有残留输入;同一初始状态下连续回放结果一致。

对于离线测试,优先使用按逻辑帧记录的动作流;需要分析真实设备事件丢失或输入延迟时,再补充原始设备事件与时间戳。两种记录服务于不同问题,不应混为同一个回放保证。

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

目录与阅读设置

阅读设置

17

记录一个想法

构造可重放的输入流

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

登录哪都通