unity3D怎么将Excel表格导入

Unity3D 怎么将 Excel 表格导入

要将 Excel 表格导入 Unity3D，可以通过以下方法：使用插件、利用 CSV 格式、编写自定义脚本。 使用插件是最为高效的方法，特别是像 Unity Asset Store 上的 Excel 导入插件，可以大大简化过程。接下来，我们将详细介绍如何通过这三种方法将 Excel 表格导入 Unity3D。

一、使用插件

1.1 Excel导入插件介绍

Unity Asset Store 上有许多插件可以帮助你将 Excel 表格导入到 Unity3D 项目中，如 Excel4Unity、SimpleExcel 和 ExcelDataReader。这些插件通常提供现成的 API，使得导入和解析 Excel 文件变得非常简单。

1.2 安装和设置插件

以 Excel4Unity 为例，首先，你需要在 Unity Asset Store 上找到该插件并进行下载和安装。安装完成后，在你的 Unity 项目中，你会发现一个新的菜单项，通常位于 “Tools” 或 “Window” 菜单中。

1.3 导入 Excel 表格

打开插件的界面后，你可以选择你想要导入的 Excel 文件。插件通常会提供一个 GUI 界面，允许你选择文件路径并设置导入选项。选择好文件后，点击导入按钮，插件会自动解析 Excel 文件并将数据导入到 Unity 中。

1.4 处理导入的数据

导入数据后，插件通常会将数据存储在一个 ScriptableObject 或某种自定义数据结构中。你可以通过插件提供的 API 来访问这些数据。例如：

using Excel4Unity;
public class DataManager : MonoBehaviour
{
    public ExcelData excelData;
    void Start()
    {
        // 访问导入的数据
        var data = excelData.GetSheet("Sheet1");
        foreach (var row in data)
        {
            Debug.Log(row["ColumnName"]);
        }
    }
}

二、利用 CSV 格式

2.1 将 Excel 转换为 CSV

如果你不想使用插件，另一种方法是将你的 Excel 表格转换为 CSV 格式。大多数电子表格软件，如 Microsoft Excel 或 Google Sheets，都支持将文件导出为 CSV 格式。点击 “文件” -> “另存为” 或 “导出”，然后选择 CSV 作为文件格式。

2.2 读取 CSV 文件

在 Unity 中，你可以使用 C# 内置的文件读取功能来读取 CSV 文件。以下是一个简单的例子，演示如何读取 CSV 文件并解析其内容：

using System;
using System.IO;
using UnityEngine;
public class CSVReader : MonoBehaviour
{
    public TextAsset csvFile;
    void Start()
    {
        string[] lines = csvFile.text.Split(new char[] { 'n' });
        foreach (string line in lines)
        {
            string[] fields = line.Split(new char[] { ',' });
            foreach (string field in fields)
            {
                Debug.Log(field);
            }
        }
    }
}

2.3 处理 CSV 数据

将 CSV 数据读取到 Unity 后，你可以根据需要将其转换为适当的数据结构。以下是一个示例，展示如何将 CSV 数据解析为一个列表：

using System;
using System.Collections.Generic;
using UnityEngine;
public class CSVDataManager : MonoBehaviour
{
    public TextAsset csvFile;
    void Start()
    {
        List<Dictionary<string, string>> csvData = ParseCSV(csvFile.text);
        foreach (var row in csvData)
        {
            Debug.Log(row["ColumnName"]);
        }
    }
    List<Dictionary<string, string>> ParseCSV(string csvText)
    {
        string[] lines = csvText.Split(new char[] { 'n' });
        string[] headers = lines[0].Split(new char[] { ',' });
        List<Dictionary<string, string>> csvData = new List<Dictionary<string, string>>();
        for (int i = 1; i < lines.Length; i++)
        {
            string[] fields = lines[i].Split(new char[] { ',' });
            Dictionary<string, string> row = new Dictionary<string, string>();
            for (int j = 0; j < headers.Length; j++)
            {
                row[headers[j]] = fields[j];
            }
            csvData.Add(row);
        }
        return csvData;
    }
}

三、编写自定义脚本

3.1 使用 OpenXML 读取 Excel 文件

如果你需要更复杂的功能或者你不想依赖第三方插件，你可以使用 OpenXML SDK 来读取 Excel 文件。OpenXML 是 Microsoft 提供的一个用于处理 Office 文档的 SDK。

3.2 设置 OpenXML SDK

首先，你需要在你的 Unity 项目中添加 OpenXML SDK 的 NuGet 包。你可以使用 NuGet for Unity 插件来简化这个过程。在 Unity 编辑器中，打开 NuGet for Unity 界面，搜索并安装 DocumentFormat.OpenXml 包。

3.3 编写读取 Excel 文件的脚本

以下是一个示例，展示如何使用 OpenXML SDK 读取 Excel 文件并将数据导入到 Unity 中：

using System;
using System.Collections.Generic;
using System.IO;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
using UnityEngine;
public class ExcelReader : MonoBehaviour
{
    public string excelFilePath;
    void Start()
    {
        List<Dictionary<string, string>> excelData = ReadExcelFile(excelFilePath);
        foreach (var row in excelData)
        {
            Debug.Log(row["ColumnName"]);
        }
    }
    List<Dictionary<string, string>> ReadExcelFile(string filePath)
    {
        List<Dictionary<string, string>> excelData = new List<Dictionary<string, string>>();
        using (SpreadsheetDocument document = SpreadsheetDocument.Open(filePath, false))
        {
            WorkbookPart workbookPart = document.WorkbookPart;
            Sheet sheet = workbookPart.Workbook.Sheets.GetFirstChild<Sheet>();
            WorksheetPart worksheetPart = (WorksheetPart)workbookPart.GetPartById(sheet.Id);
            SheetData sheetData = worksheetPart.Worksheet.GetFirstChild<SheetData>();
            string[] headers = null;
            foreach (Row row in sheetData.Elements<Row>())
            {
                if (headers == null)
                {
                    headers = new string[row.Elements<Cell>().Count];
                    int columnIndex = 0;
                    foreach (Cell cell in row.Elements<Cell>())
                    {
                        headers[columnIndex++] = GetCellValue(document, cell);
                    }
                }
                else
                {
                    Dictionary<string, string> rowData = new Dictionary<string, string>();
                    int columnIndex = 0;
                    foreach (Cell cell in row.Elements<Cell>())
                    {
                        rowData[headers[columnIndex++]] = GetCellValue(document, cell);
                    }
                    excelData.Add(rowData);
                }
            }
        }
        return excelData;
    }
    string GetCellValue(SpreadsheetDocument document, Cell cell)
    {
        string value = cell.CellValue.InnerText;
        if (cell.DataType != null && cell.DataType.Value == CellValues.SharedString)
        {
            return document.WorkbookPart.SharedStringTablePart.SharedStringTable.ChildElements[Int32.Parse(value)].InnerText;
        }
        return value;
    }
}

以上代码展示了如何使用 OpenXML SDK 读取 Excel 文件并解析其内容。你可以根据需要进一步处理这些数据，例如将其转换为 Unity 中的自定义数据结构。

四、总结

将 Excel 表格导入 Unity3D 有多种方法，包括使用插件、利用 CSV 格式、编写自定义脚本等。使用插件是最为高效的方法，可以大大简化导入过程；利用 CSV 格式 则适用于简单的数据表；编写自定义脚本 则提供了最大的灵活性，可以满足更复杂的需求。通过以上方法，你可以轻松地将 Excel 数据导入到 Unity3D 中，并在游戏开发中充分利用这些数据。