找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/data/DataFrameKey.ts
1/** 公司固定基础服务及平台状态的存档键。 字符串值与旧存档保持一致,不与另一层重复定义。 */
2export class DataFrameKey {
3 /** 首次进入日期;历史玩家缺失时以本次启动日补记,后续不覆盖。 */
4 public static readonly FIRST_ACTIVE_DATE = "FIRST_ACTIVE_DATE";
5 /** 日常活跃最近上报日期,YYYY-MM-DD,用于跨启动去重。 */
6 public static readonly LAST_DAILY_ACTIVE_DATE = "LAST_DAILY_ACTIVE_DATE";
7
8 /** 完整存档数据版本,只能由 DataManager 修改。 */
9 public static readonly STR_VERSION = "STR_VERSION"; //number类型
10 /** 最近一次业务数据更新时间,仅用于日志和排查。 */
11 public static readonly UPDATE_TIME = "UPDATE_TIME";
12 /** 玩家昵称、头像及邀请标识等基础资料。 */
13 public static readonly PLAYER_PROFILE = "PLAYER_PROFILE";
14
15 /** 客户端资源版本缓存,不参与存档新旧判断。 */
16 public static readonly CLIENT_RESOURCE_VERSION = "CLIENT_RESOURCE_VERSION";
17
18
19 //**音频设置************************************************************************************************//
20 //音乐启用状态
21 public static readonly MUSIC_ENABLED = "MUSIC_ENABLED";
22 //音效启用状态
23 public static readonly SOUND_ENABLED = "SOUND_ENABLED";
24 //震动启用状态
25 public static readonly SHAKE_ENABLED = "SHAKE_ENABLED";
26 //**渠道 SDK / 埋点************************************************************************************************//
27 /** 渠道登录成功累计次数(本地持久化,用于 sdkLogin 埋点 num) */
28 public static readonly SDK_LOGIN_SUCCESS_COUNT = "SDK_LOGIN_SUCCESS_COUNT";
29 /** 每次启动耗时:是否已上报 */
30 public static readonly EVERY_LAUNCH_REPORTED = "EVERY_LAUNCH_REPORTED";
31 /** 每次启动耗时:启动起始时间戳(ms) */
32 public static readonly EVERY_LAUNCH_START_MS = "EVERY_LAUNCH_START_MS";
33 /** 每次启动耗时:启动目标场景 */
34 public static readonly EVERY_LAUNCH_SCENE = "EVERY_LAUNCH_SCENE";
35 /** 每次启动耗时:启动次数 -每日到点清除 */
36 public static readonly EVERY_LAUNCH_NUM = "EVERY_LAUNCH_NUM";
37 /** AB 系统匿名 ID(openId 不可用时用于稳定分桶) */
38 public static readonly AB_ANON_ID = "AB_ANON_ID";
39 /** AB 实验决策缓存 */
40 public static readonly AB_EXPERIMENT_DECISIONS = "AB_EXPERIMENT_DECISIONS";
41 /** AB 实验手动分组覆盖(测试面板使用,key 为实验名) */
42 public static readonly AB_MANUAL_OVERRIDE = "AB_MANUAL_OVERRIDE";
43
44 //**京东sdk************************************************************************************************//
45 /** JD 登录链路是否已校验 */
46 public static readonly JD_LOGIN_VALIDATED = "JD_LOGIN_VALIDATED";
47 /** JD 登录返回 xid */
48 public static readonly JD_XID = "JD_XID";
49 /** JD iOS 添加桌面按钮是否点击过(iOS 无法检测真实桌面状态) */
50 public static readonly JD_ADD_DESK_CLICKED = "JD_ADD_DESK_CLICKED";
51 /** 当前已从推荐流进入小游戏的 contentId,用于小游戏重启后恢复进入状态。 */
52 public static readonly TTFeedEnteredContentId = "TTFeedEnteredContentId";
53
54 //**微信授权与个人信息************************************************************************************************//
55 /** 微信好友授权是否已通过(本地缓存,避免重复请求 wx.authorize) */
56 public static readonly WX_FRIEND_AUTH_GRANTED = "WX_FRIEND_AUTH_GRANTED";
57 /** 是否已向微信请求过头像昵称(防止多次弹窗 getUserInfo) */
58 public static readonly WX_USER_PROFILE_REQUESTED = "WX_USER_PROFILE_REQUESTED";
59}
讲解60 行
框架级存档键常量人工通读

DataFrameKey.ts

集中声明玩家存档中框架与渠道侧使用的固定键字符串,覆盖版本、首次进入日期、玩家资料、音频开关、渠道登录埋点、AB 实验、京东与微信授权状态。字符串值与旧存档保持一致,业务与框架都直接引用常量而不再重复写死。

按注释分组浏览:基础信息、音频设置、渠道 SDK 埋点、京东、微信授权,再用具体字符串值在工程里反查读写位置。

特殊处理与易错点

2注释DataFrameKey:公司固定基础服务及平台状态的存档键。 字符串值与旧存档保持一致,不与另一层重复定义。
4注释首次进入日期;历史玩家缺失时以本次启动日补记,后续不覆盖。
6注释日常活跃最近上报日期,YYYY-MM-DD,用于跨启动去重。
9注释完整存档数据版本,只能由 DataManager 修改。
11注释最近一次业务数据更新时间,仅用于日志和排查。
13注释玩家昵称、头像及邀请标识等基础资料。
16注释客户端资源版本缓存,不参与存档新旧判断。
21注释音频设置************************************************************************************************// 音乐启用状态
23注释音效启用状态
25注释震动启用状态
28注释渠道 SDK / 埋点
30注释每次启动耗时:是否已上报
32注释每次启动耗时:启动起始时间戳(ms)
34注释每次启动耗时:启动目标场景
36注释每次启动耗时:启动次数 -每日到点清除
38注释AB 系统匿名 ID(openId 不可用时用于稳定分桶)
40注释AB 实验决策缓存
42注释AB 实验手动分组覆盖(测试面板使用,key 为实验名)
46注释京东sdk
48注释JD 登录返回 xid
50注释JD iOS 添加桌面按钮是否点击过(iOS 无法检测真实桌面状态)
52注释当前已从推荐流进入小游戏的 contentId,用于小游戏重启后恢复进入状态。
56注释微信授权与个人信息
58注释是否已向微信请求过头像昵称(防止多次弹窗 getUserInfo)