多人游戏与网络同步 / 系统课时

记录输入序号和状态快照

记录输入序号和状态快照

要让客户端预测能够被校正,首先必须知道“自己发过哪些输入”和“服务器确认处理到了哪里”。因此需要把输入序号、时间戳以及可恢复的状态快照分开记录,形成稳定的同步基础。

学习目标

  • 设计可追踪的输入编号与时间戳字段
  • 区分输入记录和状态快照各自保存什么
  • 用 Python 建立一套最小可验证的数据结构

输入记录应该保存什么

输入记录描述的是玩家做了什么,而不是角色最终走到了哪里。一个最小输入项可以包含 seq、clientTimeMs、actorId、input 四类信息,其中 seq 用于唯一标识本地输入顺序,clientTimeMs 用于记录产生时间。

seq 应该单调递增,例如 101、102、103。服务器返回已处理到 102 时,客户端就能明确知道 101 和 102 已经进入权威处理范围,而 103 仍可能需要等待确认。

时间戳主要用于调试、延迟测量和回放定位。它不应代替 seq 做可靠的顺序判断,因为不同机器的时钟可能存在偏差。

状态快照应该保存什么

状态快照描述某个时刻的可恢复状态,例如 position、velocity、yaw 以及服务器已经处理到的输入序号。快照的核心价值不是“保存越多越好”,而是让客户端能够回到一个明确的权威状态,再重新应用尚未确认的输入。

输入记录和状态快照的职责可以这样区分:输入记录回答“玩家依次做了什么”,状态快照回答“服务器确认的角色状态是什么,以及确认到了哪条输入”。这两个集合不能互相替代。

用数据结构记录并检查状态

下面的示例使用 Python dataclasses 保存输入和快照,并打印一组数据。代码没有依赖第三方库,可以直接运行;其中时间戳使用示例值,真实项目应写入采集输入时的实际毫秒时间。

python
from dataclasses import asdict, dataclass
import json


@dataclass
class InputCommand:
    seq: int
    clientTimeMs: int
    actorId: str
    input: str


@dataclass
class StateSnapshot:
    lastProcessedSeq: int
    positionX: float
    positionY: float
    velocityX: float
    velocityY: float
    yaw: float


input_command = InputCommand(
    seq=101,
    clientTimeMs=1728270000123,
    actorId="player-01",
    input="right",
)

snapshot = StateSnapshot(
    lastProcessedSeq=100,
    positionX=12.5,
    positionY=4.0,
    velocityX=3.0,
    velocityY=0.0,
    yaw=90.0,
)

print("input:", json.dumps(asdict(input_command), ensure_ascii=False))
print("snapshot:", json.dumps(asdict(snapshot), ensure_ascii=False))
print("pending_input_count:", input_command.seq - snapshot.lastProcessedSeq)

预期输出

text
input: {"seq": 101, "clientTimeMs": 1728270000123, "actorId": "player-01", "input": "right"}
snapshot: {"lastProcessedSeq": 100, "positionX": 12.5, "positionY": 4.0, "velocityX": 3.0, "velocityY": 0.0, "yaw": 90.0}
pending_input_count: 1

这里得到的 pending_input_count 为 1,表示本地已经记录了序号 101 的输入,但当前快照只确认到了 100。这个差值不是严格的网络延迟指标,却能帮助客户端快速判断当前还有多少输入等待权威确认。

记录时的几个边界

输入序号不要在收到服务器响应后才生成,否则丢包时无法判断缺失的是哪条请求。更合理的做法是在客户端真正采集并决定发送时立即分配序号,然后把该记录放入短期输入历史。

状态快照也不必保存整棵游戏世界。对于客户端预测通常只保存本地需要重新模拟的权威状态,例如角色位置、速度、朝向以及 lastProcessedSeq。状态越大,序列化、传输和回滚恢复的成本通常越高。

时间戳应使用统一单位,并明确单位含义,例如全部使用毫秒。展示时间、日志时间和网络协议时间可以分别存在,但用于同步计算的字段必须保持定义稳定,否则排查时很容易把秒和毫秒混在一起。

当输入历史和状态快照建立起来后,客户端就获得了两条可以互相对照的信息:一条是“我做过什么”,另一条是“服务器确认到了哪里”。这正是后续预测、重放和校正能够成立的前提。

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

目录与阅读设置

记录一个想法

记录输入序号和状态快照

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

登录哪都通