[Unity] 使用內建的JsonUtility 遊戲讀存檔案 --2017.11.20更新

大部分遊戲都會使用到「讀取」、「儲存」狀態與進度，本篇 「Unity 範例檔」示範如何使用Unity內建的 JsonUtility  進行 Json 檔案的讀存取。

JSON檔案的維基百科
P.S 話說JSON的ICON也太帥氣了 >////<
P.S 我在google上面打上『Unity Json 教學』，出來結果都是額外用 LitJSON  這個三年沒更新的插件了...那個沒有內建的速度快而且可能會有些問題...。2017.05.11

P.S 跟各位致歉，剛才發現我提供的教學檔是舊的，裡面並沒有套入Load部份 2017.05.11
P.S 我緊急將教學檔先做更新，網誌內容稍後會在調整。 2017.05.11

有網友回覆說專案建置後Json檔案不會建置出來 @@ 
我上網查了一下... 改將 Json檔案放置到 Assets/StreamingAssets
就可以解決這問題~ 但是缺點是這檔案就是完全沒有被封裝起來，
因此使用者可以很簡單的就用文字編輯器改資料了'  2017.09.24

網友再度表示第二版的做法放在PC沒問題，但是輸出成APK就無法作用了!@@
Google 大神再度引領我找到解答： Application.persistentDataPath
使用persistenDataPath的範例檔案我放在下面2017.11.20版了。







[教學檔下載]

連結 2017.09.24 版本 (新版本) (2021.10.12更新連結)


[狀態存檔]

1. 假設我們現在要存檔下面五項資料
• 玩家名稱，sammaru 
• 玩家等級，87級
• 玩家所處座標，X:33，Y:0，Z:33
2. 這三項資料的變數型態剛好都是不同變數類型： 

3. string playerName;   //玩家名稱，sammaru
   int level;           //玩家等級，87級
   vector3 postion;     //玩家座標，vector3(0,0,500)

4. 為了讓檔案JsonUtility可以讀存這些檔案，
   我們需要建立一個class來承接資訊：
   

       public class playerState
       {
           public string name;
           public int level;
           public Vector3 pos;
       }

5. 接下來我們在save程式片段內，建立一個playerState類型的資料「myPlayer」，
   並且將資料寫入myPlayer：
   

       public void save()
       {
           //填寫jplayerState格式的資料..
           playerState myPlayer = new playerState();
           myPlayer.name = "sammaru";
           myPlayer.level = 87;
           myPlayer.pos = GameObject.Find("sammaru").transform.position;
       }

6. 接下來，我們繼續在save中，加入把myPlayer資料轉成json的代碼：
   

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

   public void save() { //填寫jplayerState格式的資料.. playerState myPlayer = new playerState(); myPlayer.name = "sammaru"; myPlayer.level = 87; myPlayer.pos = GameObject.Find("sammaru").transform.position; //將myPlayer轉換成json格式的字串 string saveString = JsonUtility.ToJson(myPlayer); //將字串saveString存到硬碟中 StreamWriter file = new StreamWriter(System.IO.Path.Combine(Application.streamingAssetsPath, "myPlayer")); file.Write(saveString); file.Close(); }

7. 上述程式碼不但將myPlayer轉存成字串saveString，還透過StreamWrite將資料存到硬碟。
   為了要使用StreamWrite，必須在程式碼開頭載入相關資源：
   

   using System.Collections;
   using System.Collections.Generic;
   using UnityEngine;
   using System.IO;  //StreamWrite會用到

8. 開啟並執行在本文提供的範例檔，
   在執行狀態中擊該按鈕SAVE，會在Asset/Resources資料夾內產生的myPlayer.json檔案。
   剛檔案的內容如下：
   

   {"name":"sammaru","level":87,"pos":{"x":0.0,"y":0.0,"z":500.0}}

9. 格式化後看起來是這樣，存檔成功！
   

   {
       "name": "sammaru",
       "level": 87,
       "pos": {
           "x": 0.0,
           "y": 0.0,
           "z": 500.0
       }
   }

[狀態讀檔]

1. 在load函式中，我們填入下面程式碼：
   

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

   public void load() { //讀取json檔案並轉存成文字格式 StreamReader file = new StreamReader(System.IO.Path.Combine(Application.streamingAssetsPath, "myPlayer")); string loadJson = file.ReadToEnd(); file.Close(); //新增一個物件類型為playerState的變數 loadData playerState loadData = new playerState(); //使用JsonUtillty的FromJson方法將存文字轉成Json loadData = JsonUtility.FromJson<playerState>(loadJson); //驗證用，將sammaru的位置變更為json內紀錄的位置 GameObject.Find("sammaru").transform.position = loadData.pos; }

2. 上述程式碼，是透過StreamRead讀取遊戲目錄路內的myPlayer.json。
   並透過JsonUtility的FromJson將字串解析成物件。
3. 大家玩玩可以下載本文提供的範例檔，
   透過WASD可以改變sammaru的位置，
   並可按save紀錄其位置，按Load將sammaru還原至按save按鈕時的位置。