SaveGameFree 扩展开发：自定义序列化器与编码器的完整教程

SaveGameFree 扩展开发自定义序列化器与编码器的完整教程【免费下载链接】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/SaveGameFreeSaveGameFree 是一款免费、简单却功能强大的 Unity 游戏存档插件内置了 JSON、XML、二进制三种序列化器以及支持密码加密的默认编码器。本教程将带你从零开始完成 SaveGameFree 扩展开发学会如何编写自定义序列化器与编码器让存档格式和加密方式完全由你掌控。无论你是刚接触 Unity 存档的新手还是需要定制存档方案的进阶开发者这份完整教程都能帮你快速上手。SaveGameFree 自定义序列化器与编码器扩展开发教程配图SaveGameFree 扩展开发前先搞懂两个核心概念 在动手写代码之前我们需要先理解 SaveGameFree 的存档流水线序列化器Serializer负责把对象变成字节流编码器Encoder负责对字节流做二次加密处理。两者职责分离互不干扰这正是 SaveGameFree 扩展开发如此灵活的根本原因。序列化器决定存档的格式例如 JSON 可读性好、XML 结构化强、二进制体积小。编码器决定存档是否加密例如内置的简单编码器基于 AES 算法需要密码才能还原。这套设计让你可以单独替换其中任何一个环节而完全不影响 SaveGame 主 API 的使用方式。快速认识扩展开发依赖的两个核心接口SaveGameFree 扩展开发的第一步是熟悉它暴露给开发者的两个接口所有自定义实现都从实现这两个接口开始。第一步了解 ISaveGameSerializer 序列化器接口接口定义位于 ISaveGameSerializer.cs只有两个方法public interface ISaveGameSerializer { void SerializeT(T obj, Stream stream, Encoding encoding); T DeserializeT(Stream stream, Encoding encoding); }Serialize负责把对象写入流Deserialize负责从流中还原对象泛型 T 让它可以处理任意数据类型。第二步了解 ISaveGameEncoder 编码器接口编码器接口位于 ISaveGameEncoder.cs同样只有两个方法public interface ISaveGameEncoder { string Encode(string input, string password); string Decode(string input, string password); }方法签名中的password参数正是 SaveGameFree 存档加密时使用的密钥。如何编写自定义序列化器三步实现法 ✅下面我们用一个最简单的示例演示如何编写自定义序列化器实现自定义 Unity 存档格式。第 1 步继承 ISaveGameSerializer 接口新建一个类并实现接口这里以CSV 逗号分隔格式为例using System.IO; using System.Text; using Bayat.Unity.SaveGameFree.Serializers; public class SaveGameCsvSerializer : ISaveGameSerializer { public void SerializeT(T obj, Stream stream, Encoding encoding) { // 把对象转换成 CSV 字符串并写入流 } public T DeserializeT(Stream stream, Encoding encoding) { // 从流中读取 CSV 并还原对象 return default; } }如果你想参考官方实现可以对照 SaveGameJsonSerializer.cs、SaveGameXmlSerializer.cs 和 SaveGameBinarySerializer.cs 这三个内置序列化器的写法。第 2 步在序列化方法中写入你的格式逻辑在Serialize中完成对象到字节流的转换注意使用传入的encoding参数处理字符编码这样存档文件才能被正确读取。第 3 步接入 SaveGame 全局配置一键生效编写完成后把它设置给 SaveGame 的静态属性即可全局生效SaveGame.Serializer new SaveGameCsvSerializer();所有调用SaveGame.Save和SaveGame.Load的地方都会自动使用你的自定义序列化器不需要改动任何业务代码。相关属性定义可以查看 SaveGame.cs。如何编写自定义编码器实现存档加密就这么简单 自定义编码器与序列化器的流程完全一致实现ISaveGameEncoder接口后通过SaveGame.Encoder属性注入即可。using Bayat.Unity.SaveGameFree.Encoders; public class MyEncoder : ISaveGameEncoder { public string Encode(string input, string password) { // 自定义加密逻辑 return input; } public string Decode(string input, string password) { // 对应的解密逻辑 return input; } } SaveGame.Encoder new MyEncoder();如果你想了解生产级的加密实现内置的 SaveGameSimpleEncoder.cs 使用了 256 位 AES 随机盐 1000 次密钥派生迭代是非常值得学习的参考范本。运行时动态切换序列化器与编码器的技巧 SaveGameFree 扩展开发还有一个很实用的场景在游戏运行时按需切换存档格式。示例项目中的 SerializerDropdown.cs 展示了完整做法——它用下拉菜单在 XML、JSON、Binary 三种序列化器之间动态切换。同时SaveGame.Save和SaveGame.Load都提供了接受序列化器、编码器参数的重载版本你可以在单次调用中临时指定实现SaveGame.Save(player, playerData, new SaveGameXmlSerializer());这样即使全局配置不变也能对特定存档使用其他格式。Web 端存档SaveGameWeb.cs同样支持自定义序列化器与编码器桌面、移动端与 Web 的扩展开发方式完全一致。SaveGameFree 扩展开发避坑指南 ⚠️编码一致性保存与加载时必须使用相同的编码推荐统一使用Encoding.UTF8。加密配对启用了编码器加密后加载时也要传入相同密码否则会解密失败。平台差异二进制序列化器在 Windows Store / UWP 平台不受支持跨平台发布时建议使用 JSON 或自定义格式。异步操作需要异步存档时请使用SaveGame.SaveAsync/LoadAsync避免阻塞主线程。总结开始你的 SaveGameFree 扩展开发之旅 通过本教程你已经掌握了 SaveGameFree 扩展开发的核心方法实现ISaveGameSerializer和ISaveGameEncoder两个接口再通过全局属性或方法参数注入即可。整个过程仅需十几行代码却能解锁完全自定义的 Unity 存档格式与加密方案。快打开你的 Unity 工程试着写一个属于自己的自定义序列化器吧【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考