SaveGameFree 跨平台存档开发：Android、iOS、PC 一次搞定

SaveGameFree 跨平台存档开发：Android、iOS、PC 一次搞定

【免费下载链接】SaveGameFreeSave Game Free is a free and simple but powerful solution for saving and loading game data in unity.项目地址: https://gitcode.com/gh_mirrors/sa/SaveGameFree

为什么 Unity 开发者都需要一个跨平台存档方案？

在 Unity 游戏开发中，跨平台存档一直是让新手头疼的痛点：Android 的沙盒路径、iOS 的沙盒限制、PC 的不同系统目录，每个平台都要单独处理。SaveGameFree 正是一款免费开源的 Unity 游戏存档插件，它用一套统一的 API 帮你解决 Android、iOS、PC 乃至 WebGL 的存档读写问题。无论你是刚入门的新手还是资深开发者，都能在几分钟内集成，真正做到"一次编写，全平台运行"。

SaveGameFree 跨平台存档插件宣传图，展示其跨平台、云存储与加密三大核心能力

快速上手：Unity 存档三行代码搞定

SaveGameFree 的核心 API 极其简洁，存档和读档各只需一行代码。在任意脚本中引入命名空间即可使用：

using Bayat.Unity.SaveGameFree; // 保存游戏数据 SaveGame.Save<int>("score", score); // 读取游戏数据（带默认值） score = SaveGame.Load<int>("score", 0);

核心实现位于 Runtime/SaveGame.cs，默认使用PersistentDataPath（各平台的标准持久化目录），完全无需手动拼接路径。

跨平台存档路径自动适配

SaveGameFree 内置了平台路径自动适配机制，通过 SaveGamePath 枚举管理三种存储位置：

• PersistentDataPath（推荐）：Android 的 app 私有目录、iOS 的 Documents、PC 的用户数据目录，系统自动处理
• DataPath：项目数据目录
• Custom：自定义路径

在 Android 与 iOS 上，系统沙盒机制严格，手动写路径极易出错；SaveGameFree 直接对接 Unity 的Application.persistentDataPath，让跨平台存档零成本落地。

三种序列化格式自由切换

针对不同的游戏类型，SaveGameFree 支持 JSON、XML、Binary 三种存档序列化格式，且可随时切换，无需改动业务代码：

对应实现可在 Runtime/Serializers/ 中查看，如 SaveGameJsonSerializer.cs。默认使用 JSON 序列化器，开箱即用。

存档加密：保护玩家数据安全

对排行榜分数、付费状态等敏感数据，SaveGameFree 提供存档加密功能。通过简单设置密码即可启用：

// 设置自定义密码（生产环境务必使用强密码） SaveGame.EncodePassword = "YourSecurePassword123!"; // 加密保存敏感数据 SaveGame.Save<string>("playerData", sensitiveData, encode: true); // 加密读取 var data = SaveGame.Load<string>("playerData", "", encode: true);

加密逻辑由 SaveGameSimpleEncoder.cs 实现，防止玩家直接修改本地存档文件。

自动存档：SaveGameAuto 组件零代码使用

如果你只想保存物体的位置、旋转和缩放，SaveGameFree 提供了自动存档组件SaveGameAuto。只需在场景中给物体挂载该组件（源码见 Runtime/SaveGameAuto.cs），设置好标识符，即可自动保存 Transform 数据，无需编写任何代码。

同时，项目还内置了多种常用数据类型支持，包括 Vector2/3/4、Quaternion、Color、Mesh 等（见 Runtime/Types/），处理坐标、颜色等复杂数据更加便捷。

异步存档：避免卡顿的最佳实践

大体积存档在读写时可能造成主线程卡顿。SaveGameFree 支持Async/Await 异步存档，推荐在保存大型存档时使用：

async void OnApplicationQuit() { await SaveGame.SaveAsync<int>("score", score); }

异步方法完全镜像同步 API，迁移成本极低，能显著提升游戏流畅度。

WebGL 与网页存档支持

针对 WebGL 平台，SaveGameFree 还提供了 SaveGameWeb.cs，支持将存档上传到远程服务器，实现云端存档与跨设备同步——玩家在手机上保存的进度，在 PC 上可以无缝继续。

快速集成：从零开始配置

1. 获取插件：在 Unity 中通过 Package Manager 导入 SaveGameFree 包（支持 UPM 结构，清单见 package.json）
2. 创建脚本：新建 MonoBehaviour 脚本，引入Bayat.Unity.SaveGameFree命名空间
3. 调用 API：按上文示例调用Save/Load即可完成 Unity 存档开发

项目自带完整示例场景与文档，位于 Samples~ 目录，包含位置、旋转、缩放、自定义对象与 Web 存档等案例，参考 ExampleSavePosition.cs 即可快速理解完整用法。

结语

SaveGameFree 作为一款免费开源的 Unity 游戏存档插件，用极低的学习成本换来了跨平台、加密、异步、自动存档等完整能力。无论你正在开发 Android、iOS 还是 PC 游戏，它都能让存档功能"一次搞定"。下一次遇到存档需求，不妨直接试试它。

【免费下载链接】SaveGameFreeSave Game Free is a free and simple but powerful solution for saving and loading game data in unity.项目地址: https://gitcode.com/gh_mirrors/sa/SaveGameFree