3.2 KiB
3.2 KiB
当前修补目标：客户端移动抖动
已确认的主要问题
- 客户端当前把
PlayerState.Tick当成“已确认输入 tick”用于 prediction buffer 修剪与重放，但服务端当前发出的PlayerState.Tick实际上是广播 tick，不是最后确认的MoveInput.Tick。 - 客户端本地预测速度来自登录 UI /
LoginResponse.Speed，服务端权威移动速度来自ServerAuthoritativeMovementConfiguration.MoveSpeed，两者当前没有强约束保证一致。 - 客户端本地预测按
FixedUpdate + Time.fixedDeltaTime积分，服务端权威状态按外部传入的elapsed积分；一旦服务端主循环步长与客户端固定步长不一致，转向移动轨迹会持续偏离。 - 客户端收到权威状态后当前仍采用“直接硬回写位置/旋转/速度，再重放”的纠正策略；当对账 tick 或积分条件不一致时，会直接表现为频繁拉扯和可见抖动。
修补目标
- 让客户端 reconciliation 使用明确的“已确认移动输入 tick”，而不是复用广播 tick。
- 统一客户端预测参数与服务端权威参数，至少保证移动速度、转向速度、tick 语义一致。
- 明确服务端 authoritative movement update cadence，避免客户端与服务端长期运行在不同积分节拍上。
- 在完成语义统一后，再决定是否需要补充更平滑的本地纠正策略，而不是先靠插值掩盖逻辑偏差。
实施计划
- 先调整协议或状态表达：为客户端对账提供明确的 movement ack tick，禁止继续用
PlayerState.Tick兼任广播序号和输入确认序号。 - 修改
ClientPredictionBuffer/MovementComponent的 reconciliation 逻辑，使 prediction buffer 按 ack tick 修剪，只重放真正未确认的输入。 - 统一客户端与服务端移动参数来源，收敛
LoginRequest.Speed/LoginResponse.Speed与ServerAuthoritativeMovementConfiguration.MoveSpeed的职责，避免双源真相。 - 检查并修正服务端 authoritative movement 的生产主循环，确保 update cadence 可预测、可配置，并与客户端调试信息可对照。
- 补充或更新回归测试，覆盖：
- 广播 tick 与 ack tick 分离后的 reconciliation 行为
- 客户端 / 服务端速度不一致时的保护或拒绝策略
- 固定 cadence 下的本地预测与权威状态收敛
- 在语义正确后，再评估是否需要把本地 controlled player 的硬纠正改成阈值纠正、渐进纠正或混合策略，以进一步降低视觉抖动。
修补优先级
- P0：tick 语义分离，修正 prediction buffer 错账问题。
- P0：统一移动速度来源，消除客户端预测与服务端权威结果的常量偏差。
- P1：统一或约束 authoritative movement update cadence。
- P2：在逻辑正确前提下优化 controlled player 的视觉纠正体验。
验收标准
- 上层只依赖统一的
ITransport。 KcpTransport是唯一可靠传输实现。- 客户端与服务端都能正常建立 KCP 会话。
- 登录、心跳、输入、状态同步链路可正常跑通。
- 非主线程不再直接访问 Unity 对象。
- 会话超时、断线、重连有明确状态与日志。
- 高频移动同步在丢包 / 抖动场景下仍可用。