Unity內使用JSON的方式

JSON已是經典的資料格式之一了，而以前我在物聯網公司工作時，其中一項工作就是處理那一大堆的JSON資料。

那實在是整死人，因為那時的資料架構很多是沒有固定的，也就是裡面的欄位會任意增減，所以我都用原始的方式去一一檢驗裡面的架構再取得資料。

現在就輕鬆多了，資料架構都是事先固定的，故可用JSONObject一次性搞定，這邊就來記錄一下。

這邊使用的是LitJson，其他的Json也有一樣的做法。

首先是準備資料，我準備了一個JSON字串如下：

[{"name":"這是一號清單","listID":1,"listData":[{"id":1,"content":"一號內容1"},{"id":2,"content":"一號內容2"},{"id":3,"content":"一號內容3"}]},{"name":"這是二號清單","listID":2,"listData":[{"id":1,"content":"二號內容1"},{"id":2,"content":"二號內容2"},{"id":3,"content":"二號內容3"},{"id":4,"content":"二號內容4"},{"id":5,"content":"二號內容5"}]}]

使用網路上的JSON Reader可看到排版後的資料內容：

這是一個兩層Array的架構，可以有數份清單，每份清單內有數個被編號的內容。

接著當要在程式內把這字串寫出來時，需要變換符號，主要是『"』這符號必須要變更，變更方式等在網路上都找得到，這裡就不贅述。

[{\"name\":\"這是一號清單\", \"listID\":1, \"listData\":[{\"id\":1, \"content\":\"一號內容1\"},{\"id\":2,\"content\":\"一號內容2\"},{\"id\":3,\"content\":\"一號內容3\"}]},{\"name\":\"這是二號清單\",\"listID\":2,\"listData\":[{\"id\":1,\"content\":\"二號內容1\"},{\"id\":2,\"content\":\"二號內容2\"},{\"id\":3,\"content\":\"二號內容3\"},{\"id\":4,\"content\":\"二號內容4\"},{\"id\":5,\"content\":\"二號內容5\"}]}]

然後就來正式寫程式吧：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using LitJson;

public class DataController : MonoBehaviour
{
    public class DataClass
    {
        public string name;
        public int listID;
        public ListDataClass[] listData;
    }

    public class ListDataClass
    {
        public int id;
        public string content;
    }

    private string jsonContent = "[{\"name\":\"這是一號清單\", \"listID\":1, \"listData\":[{\"id\":1, \"content\":\"一號內容1\"},{\"id\":2,\"content\":\"一號內容2\"},{\"id\":3,\"content\":\"一號內容3\"}]},{\"name\":\"這是二號清單\",\"listID\":2,\"listData\":[{\"id\":1,\"content\":\"二號內容1\"},{\"id\":2,\"content\":\"二號內容2\"},{\"id\":3,\"content\":\"二號內容3\"},{\"id\":4,\"content\":\"二號內容4\"},{\"id\":5,\"content\":\"二號內容5\"}]}]";
    private JsonData jsonData;
    private List dataClassList = new List();
    private DataClass dataClass = new DataClass();

    void Start()
    {
        jsonData = JsonMapper.ToObject(jsonContent);
        Debug.Log("這是直接版的【Name】：" + jsonData[0]["name"]);
        Debug.Log("這是直接版的【一號清單內的第3項之Content】：" + jsonData[0]["listData"][2]["content"]);
        Debug.Log("------------------------------------------------------------------");

        dataClassList = JsonMapper.ToObject>(jsonContent);

        for (int i = 0; i < dataClassList.Count; i++)
        {
            dataClass = dataClassList[i];

            //Debug.Log("【" + i + "=Name" + "】：" + dataClass.name);
            //Debug.Log("【" + i + "=List ID" + "】：" + dataClass.listID);

            Debug.Log(i);
            Debug.Log("     name:" + dataClass.name);
            Debug.Log("     listID:" + dataClass.listID);
            Debug.Log("     listData");

            for (int j = 0; j < dataClass.listData.Length; j++)
            {
                //Debug.Log("【" + i + "-" + j + "=ID" + "】：" + dataClass.listData[j].id);
                //Debug.Log("【" + i + "-" + j + "=Content" + "】：" + dataClass.listData[j].content);

                Debug.Log("         " + j);
                Debug.Log("             id:" + dataClass.listData[j].id);
                Debug.Log("             content:" + dataClass.listData[j].content);
            }
        }
    }

    void Update()
    {
        if (Input.GetKeyDown(KeyCode.Space))
        {
            dataClassList[0].name = "重新取名字";

            jsonContent = JsonMapper.ToJson(dataClassList);
        }
    }
}

第8行和第15行的兩個Class，是依照JSON的兩層Array架構去宣告的，Class名稱可以任意，但是裡面的變數名稱和變數類型一定要完全和JSON的資料一樣。

第28行到第30行是展示用原本的原始方式來取資料。

第33行開始是把JSON字串轉成JSONObject，並套到之前宣告的資料模型內，這樣便可以隨心所欲地提取資料了。

第61行是展示用這種資料模型方式來儲存修改的資料，之後便可依照各自需求把修改後的JSON字串發出去。

程式裡我有弄兩種方式顯示資料，這邊只顯示其中一種，執行程式後在Unity的Console可以看得到：

在使用JSON時最麻煩的是資料被包了又包、包了又包，動輒就好幾層；因此使用這種資料模型的方式時也得去宣告相對應的Class，反而實作只需一行便可取得資料了。

Unity內C#的Event使用方式

C語言有很多實作功能我在過往寫專案時都不會使用到，就像你有一台手機但大部分的附屬功能平常不需要用到一樣，因此自然就沒也特別去注意。但以後也許會有需要用到，還是先研究一下做個記錄比較好。

會用Event的情況通常是我在和其他SDK等做整合時，都已經有那些SDK準備好的Event可直接註冊使用，因此不需要了解那些Event是怎麼生成的；而這邊記錄的是完全無中生有，包含Event的生成、註冊和使用，這樣以後就可以在自己的程式自己來了。

以下是簡單的創造一個Event並來使用：

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System;

public class ZZZ : MonoBehaviour
{
    class TypeEventArgs : EventArgs
    {
        public float x = 0;
        public float y = 0;
    }

    private event EventHandler eventHandler;
    private TypeEventArgs tempEventArgs = new TypeEventArgs();

    void Start()
    {
        this.eventHandler += ReceiveData;
    }

    void Update()
    {
        tempEventArgs.x += Time.deltaTime;
        tempEventArgs.y += 2 * Time.deltaTime;

        eventHandler(this, tempEventArgs);
    }

    public void ReceiveData(System.Object sender, EventArgs e)
    {
        Debug.Log(Mathf.FloorToInt((e as TypeEventArgs).x) + " = " + Mathf.FloorToInt((e as TypeEventArgs).y));
    }
}

我做了一個Event，然後觸發此Event的情況是每個Frame時，會顯示一個累加時間和其兩倍的時間值。因此觸發條件便可因應各種需要，例如點擊一個按鈕時、用USB連接的Arduino傳過來資料時、或是有預料之中的錯誤發生時等。就可用Event的形式來加以對應。

Unity內偵測外部資料夾內的檔案變化

有很多案子是需要為使用者留下記錄、和二次使用該記錄等，因此像是當拍下使用者的照片、為使用者製作的卡片、或是為使用者錄製的音檔等，會放置在指定的資料夾內，而其他程式會偵測那些指定資料夾內是否有新檔案出現，有的話便會拿來使用，達成一種更新的狀態。

以前我是會很笨地用List記住資料夾內的檔案，然後每幾秒便用For迴圈去比對檢查，現在有空去研究，便發現了王道方法，輕鬆且簡單。

C#有FileSystemWatcher這個Library，專門用來監視資料夾檔案狀態，因此簡單地設定和啟用，便可為程式去監聽指定的資料夾內檔案狀態。

using System.Collections;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System.IO;

public class XXX : MonoBehaviour {

    private FileSystemWatcher fileSystemWatcher;

    void Start ()
    {
        DetectFileAction();
    }
 
    void Update ()
    {
  
 }

    public void DetectFileAction()
    {
        fileSystemWatcher = new FileSystemWatcher("S:/Data/", "*.txt");

        fileSystemWatcher.Created += OnChanged;
        fileSystemWatcher.Renamed += OnChanged;
        fileSystemWatcher.Changed += OnChanged;
        fileSystemWatcher.Deleted += OnChanged;
        
        fileSystemWatcher.EnableRaisingEvents = true;
    }
    
    void OnChanged(object source, FileSystemEventArgs e)
    {
        Debug.Log("有檔案被" + e.ChangeType + " = " + e.FullPath);
    }
}

可以看到我偵測四種狀態：創造檔案、重新命名檔案、改變檔案的內容和刪除檔案。

fileSystemWatcher.EnableRaisingEvents是指啟動此程序的意思。

由上而下分別是創造檔案、重新命名檔案、改變檔案的內容和刪除檔案時所出現的相對應訊息，這邊特地列出是為了表明有些時候做某個動作，所得到的回饋會不只一個。

最後有一個很重要的是，如果是較大的檔案，最好不要接收到訊息便立即拿來使用。例如我用Web攝影機錄製了一段使用者的影像，並且將影片儲存到某個資料夾內；雖然其他的程式會立刻接收到Created的訊息，但是檔案實際上可能還沒有創建完成，所以若立即取得並播放的話很可能是白色畫面，因此我都會等一兩秒後再來處理。