游戏客户端架构 / 系统课时
时间、枚举和浮点数怎么落盘
时间、枚举和浮点数怎么落盘
时间、枚举和浮点数看起来都能直接序列化,但跨平台、跨版本后最容易出现时区偏移、枚举错位和精度差异。稳定的存档格式应先定义持久化语义,再决定编码方式,而不是直接照搬语言运行时中的类型表示。
学习目标
- 为存档中的时间选择明确、跨平台的表示方式
- 避免枚举成员调整导致旧存档含义改变
- 根据数据用途决定浮点数是否需要量化或限定精度
时间统一保存为绝对时间
表示“某件事真实发生在什么时候”时,优先保存 UTC Unix 时间戳。它不依赖设备时区,也容易被不同语言解析。毫秒级通常已经足够游戏存档使用,例如 1760000000123 表示 Unix Epoch 之后经过的毫秒数。
如果业务还需要恢复玩家当时看到的本地时间,仅保存时间戳并不够,还应另外保存时区标识。不要只保存 2026-10-08 20:00:00 这种没有时区的信息,因为换设备后无法判断它属于哪个时区。
枚举不要依赖声明顺序
很多语言会默认给枚举成员分配从 0 开始的整数值。如果把这个隐式整数直接写进存档,后来在枚举中间插入一个成员,旧数字就可能被解释成新的含义。
更安全的方案有两种:使用显式且永不复用的数值编码,或者保存稳定字符串编码。对于可读性要求较高、成员数量较少的存档,字符串通常更容易调试和迁移。
using System;
public enum Difficulty
{
Easy,
Normal,
Hard
}
public static class DifficultyCodec
{
public static string Encode(Difficulty value) => value switch
{
Difficulty.Easy => "easy",
Difficulty.Normal => "normal",
Difficulty.Hard => "hard",
_ => throw new ArgumentOutOfRangeException(nameof(value))
};
public static Difficulty Decode(string code) => code switch
{
"easy" => Difficulty.Easy,
"normal" => Difficulty.Normal,
"hard" => Difficulty.Hard,
_ => Difficulty.Normal // 未知旧值或未来值使用明确的降级策略
};
}
public static class Program
{
public static void Main()
{
string stored = DifficultyCodec.Encode(Difficulty.Hard);
Difficulty restored = DifficultyCodec.Decode(stored);
Console.WriteLine(stored);
Console.WriteLine(restored);
}
}预期输出:
hard
Hard即使以后调整 Difficulty 的声明顺序,存档里的 hard 仍然保持原来的业务含义。若使用整数编码,也应显式固定每个数字并保证废弃值永不分配给其他成员。
浮点数先看用途再决定精度
浮点数不适合假设“序列化再反序列化后一定能按十进制完全相等”。角色坐标、速度、动画参数等本来就是近似量,通常保存 IEEE 754 float 或 double 的正常序列化结果即可,但比较时应允许误差。
如果数据要求确定的离散精度,例如经验倍率只允许千分之一,可以在落盘前量化成整数。假设倍率为 1.275,保存 1275,读取后再除以 1000.0。金币、库存数量等本来就是整数的数据更不应使用浮点数。
| 数据 | 推荐表示 | 原因 |
|---|---|---|
| 世界事件发生时间 | UTC Unix 毫秒 | 跨时区、跨平台 |
| 游戏内持续时间 | 整数毫秒或 Tick | 不受日期与时区影响 |
| 枚举状态 | 稳定字符串或显式整数码 | 避免版本调整导致错位 |
| 角色坐标 | float/double |
本身允许近似值 |
| 固定三位小数的倍率 | 整数量化值 | 精度规则明确且可重复 |
把持久化规则写进数据模型
下面的 JSON 展示一种跨平台存档表示。它是数据结构示例,不依赖某个特定游戏引擎:
{
"savedAtUnixMs": 1760000000123,
"difficulty": "hard",
"experienceRateMilli": 1275,
"positionX": 12.5
}experienceRateMilli 明确约定为“倍率乘以 1000 后的整数”,因此 1275 恢复为 1.275。positionX 则允许采用普通浮点表示,因为位置数据通常不需要十进制完全一致。
验证存档格式时,应检查同一份数据在目标平台上能恢复相同的业务含义,而不是只比较文本是否逐字一致。真正稳定的协议来自明确的单位、时区、枚举编码和精度约定;这些规则一旦进入已发布存档,就应通过版本迁移修改,而不是静默改变含义。