目录— 个文件
⌕
目录加载中…
…/core/data/DataDefine.ts
1/** DataManager 的固定配置。 */
2export class DataDefine {
3 /** 连续业务修改合并为一次上传的等待时间,单位秒。 */
4 public static readonly UploadDelaySeconds: number = 0.4;
5}
6
7/** 存档允许保存的 JSON 值;禁止函数、Map、Set、节点等运行时对象进入存档。 */
8export type DataValue = null | boolean | number | string | DataValue[] | { [key: string]: DataValue };
9
10/** 完整玩家数据;字段名来自 DataFrameKey 或项目 DataKey,两者仍保存在同一份存档中。 */
11export type DataModel = Record<string, DataValue>;
12
13/** 当前使用的存档来源,决定本次会话是否允许上传服务器。 */
14export enum DataSource {
15 /** 客户端 localStorage 中的存档。 */
16 Local = "local",
17 /** 自建服务器返回的存档。 */
18 Server = "server",
19}
讲解20 行
存档类型与常量定义人工通读
DataDefine.ts
定义存档上传的合并延迟、可序列化的 DataValue 与 DataModel 类型,以及 Local 与 Server 两种存档来源枚举。DataManager 用这些类型约束整份存档内容,并用来源枚举决定本次会话是否允许上传服务器。
先看 UploadDelaySeconds 的取值,再读 DataValue 的递归结构,最后看 DataSource 两个枚举值对上传权限的影响。
特殊处理与易错点
- 特殊处理0.4 秒是连续 SaveData 合并成一次上传的窗口,改这个值会直接改变服务端请求频率与断线时丢数据的风险。L4
- 易错点DataValue 只允许 null、布尔、数字、字符串、数组和普通对象;存函数、Map、Set 或节点会在 JSON.stringify 时静默丢字段或抛循环引用。L8
- 设计来源枚举只有 Local 与 Server 两种,切换只发生在校对成功或鉴权失败时,没有第三种中间状态。L14
2注释DataDefine:DataManager 的固定配置。
4注释连续业务修改合并为一次上传的等待时间,单位秒。
8注释存档允许保存的 JSON 值;禁止函数、Map、Set、节点等运行时对象进入存档。
11注释完整玩家数据;字段名来自 DataFrameKey 或项目 DataKey,两者仍保存在同一份存档中。
14注释当前使用的存档来源,决定本次会话是否允许上传服务器。
16注释客户端 localStorage 中的存档。
18注释自建服务器返回的存档。