多人游戏与网络同步 / 系统课时
记录输入序号和状态快照
记录输入序号和状态快照
要让客户端预测能够被校正,首先必须知道“自己发过哪些输入”和“服务器确认处理到了哪里”。因此需要把输入序号、时间戳以及可恢复的状态快照分开记录,形成稳定的同步基础。
学习目标
- 设计可追踪的输入编号与时间戳字段
- 区分输入记录和状态快照各自保存什么
- 用 Python 建立一套最小可验证的数据结构
输入记录应该保存什么
输入记录描述的是玩家做了什么,而不是角色最终走到了哪里。一个最小输入项可以包含 seq、clientTimeMs、actorId、input 四类信息,其中 seq 用于唯一标识本地输入顺序,clientTimeMs 用于记录产生时间。
seq 应该单调递增,例如 101、102、103。服务器返回已处理到 102 时,客户端就能明确知道 101 和 102 已经进入权威处理范围,而 103 仍可能需要等待确认。
时间戳主要用于调试、延迟测量和回放定位。它不应代替 seq 做可靠的顺序判断,因为不同机器的时钟可能存在偏差。
状态快照应该保存什么
状态快照描述某个时刻的可恢复状态,例如 position、velocity、yaw 以及服务器已经处理到的输入序号。快照的核心价值不是“保存越多越好”,而是让客户端能够回到一个明确的权威状态,再重新应用尚未确认的输入。
输入记录和状态快照的职责可以这样区分:输入记录回答“玩家依次做了什么”,状态快照回答“服务器确认的角色状态是什么,以及确认到了哪条输入”。这两个集合不能互相替代。
用数据结构记录并检查状态
下面的示例使用 Python dataclasses 保存输入和快照,并打印一组数据。代码没有依赖第三方库,可以直接运行;其中时间戳使用示例值,真实项目应写入采集输入时的实际毫秒时间。
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)预期输出
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。状态越大,序列化、传输和回滚恢复的成本通常越高。
时间戳应使用统一单位,并明确单位含义,例如全部使用毫秒。展示时间、日志时间和网络协议时间可以分别存在,但用于同步计算的字段必须保持定义稳定,否则排查时很容易把秒和毫秒混在一起。
当输入历史和状态快照建立起来后,客户端就获得了两条可以互相对照的信息:一条是“我做过什么”,另一条是“服务器确认到了哪里”。这正是后续预测、重放和校正能够成立的前提。