如何将ASP.NET MVC模型类添加至Unity 2D项目？

1. 提取并精简模型类代码 #

从你的ASP.NET MVC项目里把目标模型类（比如PlayerAccount、GameSession这类）的核心代码复制出来，移除MVC专属的特性（像[Required]、[Display]、[Bind]这些Unity用不上的注解），只保留数据字段、构造函数和必要的属性访问器。

示例：
ASP.NET MVC原模型：

using System.ComponentModel.DataAnnotations;

public class PlayerAccount
{
    [Key]
    public int Id { get; set; }
    
    [Required]
    [MaxLength(50)]
    public string Username { get; set; }
    
    [Required]
    public int Level { get; set; }
    
    public DateTime LastLogin { get; set; }
}

Unity适配后版本：

using System;

[System.Serializable] // 关键：添加Unity序列化特性
public class PlayerAccount
{
    public int Id;
    public string Username;
    public int Level;
    public DateTime LastLogin;

    // 可选：添加空构造函数，避免序列化问题
    public PlayerAccount() {}
}

2. 适配Unity序列化规则 #

• 给所有模型类加上[System.Serializable]特性，这样Unity的序列化工具才能正确处理对象。
• 如果模型包含嵌套类（比如PlayerAccount里有PlayerStats子对象），嵌套类也必须加[System.Serializable]。
• 若需要私有字段被序列化，给字段加[SerializeField]特性，同时保持字段名和API返回的JSON键一致。

3. 实现JSON序列化/反序列化 #

Unity中常用两种方案处理API交互的JSON：

方案一：Unity内置JsonUtility

适合结构简单的模型，性能较好，但对复杂类型（比如字典、泛型集合）支持有限：

// 解析API返回的JSON字符串到模型实例
string apiResponseJson = "{\"Id\":1,\"Username\":\"Player1\",\"Level\":10,\"LastLogin\":\"2024-05-20T14:30:00\"}";
PlayerAccount player = JsonUtility.FromJson<PlayerAccount>(apiResponseJson);

// 将模型实例序列化为JSON字符串（用于发送给API）
string postData = JsonUtility.ToJson(player);

方案二：Newtonsoft.Json（更灵活）

如果模型包含复杂结构，建议导入Newtonsoft.Json for Unity包（Unity Package Manager里可搜索安装），支持更多序列化场景：

using Newtonsoft.Json;

// 解析JSON
PlayerAccount player = JsonConvert.DeserializeObject<PlayerAccount>(apiResponseJson);

// 序列化模型
string postData = JsonConvert.SerializeObject(player);

4. 集成到API调用流程 #

在你的Unity API请求脚本中，把反序列化后的模型实例直接用于游戏逻辑：

public IEnumerator FetchPlayerData(string userId)
{
    string apiUrl = $"https://your-api-url.com/api/players/{userId}";
    using (UnityWebRequest webRequest = UnityWebRequest.Get(apiUrl))
    {
        yield return webRequest.SendWebRequest();

        if (webRequest.result == UnityWebRequest.Result.Success)
        {
            string json = webRequest.downloadHandler.text;
            PlayerAccount player = JsonUtility.FromJson<PlayerAccount>(json);
            
            // 用模型数据更新游戏UI或状态
            Debug.Log($"Loaded player: {player.Username}, Level: {player.Level}");
        }
        else
        {
            Debug.LogError("API request failed: " + webRequest.error);
        }
    }
}

5. 关键注意事项 #

• 模型类的字段名必须和API返回的JSON键完全匹配（大小写敏感），如果需要映射不同名称，用Newtonsoft的[JsonProperty]特性：

  [JsonProperty("user_name")]
  public string Username;
  

• 不要在模型类中保留ASP.NET MVC的业务逻辑（比如数据库操作、验证逻辑），模型只做数据载体。
• 测试时先打印API返回的JSON字符串，确认结构和模型字段完全对应，避免解析失败。

内容的提问来源于stack exchange，提问作者whyme