Pillar Valley游戏数据持久化：SQLite与本地存储的完整实现

Pillar Valley游戏数据持久化：SQLite与本地存储的完整实现

【免费下载链接】pillar-valley👾A cross-platform video game built with Expo and three.js项目地址: https://gitcode.com/gh_mirrors/pi/pillar-valley

Pillar Valley是一款基于Expo和three.js构建的跨平台视频游戏，为了提供流畅的游戏体验，游戏数据持久化是核心功能之一。本文将详细介绍Pillar Valley如何利用SQLite和本地存储实现游戏数据的持久化管理，包括分数记录、成就解锁和游戏设置等关键数据的存储策略。

游戏数据持久化架构概览

Pillar Valley采用了分层存储架构，结合了SQLite的可靠性和本地存储的便捷性，为不同类型的游戏数据提供了最佳存储方案。这种混合存储策略确保了游戏数据的安全性和高效访问。

核心存储组件

游戏的持久化系统主要由以下几个核心组件构成：

• SQLite存储层：通过Expo SQLite的键值存储实现，提供可靠的数据持久化能力
• 本地存储适配层：实现了浏览器localStorage API的兼容接口
• 状态管理层：使用Zustand状态管理库结合持久化中间件

这些组件位于项目的src/runtime/和src/zustand/目录下，共同构成了游戏的数据持久化基础设施。

SQLite存储层实现

Pillar Valley使用Expo SQLite的键值存储模块作为底层数据存储引擎，提供了高性能和可靠的数据持久化能力。这一实现位于src/runtime/local-storage.ts文件中。

localStorage兼容层

为了简化开发，项目实现了一个localStorage兼容层，将浏览器的localStorage API映射到底层的SQLite存储：

class StoragePolyfill { get length(): number { return Storage.getAllKeysSync().length; } clear(): void { Storage.clearSync(); } getItem(key: string): string | null { return Storage.getItemSync(key) ?? null; } key(index: number): string | null { return Storage.getAllKeysSync()[index] ?? null; } removeItem(key: string): void { Storage.removeItemSync(key); } setItem(key: string, value: string): void { Storage.setItemSync(key, value); } }

这段代码创建了一个StoragePolyfill类，通过Expo SQLite的同步API实现了标准的localStorage接口，使得上层代码可以使用熟悉的localStorage API进行数据操作，同时享受SQLite带来的持久化保障。

全局对象注入

为了让应用的所有部分都能访问到这个持久化存储，代码将StoragePolyfill实例注入到全局对象中：

const localStoragePolyfill = new StoragePolyfill(); Object.defineProperty(global, "localStorage", { value: localStoragePolyfill, });

这一操作确保了无论是游戏逻辑代码还是UI组件，都可以通过localStorage全局对象访问持久化存储，简化了数据操作流程。

状态管理与持久化集成

Pillar Valley使用Zustand状态管理库结合持久化中间件，实现了游戏状态的自动持久化。这一实现主要位于src/zustand/models.ts文件中。

持久化存储适配器

为了将Zustand状态与底层存储系统连接起来，项目创建了一个LocalStorageObj适配器：

const LocalStorageObj = { getItem: (name: string): string | null | Promise<string | null> => { return localStorage.getItem(name); }, setItem: (name: string, value: string): unknown | Promise<unknown> => { return localStorage.setItem(name, value); }, removeItem: (name: string): unknown | Promise<unknown> => { return localStorage.removeItem(name); }, };

这个适配器将Zustand的持久化需求转换为对前面实现的localStorage兼容层的调用，从而间接使用SQLite存储。

游戏分数持久化

以游戏分数为例，看看如何实现状态的持久化：

export const useScore = create( persist<{ score: { current: number; best: number; total: number; last: number | null; isBest: boolean; }; // ...方法定义 }>( (set) => ({ score: { current: 0, best: 0, total: 0, last: null, isBest: false, }, // ...方法实现 }), { name: "useScore", // 唯一名称 storage: createJSONStorage(() => LocalStorageObj), } ) );

通过这种方式，游戏分数会自动持久化到SQLite存储中，即使应用重启，玩家的最佳分数和总分数也不会丢失。

多平台存储策略

Pillar Valley作为跨平台游戏，针对不同平台的特性实现了差异化的存储策略。

iOS平台存储适配

在iOS平台上，游戏利用了Apple的Settings API和应用组功能，实现了与系统设置和 widgets 的数据共享：

storage: createJSONStorage(() => { return { getItem(name) { if (process.env.EXPO_OS === "ios") { return JSON.stringify({ state: { enabled: Boolean(Settings.get(name)) }, version: 0, }); } else { return localStorage.getItem(name); } }, // ...其他方法 }; })

这种实现使得游戏设置可以与iOS系统设置同步，提升了用户体验。

跨平台兼容性

通过前面介绍的localStorage兼容层，Pillar Valley实现了真正的跨平台存储兼容。无论是在iOS、Android还是Web平台，开发人员都可以使用统一的API进行数据操作，大大简化了跨平台开发的复杂性。

关键数据类型与存储方案

Pillar Valley中不同类型的数据采用了不同的存储策略，以确保最佳的性能和用户体验。

游戏进度数据

游戏进度数据包括当前分数、最佳分数和总分数等，这些数据通过useScore状态钩子进行管理，并自动持久化：

// 分数更新逻辑 incrementScore: () => set((state) => { const nextScore = state.score.current + 1; return { ...state, score: { ...state.score, current: nextScore, best: Math.max(nextScore, state.score.best), isBest: nextScore > state.score.best, }, }; }),

成就数据

游戏成就数据通过useAchievements状态钩子管理，同样采用自动持久化：

export const useAchievements = create( persist<{ achievements: Record<string, true>; resetAchievements(): void; setAchievements(val: Record<string, true>): void; unlock(key: string): void; }>( (set) => ({ achievements: {}, // ...方法实现 }), { name: "useAchievements", storage: createJSONStorage(() => LocalStorageObj), } ) );

设置数据

游戏设置数据，如音频开关状态，通过useGlobalAudio状态钩子管理，并根据平台特性选择合适的存储方式：

export const useGlobalAudio = create( persist<{ enabled: boolean; toggleMuted(): void; _syncEnabled(enabled: boolean): void; }>( (set) => ({ enabled: true, _syncEnabled: (enabled) => set((state) => ({ ...state, enabled })), toggleMuted: () => set((state) => { logEvent("toggle_music", { on: state.enabled }); return { ...state, enabled: !state.enabled }; }), }), { name: "p_inapp_audio", storage: createJSONStorage(() => { // ...平台特定存储实现 }), } ) );

数据持久化最佳实践

Pillar Valley的实现展示了游戏数据持久化的一些最佳实践，值得其他游戏开发者借鉴。

分层存储架构

通过将存储系统分为底层SQLite存储、中间层localStorage兼容层和上层状态管理层，Pillar Valley实现了关注点分离，使得每一层都可以独立演化和优化。

自动持久化

利用Zustand的persist中间件，实现了状态的自动持久化，减少了手动数据保存的代码，降低了出错风险。

平台适配

针对不同平台的特性进行存储策略优化，如iOS平台的设置同步和应用组功能，提升了整体用户体验。

数据安全

虽然SQLite本身提供了一定的数据安全保障，但对于敏感数据，还可以考虑加密存储。Pillar Valley的实现为后续的安全增强提供了良好的基础。

总结

Pillar Valley通过结合SQLite和本地存储技术，实现了高效、可靠的游戏数据持久化系统。这一系统不仅满足了跨平台游戏的需求，还为玩家提供了一致的数据体验，确保游戏进度、成就和设置在不同设备和会话之间得以保留。

项目的实现展示了如何将成熟的Web API（如localStorage）与原生存储技术（如SQLite）相结合，创造出既易于开发又高效可靠的存储解决方案。这种方法不仅适用于游戏开发，也可以广泛应用于其他需要持久化数据的跨平台应用开发中。

通过学习Pillar Valley的数据持久化实现，开发者可以更好地理解如何为自己的应用设计和实现高效的存储系统，提升应用的整体质量和用户体验。

【免费下载链接】pillar-valley👾A cross-platform video game built with Expo and three.js项目地址: https://gitcode.com/gh_mirrors/pi/pillar-valley