294 lines
9.3 KiB
TypeScript
294 lines
9.3 KiB
TypeScript
import { sys } from 'cc';
|
||
import { StaminaInfo } from '../types/ApiTypes';
|
||
|
||
/**
|
||
* 用户进度数据结构
|
||
*/
|
||
interface UserProgress {
|
||
/** 当前关卡索引（0-based） */
|
||
currentLevelIndex: number;
|
||
/** 已通关的最高关卡索引 */
|
||
maxUnlockedLevelIndex: number;
|
||
}
|
||
|
||
/**
|
||
* 用户信息结构
|
||
*/
|
||
interface UserInfo {
|
||
avatarUrl: string;
|
||
nickName: string;
|
||
}
|
||
|
||
/**
|
||
* 本地存储管理器
|
||
* 统一管理用户数据的本地持久化存储
|
||
*/
|
||
export class StorageManager {
|
||
/** 体力值存储键 */
|
||
private static readonly KEY_STAMINA = 'game_stamina';
|
||
|
||
/** 用户进度存储键 */
|
||
private static readonly KEY_PROGRESS = 'game_progress';
|
||
|
||
/** 认证 token 存储键 */
|
||
private static readonly KEY_TOKEN = 'auth_token';
|
||
|
||
/** 用户信息存储键 */
|
||
private static readonly KEY_USER_INFO = 'user_info';
|
||
|
||
/** 默认体力值 */
|
||
private static readonly DEFAULT_STAMINA: StaminaInfo = {
|
||
current: 50,
|
||
max: 50,
|
||
nextRecoverAt: null,
|
||
};
|
||
|
||
/** 默认进度 */
|
||
private static readonly DEFAULT_PROGRESS: UserProgress = {
|
||
currentLevelIndex: 0,
|
||
maxUnlockedLevelIndex: 0
|
||
};
|
||
|
||
/** 进度缓存（避免重复读取 localStorage） */
|
||
private static _progressCache: UserProgress | null = null;
|
||
|
||
/** 体力缓存（避免重复 JSON 解析） */
|
||
private static _staminaCache: StaminaInfo | null = null;
|
||
|
||
// ==================== 体力值管理 ====================
|
||
|
||
/**
|
||
* 获取当前体力信息（带内存缓存，避免重复 JSON 解析）
|
||
*/
|
||
static getStamina(): StaminaInfo {
|
||
if (StorageManager._staminaCache) {
|
||
return { ...StorageManager._staminaCache };
|
||
}
|
||
|
||
const stored = sys.localStorage.getItem(StorageManager.KEY_STAMINA);
|
||
if (stored === null || stored === '') {
|
||
StorageManager.setStamina(StorageManager.DEFAULT_STAMINA);
|
||
return { ...StorageManager.DEFAULT_STAMINA };
|
||
}
|
||
try {
|
||
const stamina = JSON.parse(stored) as StaminaInfo;
|
||
if (typeof stamina.current !== 'number' || typeof stamina.max !== 'number') {
|
||
StorageManager.setStamina(StorageManager.DEFAULT_STAMINA);
|
||
return { ...StorageManager.DEFAULT_STAMINA };
|
||
}
|
||
StorageManager._staminaCache = stamina;
|
||
return { ...stamina };
|
||
} catch {
|
||
StorageManager.setStamina(StorageManager.DEFAULT_STAMINA);
|
||
return { ...StorageManager.DEFAULT_STAMINA };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 设置体力信息（同时更新缓存）
|
||
*/
|
||
static setStamina(stamina: StaminaInfo): void {
|
||
StorageManager._staminaCache = stamina;
|
||
sys.localStorage.setItem(StorageManager.KEY_STAMINA, JSON.stringify(stamina));
|
||
console.log(`[StorageManager] 体力已更新: ${stamina.current}/${stamina.max}`);
|
||
}
|
||
|
||
/**
|
||
* 检查是否有足够的体力
|
||
*/
|
||
static hasStamina(): boolean {
|
||
return StorageManager.getStamina().current > 0;
|
||
}
|
||
|
||
// ==================== 认证 Token 管理 ====================
|
||
|
||
/**
|
||
* 获取认证 token
|
||
*/
|
||
static getToken(): string | null {
|
||
const token = sys.localStorage.getItem(StorageManager.KEY_TOKEN);
|
||
return (token === null || token === '') ? null : token;
|
||
}
|
||
|
||
/**
|
||
* 设置认证 token
|
||
*/
|
||
static setToken(token: string): void {
|
||
sys.localStorage.setItem(StorageManager.KEY_TOKEN, token);
|
||
console.log('[StorageManager] Token 已保存');
|
||
}
|
||
|
||
/**
|
||
* 清除认证 token
|
||
*/
|
||
static clearToken(): void {
|
||
sys.localStorage.removeItem(StorageManager.KEY_TOKEN);
|
||
console.log('[StorageManager] Token 已清除');
|
||
}
|
||
|
||
// ==================== 关卡进度管理 ====================
|
||
|
||
/**
|
||
* 获取用户进度数据（带缓存）
|
||
* @returns 用户进度对象的副本
|
||
*/
|
||
private static _getProgress(): UserProgress {
|
||
// 返回缓存副本
|
||
if (StorageManager._progressCache !== null) {
|
||
return { ...StorageManager._progressCache };
|
||
}
|
||
|
||
const stored = sys.localStorage.getItem(StorageManager.KEY_PROGRESS);
|
||
if (stored === null || stored === '') {
|
||
// 新用户，返回默认进度
|
||
StorageManager._progressCache = { ...StorageManager.DEFAULT_PROGRESS };
|
||
return { ...StorageManager._progressCache };
|
||
}
|
||
|
||
try {
|
||
const progress = JSON.parse(stored) as UserProgress;
|
||
// 验证数据有效性
|
||
if (typeof progress.currentLevelIndex !== 'number' ||
|
||
typeof progress.maxUnlockedLevelIndex !== 'number' ||
|
||
progress.currentLevelIndex < 0 ||
|
||
progress.maxUnlockedLevelIndex < 0) {
|
||
console.warn('[StorageManager] 进度数据无效，使用默认值');
|
||
StorageManager._progressCache = { ...StorageManager.DEFAULT_PROGRESS };
|
||
} else {
|
||
StorageManager._progressCache = progress;
|
||
}
|
||
return { ...StorageManager._progressCache };
|
||
} catch (e) {
|
||
console.warn('[StorageManager] 解析进度数据失败，使用默认值');
|
||
StorageManager._progressCache = { ...StorageManager.DEFAULT_PROGRESS };
|
||
return { ...StorageManager._progressCache };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 保存用户进度数据
|
||
* @param progress 进度对象
|
||
*/
|
||
private static _saveProgress(progress: UserProgress): void {
|
||
StorageManager._progressCache = progress;
|
||
sys.localStorage.setItem(StorageManager.KEY_PROGRESS, JSON.stringify(progress));
|
||
}
|
||
|
||
/**
|
||
* 获取当前关卡索引
|
||
* @returns 当前关卡索引（0-based）
|
||
*/
|
||
static getCurrentLevelIndex(): number {
|
||
return StorageManager._getProgress().currentLevelIndex;
|
||
}
|
||
|
||
/**
|
||
* 设置当前关卡索引
|
||
* @param index 关卡索引
|
||
*/
|
||
static setCurrentLevelIndex(index: number): void {
|
||
if (index < 0) {
|
||
console.warn('[StorageManager] 关卡索引不能为负数');
|
||
return;
|
||
}
|
||
const progress = StorageManager._getProgress();
|
||
progress.currentLevelIndex = index;
|
||
StorageManager._saveProgress(progress);
|
||
console.log(`[StorageManager] 当前关卡已更新: ${progress.currentLevelIndex}`);
|
||
}
|
||
|
||
/**
|
||
* 获取已解锁的最高关卡索引
|
||
* @returns 最高关卡索引（0-based）
|
||
*/
|
||
static getMaxUnlockedLevelIndex(): number {
|
||
return StorageManager._getProgress().maxUnlockedLevelIndex;
|
||
}
|
||
|
||
/**
|
||
* 通关后更新进度
|
||
* 当玩家通关第 N 关后，设置当前关卡为 N+1，解锁关卡更新为 max(N, 已解锁)
|
||
* @param completedLevelIndex 刚通关的关卡索引
|
||
*/
|
||
static onLevelCompleted(completedLevelIndex: number): void {
|
||
if (completedLevelIndex < 0) {
|
||
console.warn('[StorageManager] 通关关卡索引不能为负数');
|
||
return;
|
||
}
|
||
const progress = StorageManager._getProgress();
|
||
const nextLevelIndex = completedLevelIndex + 1;
|
||
|
||
// 更新当前关卡为下一关
|
||
progress.currentLevelIndex = nextLevelIndex;
|
||
|
||
// 更新最高解锁关卡
|
||
progress.maxUnlockedLevelIndex = Math.max(progress.maxUnlockedLevelIndex, completedLevelIndex);
|
||
|
||
StorageManager._saveProgress(progress);
|
||
console.log(`[StorageManager] 通关第 ${completedLevelIndex + 1} 关，下一关: ${nextLevelIndex + 1}`);
|
||
}
|
||
|
||
/**
|
||
* 检查指定关卡是否已解锁
|
||
* @param levelIndex 关卡索引
|
||
* @returns 是否已解锁
|
||
*/
|
||
static isLevelUnlocked(levelIndex: number): boolean {
|
||
const progress = StorageManager._getProgress();
|
||
return levelIndex <= progress.maxUnlockedLevelIndex;
|
||
}
|
||
|
||
/**
|
||
* 重置所有进度
|
||
*/
|
||
static resetProgress(): void {
|
||
StorageManager._progressCache = null;
|
||
sys.localStorage.removeItem(StorageManager.KEY_PROGRESS);
|
||
console.log('[StorageManager] 进度已重置');
|
||
}
|
||
|
||
/**
|
||
* 重置所有数据（体力 + 进度）
|
||
*/
|
||
static resetAll(): void {
|
||
StorageManager.setStamina(StorageManager.DEFAULT_STAMINA);
|
||
StorageManager.resetProgress();
|
||
StorageManager.clearToken();
|
||
StorageManager.clearUserInfo();
|
||
console.log('[StorageManager] 所有数据已重置');
|
||
}
|
||
|
||
// ==================== 用户信息管理 ====================
|
||
|
||
/**
|
||
* 保存用户信息（头像、昵称）
|
||
* @param userInfo 用户信息对象
|
||
*/
|
||
static setUserInfo(userInfo: UserInfo): void {
|
||
sys.localStorage.setItem(StorageManager.KEY_USER_INFO, JSON.stringify(userInfo));
|
||
console.log('[StorageManager] 用户信息已保存');
|
||
}
|
||
|
||
/**
|
||
* 获取本地缓存的用户信息
|
||
* @returns 用户信息对象或 null
|
||
*/
|
||
static getUserInfo(): UserInfo | null {
|
||
const data = sys.localStorage.getItem(StorageManager.KEY_USER_INFO);
|
||
if (!data) return null;
|
||
try {
|
||
return JSON.parse(data) as UserInfo;
|
||
} catch {
|
||
return null;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 清除用户信息缓存
|
||
*/
|
||
static clearUserInfo(): void {
|
||
sys.localStorage.removeItem(StorageManager.KEY_USER_INFO);
|
||
console.log('[StorageManager] 用户信息已清除');
|
||
}
|
||
}
|