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

Unity从2018.1版本开始，可以采用内置JSON进行存档和读档

article 2024/9/20 16:12:39

在Unity中，将数据转换为JSON格式并存储在Application.persistentDataPath路径下，是一个常见的需求，用于保存游戏设置、玩家进度等数据。以下是一个简单的步骤和示例代码，展示如何实现这一过程：

那么UnityEngine类下面的JsonUtility类是干啥的呢？
答：UnityEngine 类下的 JsonUtility 类是 Unity 提供的一个用于处理 JSON 数据序列化和反序列化的工具。它简化了将数据对象转换为 JSON 字符串以及将 JSON 字符串转换回数据对象的过程。
JsonUtility 的主要特点包括：

1、简单性：它提供了一个简单直观的方式来处理 JSON 数据，无需深入了解 JSON 格式或编写复杂的解析代码。
2、内置支持：作为 Unity 引擎的一部分，JsonUtility 是内置的，无需额外安装或配置第三方库。
3、限制：然而，JsonUtility 也有其局限性。例如，它要求被序列化的类必须是可序列化的（即标记为 [Serializable]），并且所有字段都必须是 public 的或者通过 [SerializeField] 属性标记为可序列化的。此外，它不支持某些高级特性，如继承、接口、字典、集合（除了 List 和 Dictionary<string, T>，但后者有额外的限制和复杂性）等。
4、性能：由于它是 Unity 引擎的一部分，JsonUtility 被设计为与 Unity 的性能要求相匹配，尽管在处理大型或复杂的 JSON 数据时，其性能可能不如一些专门的 JSON 库。

步骤 1: 引入JSON库

1、Unity从2018.1版本开始，内置了对JSON的支持，通过JsonUtility类可以轻松地将对象序列化为JSON字符串，以及从JSON字符串反序列化为对象。但是，请注意JsonUtility有一些限制，比如它要求你的类有默认的构造函数，并且所有字段都必须是public的或者标记为[SerializeField]。
如果你的需求超出了JsonUtility的能力范围，你可以考虑使用更强大的库，如Newtonsoft.Json（也称为Json.NET）。这需要在Unity项目中通过NuGet或Unity的Package Manager安装。
2、使用 JsonUtility 时，你可以通过调用 JsonUtility.ToJson() 方法将数据对象序列化为 JSON 字符串，通过调用 JsonUtility.FromJson() 方法将 JSON 字符串反序列化为数据对象。以下步骤2跟步骤3就是一个简单的例子：

步骤 2:数据对象转换为JSON格式的完整示例

using System;
using System.IO;
using UnityEngine;

// 如果使用JsonUtility，需要这个标记
[Serializable]
public class UserData
{
    public string UserName;
    public int Level;
    // 可以添加更多字段  
}

public class JsonDemo : MonoBehaviour
{
    void Start()
    {
        // 假设这是你从某处获取或创建的UserData实例  
        UserData userData = new UserData { UserName = "Player2", Level = 13 };

        // 序列化UserData实例为JSON字符串  
        string jsonString = JsonUtility.ToJson(userData);

        // 构建文件路径  
        string filePath = Path.Combine(Application.persistentDataPath, "userPlayerData.json");

        // 使用StreamWriter写入文件，如果文件不存在，则会自动创建  
        using (StreamWriter writer = new StreamWriter(filePath)) {
            writer.Write(jsonString);
        }

        // 输出确认信息  
        Debug.Log("数据已保存到: " + filePath);
    }
}

步骤 3:JSON格式转换为数据对象的完整示例

在Unity中，当你把一个数据转换成JSON格式并存储在Application.persistentDataPath路径下的文件后，你可能需要在之后的某个时刻将这个JSON文件转换回对应的对象。这通常涉及到从文件中读取JSON字符串，然后使用某种方式将其反序列化为原始对象类型。

Unity自带的JsonUtility类可以用于这个目的，但它有一些限制，比如要求你的类是可序列化的（即标记为[Serializable]），并且所有字段都必须是public的或者标记为[SerializeField]的。如果你需要更复杂的JSON处理功能，比如处理嵌套对象、列表、字典等，你可能需要使用像Newtonsoft.Json（也称为Json.NET）这样的第三方库。

下面是一个使用JsonUtility将存储在Application.persistentDataPath路径下的JSON文件转换回对应对象的示例：

using System;
using System.IO;
using UnityEngine;

[Serializable]
public class UserData
{
    public string UserName;
    public int Level;
    // 可以添加更多字段  
}

public class JsonDemo : MonoBehaviour
{
    void Start()
    {
        // 构建文件路径  
        string filePath = Path.Combine(Application.persistentDataPath, "userPlayerData.json");

        // 读取文件内容  
        string jsonString = File.ReadAllText(filePath);

        // 反序列化JSON字符串为UserData对象  
        UserData userData = JsonUtility.FromJson<UserData>(jsonString);

        // 现在你可以使用userData对象了  
        Debug.Log("用户名: " + userData.UserName + ", 等级: " + userData.Level);
    }
}

注意事项

1、确保你的项目有写入Application.persistentDataPath的权限。在大多数平台上，这是默认的存储位置，用于存储用户数据。
2、如果你的项目需要在不同平台之间同步数据，请考虑数据格式和存储位置的兼容性。
3、使用Newtonsoft.Json可能需要一些额外的配置，比如通过NuGet或Unity Package Manager安装。但是，它提供了更多的灵活性和功能，特别是在处理复杂数据结构时。
4、请注意，由于 JsonUtility 的限制，你可能需要根据你的具体需求考虑是否使用它。如果你的项目需要处理复杂的 JSON 数据或需要利用一些 JsonUtility 不支持的特性，你可能需要考虑使用像 Newtonsoft.Json（Json.NET）这样的第三方库。

查看全文

http://www.kler.cn/news/310038.html