找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/bridge/sdk/SdkGameData.ts
1import { Framework } from '../../framework/Framework';
2import type { SdkGameDataAccess } from '../../framework/module/sdk/SdkDefine';
3import { GameFindGlobalDefine } from '../../runtime/manager/game/find/define/GameFindDefine';
4import { DataKey } from '../data/DataKey';
5
6/** SDK 与项目存档的边界:读取最终存档,不依赖玩法 Init,不缓存或复制业务状态。 */
7export const SdkGameData: SdkGameDataAccess = {
8 GetPlayerLevel(): number {
9 return Framework.Data.GetData<number>(DataKey.FIND_CUR_LEVEL, GameFindGlobalDefine.MIN_LEVEL);
10 },
11 GetSidebarRewardReceived(): boolean {
12 return Framework.Data.GetData(DataKey.ISRECEIVE_SIDEBAR_REWARD, false);
13 },
14 SetSidebarRewardReceived(received: boolean): void {
15 Framework.Data.SaveData(DataKey.ISRECEIVE_SIDEBAR_REWARD, received);
16 },
17 GetAddDeskPopupDate(): string {
18 return Framework.Data.GetData<string>(DataKey.JD_ADD_DESK_PASS_POPUP_DATE, '');
19 },
20 SetAddDeskPopupDate(date: string): void {
21 Framework.Data.SaveData(DataKey.JD_ADD_DESK_PASS_POPUP_DATE, date);
22 },
23 GetAddDeskRewardDate(): string {
24 return Framework.Data.GetData<string>(DataKey.JD_ADD_DESK_REWARD_LAST_DATE, '');
25 },
26 SetAddDeskRewardDate(date: string): void {
27 Framework.Data.SaveData(DataKey.JD_ADD_DESK_REWARD_LAST_DATE, date);
28 },
29 GetAddDeskRewardDays(): number {
30 return Framework.Data.GetData<number>(DataKey.JD_ADD_DESK_REWARD_DAYS, 0);
31 },
32 SetAddDeskRewardDays(days: number): void {
33 Framework.Data.SaveData(DataKey.JD_ADD_DESK_REWARD_DAYS, days);
34 },
35};
讲解36 行
SDK 存档访问人工通读

SdkGameData.ts

框架 SDK 与项目存档之间的数据访问对象,全部通过 Framework.Data 即时读写,不缓存也不复制业务状态。GameEntry 在父类初始化前把它注入 Framework.Sdk,供侧边栏奖励、加桌弹窗与加桌奖励等平台逻辑读取玩家进度。

成对的 Get 与 Set 方法按存档键一一对应,逐个核对它们映射到哪个 DataKey。

特殊处理与易错点

7注释SDK 与项目存档的边界:读取最终存档,不依赖玩法 Init,不缓存或复制业务状态。
8方法读取 FIND_CUR_LEVEL 存档,缺省返回 GameFindGlobalDefine.MIN_LEV…
11方法读取 ISRECEIVE_SIDEBAR_REWARD 存档,缺省返回 false 表示侧边栏奖励未领取。
14方法把侧边栏奖励领取状态写回 ISRECEIVE_SIDEBAR_REWARD 存档键。
17方法读取加桌通关弹窗上次展示日期,缺省返回空字符串。
20方法把加桌弹窗展示日期写入 JD_ADD_DESK_PASS_POPUP_DATE 存档键。
23方法读取加桌复访奖励上次领取日期,缺省返回空字符串。
26方法把加桌复访奖励领取日期写入 JD_ADD_DESK_REWARD_LAST_DATE 存档键。
29方法读取加桌复访奖励累计领取天数,缺省返回 0。
32方法把加桌复访奖励累计领取天数写入 JD_ADD_DESK_REWARD_DAYS 存档键。