找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/bridge/data/DataKey.ts
1/** 项目玩法、奖励及触发策略的存档键。 字符串值与旧存档保持一致,不与另一层重复定义。 */
2export class DataKey {
3 /** 订阅自动触发节点的当天序号,独立于实际弹窗次数。 */
4 public static readonly SUBSCRIBE_TRIGGER_TRACK = "SUBSCRIBE_TRIGGER_TRACK";
5 /** 每日挑战参与分类及当天已上报行为,跨启动去重。 */
6 public static readonly DAILY_CHALLENGE_TRACK = "DAILY_CHALLENGE_TRACK";
7
8 //是否领取过侧边栏奖励
9 public static readonly ISRECEIVE_SIDEBAR_REWARD = "ISRECEIVE_SIDEBAR_REWARD";
10
11 //道具信息
12 public static readonly PROP = "PROP";
13 //货币信息
14 public static readonly CURRENCY = "CURRENCY";
15 //货币恢复数据(按类型数组存储)
16 public static readonly CURRENCY_RECOVERY = "CURRENCY_RECOVERY";
17 //每日分享奖励领取记录,四种分享额度相互独立
18 public static readonly DAILY_SHARE_REWARD_DATA = "DAILY_SHARE_REWARD_DATA";
19
20
21
22 //**每日系统************************************************************************************************//
23 //上次进入游戏时间
24 public static readonly LAST_ENTER_TIME = "LAST_ENTER_TIME";
25
26 //**七日签到系统************************************************************************************************//
27 //七日签到完整数据
28 public static readonly SEVEN_SIGN = "SEVEN_SIGN";
29 //邀请活动数据
30 public static readonly INVITATION = "INVITATION";
31 //里程碑已领取档位
32 public static readonly MILESTONE_CLAIMED = "MILESTONE_CLAIMED";
33 //成就已领取记录
34 public static readonly ACHIEVEMENT_CLAIMED = "ACHIEVEMENT_CLAIMED";
35 //成就累计进度(以 AchievementId 为字段统一保存)
36 public static readonly ACHIEVEMENT_PROGRESS = "ACHIEVEMENT_PROGRESS";
37 //推荐流已完成关卡
38 public static readonly FEED_FINISH_LEVEL = "FEED_FINISH_LEVEL";
39
40
41 //**新手引导************************************************************************************************//
42 public static readonly GUIDE_DATA = "GUIDE_DATA"; //新手引导数据
43 public static readonly IsNewer = "IsNewer"; // 是否是新玩家,保留已有键名大小写。
44
45 //*收藏系统************************************************************************************************//
46 // 收藏状态
47 public static readonly COLLECT = "COLLECT";
48
49
50 //**找物体子游戏************************************************************************************************//
51 //找物体当前关卡 从1开始
52 public static readonly FIND_CUR_LEVEL = "FIND_CUR_LEVEL";
53 // 找物全部通关时的 MAX_LEVEL(>0 表示已通关过最后一关;对比当前 MAX_LEVEL 判断是否有新增关卡)
54 public static readonly FIND_MAX_LEVEL_CLEARED = "FIND_MAX_LEVEL_CLEARED";
55 //找物体首次错误提示已完成
56 public static readonly FIND_ERROR_HINT_FIRST_DONE = "FIND_ERROR_HINT_FIRST_DONE";
57 //找物体第三次错误提示已完成(第一关3次/非第一关2次)
58 public static readonly FIND_ERROR_HINT_THIRD_DONE = "FIND_ERROR_HINT_THIRD_DONE";
59
60 //**每日挑战子游戏************************************************************************************************//
61 // 每日挑战重制版:已完成的每日挑战 lvIdx 集合
62 public static readonly DAILY_CHALLENGE_COMPLETED_LEVELS = "DAILY_CHALLENGE_COMPLETED_LEVELS";
63 // 每日挑战重制版:当前月份及已领取的进度宝箱档位
64 public static readonly DAILY_CHALLENGE_CLAIMED_MILESTONES = "DAILY_CHALLENGE_CLAIMED_MILESTONES";
65
66 //独立热点进度:广告解锁编号和已通关编号
67 public static readonly HOTSPOT_PROGRESS = "HOTSPOT_PROGRESS";
68 /** 按玩法来源和关卡保存累计进入次数,供首次进入与加载埋点使用。 */
69 public static readonly FIND_LEVEL_ENTER_COUNTS = "FIND_LEVEL_ENTER_COUNTS";
70 /** JD 通关加桌弹窗上次展示日期(yyyy-mm-dd,每天最多一次) */
71 public static readonly JD_ADD_DESK_PASS_POPUP_DATE = "JD_ADD_DESK_PASS_POPUP_DATE";
72 /** JD 桌面复访奖励上次领取日期(yyyy-mm-dd) */
73 public static readonly JD_ADD_DESK_REWARD_LAST_DATE = "JD_ADD_DESK_REWARD_LAST_DATE";
74 /** JD 桌面复访奖励累计领取天数 */
75 public static readonly JD_ADD_DESK_REWARD_DAYS = "JD_ADD_DESK_REWARD_DAYS";
76
77 //**定向流************************************************************************************************//
78 /** Feed 新订阅逻辑:玩家注册日期(yyyy-MM-dd),用于区分注册首日和后续日期。 */
79 public static readonly TTFeedRegisterDate = "TTFeedRegisterDate";
80 /** Feed 新订阅逻辑:注册首日已拉起订阅弹窗次数。 */
81 public static readonly TTFeedFirstDayPopupCount = "TTFeedFirstDayPopupCount";
82 /** Feed 新订阅逻辑:后续日期每日订阅弹窗拉起日期(yyyy-MM-dd)。 */
83 public static readonly TTFeedDailyPopupDate = "TTFeedDailyPopupDate";
84 /** Feed 新订阅逻辑:上一次 storeFeedData 排期的最后就绪时间戳(ms)。 */
85 public static readonly TTFeedLastPushTime = "TTFeedLastPushTime";
86
87 /** 单日连续通关日期(用于每日重置连续计数) */
88 public static readonly ACHIEVEMENT_DAILY_DATE = "ACHIEVEMENT_DAILY_DATE";
89
90 //**大厅入口红点************************************************************************************************//
91 /** 收藏引导入口是否显示红点。 */
92 public static readonly LOBBY_HALL_ENTRY_RED_DOT_COLLECT_GUIDE = "LOBBY_HALL_ENTRY_RED_DOT_COLLECT_GUIDE";
93 /** 推荐流入口是否显示红点。 */
94 public static readonly LOBBY_HALL_ENTRY_RED_DOT_RECOMMEND = "LOBBY_HALL_ENTRY_RED_DOT_RECOMMEND";
95 /** 添加桌面入口是否显示红点。 */
96 public static readonly LOBBY_HALL_ENTRY_RED_DOT_ADD_DESK = "LOBBY_HALL_ENTRY_RED_DOT_ADD_DESK";
97 /** 订阅入口是否显示红点。 */
98 public static readonly LOBBY_HALL_ENTRY_RED_DOT_SUBSCRIBE = "LOBBY_HALL_ENTRY_RED_DOT_SUBSCRIBE";
99 /** 侧边栏入口是否显示红点。 */
100 public static readonly LOBBY_HALL_ENTRY_RED_DOT_SLIDER = "LOBBY_HALL_ENTRY_RED_DOT_SLIDER";
101 /** 排行榜入口是否显示红点。 */
102 public static readonly LOBBY_HALL_ENTRY_RED_DOT_RANK = "LOBBY_HALL_ENTRY_RED_DOT_RANK";
103 /** 选关入口是否显示红点。 */
104 public static readonly LOBBY_HALL_ENTRY_RED_DOT_SELECT_LEVEL = "LOBBY_HALL_ENTRY_RED_DOT_SELECT_LEVEL";
105 /** 里程碑入口是否显示红点。 */
106 public static readonly LOBBY_HALL_ENTRY_RED_DOT_MILESTONE = "LOBBY_HALL_ENTRY_RED_DOT_MILESTONE";
107 /** 成就入口是否显示红点。 */
108 public static readonly LOBBY_HALL_ENTRY_RED_DOT_ACHIEVEMENT = "LOBBY_HALL_ENTRY_RED_DOT_ACHIEVEMENT";
109 /** 图鉴入口是否显示红点。 */
110 public static readonly LOBBY_HALL_ENTRY_RED_DOT_GALLERY = "LOBBY_HALL_ENTRY_RED_DOT_GALLERY";
111 /** 加入群聊入口是否显示红点。 */
112 public static readonly LOBBY_HALL_ENTRY_RED_DOT_JOIN_GROUP = "LOBBY_HALL_ENTRY_RED_DOT_JOIN_GROUP";
113 /** 分享入口是否显示红点。 */
114 public static readonly LOBBY_HALL_ENTRY_RED_DOT_SHARE = "LOBBY_HALL_ENTRY_RED_DOT_SHARE";
115
116 /** 图鉴重复游玩解锁提示是否已经展示。 */
117 public static readonly LEVEL_ARCHIVE_REPLAY_UNLOCK_POPUP_SHOWN = "LEVEL_ARCHIVE_REPLAY_UNLOCK_POPUP_SHOWN";
118}
讲解119 行
存档键定义人工通读

DataKey.ts

集中声明项目所有本地存档键,字符串值直接作为存档字段名,覆盖货币、道具、签到、成就、每日挑战、热点、推荐流与大厅红点。业务系统通过 Framework.Data 以这些常量读写存档,键值必须与旧版本存档兼容。

按注释分区浏览即可,重点看带日期格式、跨启动去重和大小写不规范的几个键。

特殊处理与易错点

2注释DataKey:项目玩法、奖励及触发策略的存档键。 字符串值与旧存档保持一致,不与另一层重复定义。
4注释订阅自动触发节点的当天序号,独立于实际弹窗次数。
6注释每日挑战参与分类及当天已上报行为,跨启动去重。
9注释是否领取过侧边栏奖励
12注释道具信息
14注释货币信息
16注释货币恢复数据(按类型数组存储)
18注释每日分享奖励领取记录,四种分享额度相互独立
24注释每日系统************************************************************************************************// 上次进入游戏时间
28注释七日签到系统************************************************************************************************// 七日签到完整数据
30注释邀请活动数据
32注释里程碑已领取档位
34注释成就已领取记录
36注释成就累计进度(以 AchievementId 为字段统一保存)
38注释推荐流已完成关卡
42注释新手引导
47注释收藏系统************************************************************************************************// 收藏状态
52注释找物体子游戏************************************************************************************************// 找物体当前关卡 从1开始
54注释找物全部通关时的 MAX_LEVEL(>0 表示已通关过最后一关;对比当前 MAX_LEVEL 判断是否有新增关卡)
56注释找物体首次错误提示已完成
58注释找物体第三次错误提示已完成(第一关3次/非第一关2次)
62注释每日挑战子游戏************************************************************************************************// 每日挑战重制版:已完成的每日挑战 lvIdx 集合
64注释每日挑战重制版:当前月份及已领取的进度宝箱档位
67注释独立热点进度:广告解锁编号和已通关编号
69注释按玩法来源和关卡保存累计进入次数,供首次进入与加载埋点使用。
71注释JD 通关加桌弹窗上次展示日期(yyyy-mm-dd,每天最多一次)
73注释JD 桌面复访奖励上次领取日期(yyyy-mm-dd)
75注释JD 桌面复访奖励累计领取天数
79注释Feed 新订阅逻辑:玩家注册日期(yyyy-MM-dd),用于区分注册首日和后续日期。
81注释Feed 新订阅逻辑:注册首日已拉起订阅弹窗次数。
83注释Feed 新订阅逻辑:后续日期每日订阅弹窗拉起日期(yyyy-MM-dd)。
85注释Feed 新订阅逻辑:上一次 storeFeedData 排期的最后就绪时间戳(ms)。
88注释单日连续通关日期(用于每日重置连续计数)
92注释大厅入口红点
94注释推荐流入口是否显示红点。
96注释添加桌面入口是否显示红点。
98注释订阅入口是否显示红点。
100注释侧边栏入口是否显示红点。
102注释排行榜入口是否显示红点。
104注释选关入口是否显示红点。
106注释里程碑入口是否显示红点。
108注释成就入口是否显示红点。
110注释图鉴入口是否显示红点。
112注释加入群聊入口是否显示红点。
114注释分享入口是否显示红点。
117注释图鉴重复游玩解锁提示是否已经展示。