当前位置：首页 > news >正文

Unity 二进制读写小框架

news 2025/8/22 6:30:34

文章目录

- 前言
- 框架获取与集成
- 使用方法
- - 基本配置
  - 自动生成序列化方法
- 实战示例
- 技术原理与优势
- - 二进制序列化的优势
  - SJBinary的设计特点
- 最佳实践建议
- 适用场景
- 总结

前言

在Unity开发过程中，与后台交互时经常需要处理大型数据文件。当遇到一个近2MB的本地JSON文件需要解析为对象时，使用传统的JSON解析方案（无论是Unity自带的JsonUtility还是流行的Newtonsoft Json.NET）都面临着显著的性能瓶颈。在实测中，这些方案解析时间可能长达3秒以上，即使经过优化也需要约1.5秒，同时还伴随着大量的GC（垃圾回收）开销。

针对这一问题，我们开发了一个高性能的二进制序列化框架——SJBinary。经过测试，该框架在性能表现上超越了市面上多数JSON框架和Unity自带的BinaryFormatter，接近Protobuf-net的性能水平，虽然略低于MessagePack，但其集成简单、代码量小的特点使其成为Unity项目中数据序列化的优秀选择。

实测数据显示，使用SJBinary创建10万个对象并序列化为二进制数据仅需480多毫秒，反序列化过程仅需340多毫秒，性能提升显著。
提示：二进制数据处理本质上比JSON处理更加高效，因为它避免了文本解析的复杂过程，直接使用二进制格式表示数据。

框架获取与集成

sjgenerate下载链接
1.点击上面链接即可下载
2.下载完后将SjBinary拖入项目即可
3.定义类并添加注解[SJBinary]及实现接口ISJSerializable

使用方法

基本配置


[SJBinary]
public class A : ISJSerializable
{public string name;public int age;public void Deserialize(SJBinaryReader reader){throw new System.NotImplementedException();}public void Serialize(SJBinaryWriter writer){throw new System.NotImplementedException();}
}

自动生成序列化方法

点击Unity顶部菜单栏：Tools -> SJBinary -> Generate Methods
系统将自动实现Deserialize和Serialize方法

生成的类结构如下：

[SJBinary]
public class B : ISJSerializable
{public string name;public int age;public void Serialize(SJBinaryWriter writer){writer.Write(this.name);writer.Write(this.age);}public void Deserialize(SJBinaryReader reader){this.name = reader.ReadString();this.age = reader.ReadInt32();}
}

实战示例

以下是一个完整的使用示例，展示了如何在Unity中使用SJBinary进行高效序列化和反序列化：

public class ErJinZhiSample : MonoBehaviour
{//优化前497 343msprivate List<byte[]> serializedData = new List<byte[]>();public List<TestA> deserializedObjects = new List<TestA>();private const int count = 100000;public Button btnLoad;public Button btnCreate;// 复用的 readerprivate SJBinaryReader reader;void Start(){btnLoad.onClick.AddListener(TestLoad);btnCreate.onClick.AddListener(TestCreate);}void TestCreate(){serializedData.Clear();var writer = new SJBinary.SJBinaryWriter(1024); // 可复用缓冲区Stopwatch sw = Stopwatch.StartNew();for (int i = 0; i < count; i++){writer.Reset(); // 复用缓冲区TestA obj = new TestA{age = i,name = $"Name_{i}",time = DateTime.Now.Ticks,actions = "Run,Jump",actionsList = new List<string> { "Run", "Jump", "Walk" },ids = new List<int> { 1, 2, 3 },pads = new List<int> { 10, 20, 30 }};obj.Serialize(writer);// 保存二进制数据（注意这里保存的是 ArraySegment 以避免复制）serializedData.Add(writer.GetBytes());}sw.Stop();UnityEngine.Debug.Log($"[Create] Created and serialized {count} objects in {sw.ElapsedMilliseconds} ms");}void TestLoad(){deserializedObjects.Clear();Stopwatch sw = Stopwatch.StartNew();for (int i = 0; i < count; i++){byte[] data = serializedData[i];// 复用 readerif (reader == null)reader = new SJBinary.SJBinaryReader(data);elsereader.SetBuffer(data, 0, data.Length);TestA obj = new TestA();obj.Deserialize(reader);deserializedObjects.Add(obj);}sw.Stop();UnityEngine.Debug.Log($"[Load] Deserialized {count} objects in {sw.ElapsedMilliseconds} ms");}
}