unity Newtonsoft

### 如何在 Unity 中集成和使用 Newtonsoft Json.NET 库

#### 安装 NewtonSoft.Json-for-Unity

为了能够在 Unity 项目中利用高性能 JSON 处理功能，推荐通过 Unity Package Manager 来安装适用于 Unity 的 Newtonsoft.Json 版本[^1]。

打开 Unity 编辑器中的 `Window` -> `Package Manager`，点击左上角的 `+` 号并选择 `Add package from git URL...` 输入官方提供的 Git 地址完成安装过程。这一步骤确保了所使用的库已经针对 IL2CPP 构建进行了必要的调整和支持。

#### 使用示例

一旦成功集成了该库，在 C# 脚本里可以通过如下方式来实现对象到 JSON 字符串以及相反方向上的转换：

using Newtonsoft.Json;

public class ExampleUsage : MonoBehaviour {
    void Start() {
        // 创建一个简单的类实例用于演示
        var playerData = new Player { Name = "Alice", Level = 5 };

        // 将对象序列化为 JSON 字符串
        string jsonString = JsonConvert.SerializeObject(playerData);
        Debug.Log($"Serialized Data: {jsonString}");

        // 假设我们接收到上述字符串形式的数据...
        string receivedJson = "{\"Name\":\"Alice\",\"Level\":5}";

        // ...可以很容易地将其反序列化回原生的对象表示
        Player deserializedPlayer = JsonConvert.DeserializeObject<Player>(receivedJson);
        Debug.Log($"Deserialized Player's name is {deserializedPlayer.Name}");
    }
}

// 这是一个简单玩家数据模型的例子
[System.Serializable]
public class Player {
    public string Name;
    public int Level;
}

这段代码展示了如何定义一个可被轻松序列化的类，并且提供了基本的操作方法：将复杂类型转化为易于存储或传输的形式（即 JSON），然后再恢复成原来的状态[^3]。