💾유니티 - JSON 파일로 게임 저장하기 1-3 (저장 파일 불러오기)

저번에는 유니티에서 게임 데이터를 JSON 파일로 저장해봤다.
이번에는 저장한 JSON 파일을 유니티로 불러오는 작업을 해보자.

---

1. JSON 파일 역직렬화 (Deserialization)

앞선 글에서 우리는 게임 데이터 객체를 JSON 형식으로 변환해봤다.
근데 이제 저장한 JSON 파일을 어떻게 불러오고, 그 파일의 내용을 어떻게 처리해야할까?

객체를 JSON 파일로 변환시켰던 것처럼, JSON 파일을 활용하기 위해선 이 데이터를 다시 객체로 변환시켜야한다. 이를 역직렬화(Deserialization)라 한다.

다행히 우리가 썼던 JsonUtility에서 JsonUtility.ToJson메서드를 통해 간단히 객체를 직렬화 했던 것처럼 라이브러리 내부에서 JsonUtility.FromJson 메서드를 사용해서 역직렬화 기능을 사용할 수 있다.

그럼 이제 JSON 파일을 역직렬화하는 코드를 살펴보자.

---

2. 저장된 파일 읽기

string path = Path.Combine(Application.persistentDataPath, "playerData.json");
if (File.Exists(path))
{
    string jsonData = File.ReadAllText(path);
}

당연히 데이터를 불러오러면 파일을 먼저 읽어야 한다. 위 코드를 분석해보면

• Path.Combine을 통해서 path 변수에 경로값을 할당해준다.
• File.Exists를 통해서 path 경로에 파일이 존재하는지 확인한다.
• 만약 존재한다면 File.ReadAllText로 파일 내의 모든 텍스트을 가져와서 jsonData 변수에 할당한다.

자, 이러면 jsonData변수에 파일 내에 있던 모든 값이 저장이 됐다.
그럼 이제 이 텍스트를 어떻게 처리해야 데이터 객체로 변환시킬 수 있을까?

---

3. 데이터 객체로 변환하기

PlayerData playerData = JsonUtility.FromJson<PlayerData>(jsonData);

이건 JSON 객체로 변환할 때 JsonUtility.ToJson을 사용한 것과 유사하게, JsonUtility.FromJson 메서드를 사용하면 된다.

• JsonUtility.FromJson를 통해서 jsonData에 저장된 텍스트 데이터를 PlayerData 타입의 객체로 변환한 후, playerData 변수에 값을 저장해준다.

이러면 데이터를 불러오는 기본 로직이 끝났다!

이제 위의 로직을 합쳐서 한 코드로 만들면 아래처럼 쓸 수 있다.

using System.IO;
using UnityEngine;

[System.Serializable]
public class PlayerData // 저장할 데이터가 명시된 클래스
{
    public string name;
    public int level;
    public string[] items;
}

// 데이터 로드와 관련된 메서드가 정의된 매니저 클래스
public class LoadManager : MonoBehaviour
{
	// JSON 파일에서 PlayerData를 불러와, 반환해주는 메서드
    public PlayerData LoadData()
    {
        string path = Path.Combine(Application.persistentDataPath, "playerData.json");
        if (File.Exists(path))
        {
            string jsonData = File.ReadAllText(path);
            PlayerData data = JsonUtility.FromJson<PlayerData>(jsonData);
            Debug.Log("데이터 로딩 성공! // 플레이어 이름 : " + data.name);
            return data;
        }
        else
        {
            Debug.LogWarning("세이브 파일을 찾을 수 없음!");
            return null;
        }
    }
}

---

이제 아래의 예제를 통해서playerData.json 파일을 저장 후, 불러와보자.

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

public class TestJson : MonoBehaviour
{
    void Start()
    {
        PlayerData player = new PlayerData // 데이터 객체 생성
        {
            name = "Player1",
            level = 5,
            items = new string[] { "sword", "shield" }
        };

        SaveManager saveManager = new SaveManager(); // SaveManager 객체 생성
        saveManager.SaveData(player); // 데이터 저장

        LoadManager loadManager = new LoadManager(); // LoadManager 객체 생성
        PlayerData playerData = loadManager.LoadData(); // 데이터 불러오기
        printData(playerData); // 불러온 데이터 출력
    }

    void printData(PlayerData playerData)
    {
        Debug.Log("name : " + playerData.name);
        Debug.Log("level : " + playerData.level);
        foreach(string item in playerData.items)
            Debug.Log("item : " + item);
    }
}

• 예제 코드

• 데이터가 성공적으로 불러와진 모습

• 불러온 데이터 객체에 저장되어 있는 값

---

이걸로 게임 저장 파일을 JSON 형식으로 저장하는 것에 이어서 불러오는 기능까지 구현해봤다.

위의 예시 코드를 좀 더 다듬은 코드를 첨부하고 글을 마치겠다.

• try-catch 문을 사용해 예상치 못한 오류 예외처리
• if문 구문 약간 수정 (로직은 동일함)

using System.IO;
using UnityEngine;

public class LoadManager : MonoBehaviour
{
    public PlayerData LoadData()
    {
        string path = Path.Combine(Application.persistentDataPath, "playerData.json");
        if (!File.Exists(path))
        {
            Debug.LogWarning("세이브 파일을 찾을 수 없습니다. 디폴트 파일을 불러옵니다.");
            return new PlayerData { name = "DefaultPlayer", level = 1, items = new string[] { } };
        }

        try
        {
            string jsonData = File.ReadAllText(path);
            PlayerData playerData = JsonUtility.FromJson<PlayerData>(jsonData);

            Debug.Log("데이터 로드 성공!");
            return playerData;
        }
        catch (System.Exception e)
        {
            Debug.LogError("JSON 파일을 불러오는데 오류 발생: " + e.Message);
            return new PlayerData { name = "DefaultPlayer", level = 1, items = new string[] { } };
        }

    }
}