这段代码的结构是为了实现 数据的封装和管理,特别是在 Unity 中保存和加载玩家数据时。以下是对代码设计的逐步解释:
1. PlayerCoin 类
PlayerCoin 是一个简单的数据类,用于表示单个玩家的硬币信息。它包含以下字段:
-
count:玩家拥有的硬币数量。 -
name:玩家的名字。 -
isWinner:表示玩家是否获胜。
-
[System.Serializable]:这个属性告诉 Unity 这个类可以被序列化(即将其数据转换为 JSON 或其他格式)。这是 Unity 中保存数据的必要步骤。
2. PlayerCoinList 类
PlayerCoinList 是一个容器类,用于管理多个 PlayerCoin 对象。它包含一个 List<PlayerCoin>,用于存储玩家数据。
-
List<PlayerCoin>:这是一个动态数组,可以存储任意数量的PlayerCoin对象。 -
[System.Serializable]:同样需要这个属性,因为 Unity 需要将整个PlayerCoinList对象序列化为 JSON。
3. DataSaveManager 类
DataSaveManager 是一个 Unity 的 MonoBehaviour,用于管理数据的保存和加载。它包含一个 PlayerCoinList 对象,用于存储和操作玩家数据。
-
MonoBehaviour:这是 Unity 中所有脚本的基类,允许脚本附加到游戏对象上。 -
PlayerCoinList list:这是一个实例化的PlayerCoinList对象,用于存储玩家数据。
为什么这样设计?
1. 数据封装
-
PlayerCoin:表示单个玩家的数据。 -
PlayerCoinList:表示多个玩家的数据集合。 -
DataSaveManager:负责管理这些数据的保存和加载。
这种分层设计的好处是:
-
数据结构清晰,易于扩展。
-
每个类都有明确的职责,代码更易于维护。
2. 序列化的需求
Unity 的 JsonUtility 类只能序列化带有 [System.Serializable] 属性的类。因此:
-
PlayerCoin和PlayerCoinList都需要标记为[System.Serializable]。 -
PlayerCoinList是一个“根对象”,因为JsonUtility需要一个根对象来序列化整个数据结构。
3. Unity 的 JSON 限制
Unity 的 JsonUtility 不能直接序列化 List<T> 或数组,因此需要将 List<PlayerCoin> 包装在一个类(如 PlayerCoinList)中,作为序列化的根对象。
using UnityEngine;
using System.Collections.Generic;
using System.IO;[System.Serializable]
public class PlayerCoin
{public int count;public string name;public bool isWinner;
}[System.Serializable]
public class PlayerCoinList
{public List<PlayerCoin> playerCoinList = new List<PlayerCoin>();
}public class DataSaveManager : MonoBehaviour
{public PlayerCoinList list = new PlayerCoinList();void Start(){// 添加示例数据PlayerCoin player1 = new PlayerCoin();player1.count = 100;player1.name = "Player1";player1.isWinner = true;PlayerCoin player2 = new PlayerCoin();player2.count = 50;player2.name = "Player2";player2.isWinner = false;list.playerCoinList.Add(player1);list.playerCoinList.Add(player2);// 保存数据SaveData();// 加载数据LoadData();}void SaveData(){// 将对象序列化为 JSONstring json = JsonUtility.ToJson(list);// 将 JSON 数据写入文件string filePath = Application.persistentDataPath + "/playerData.json";File.WriteAllText(filePath, json);Debug.Log("Data saved to: " + filePath);}void LoadData(){string filePath = Application.persistentDataPath + "/playerData.json";// 检查文件是否存在if (File.Exists(filePath)){// 读取 JSON 数据string json = File.ReadAllText(filePath);// 反序列化 JSON 数据list = JsonUtility.FromJson<PlayerCoinList>(json);Debug.Log("Data loaded from: " + filePath);}else{Debug.Log("File not found: " + filePath);}}
}