💾유니티 - JSON 파일로 게임 저장하기 1-1 (JSON 파일이란?)

게임을 하다보면 언젠간 게임을 종료시켜야 한다. 이럴 때 저장기능이 없다면 유저 입장에서 많이 난처할 것이다.
유니티에서 보통 저장 기능을 구현할 땐, PlayerPrefs, JSON 파일 등을 사용한다.
이번엔 JSON 파일로 게임 저장 기능을 어떻게 구현할 수 있을지 알아보자.

---

JSON이란?

저장 기능을 구현하기 전에 먼저 JSON에 대해 알아보자.
JSON으로 저장한다는데 JSON이 뭔지 모르면 뭔가 이상하지 않은가.

JSON은 JavaScript Object Notation의 약자로 데이터 저장과 교환을 수월하게 하기 위해 만들어진 양식이다. 기존에 쓰이던 XML에 비해 구조가 단순하고 가벼워 자주 사용된다.

1. JSON의 구조

JSON은 객체(Object)로 이루어져 있을 수도 있고, 배열(Array)로 이루어져 있을 수도 있다. 설명하기에 앞서 간단히 비교해보면,

---

객체

• 중괄호 {} 로 감싸며, 키(key) - 값(value) 쌍으로 데이터를 저장한다.
• 다양한 속성의 데이터를 저장할 때 유용하다.
  ex) 플레이어 레벨, 진행 상황, 설정 정보 등

기본적인 구조

{ key : value }

예시

{
  "도시": "서울",
  "인구": 10000000,
  "지역": ["은평구", "영등포구", "마포구"]
}

---

배열

• 대괄호 []로 감싸며, 값(value)들의 목록을 저장한다.
• 순서가 존재하거나 비슷한 종류의 데이터를 저장할 때 유용하다.
  ex) 아이템 리스트, 배열에 기반한 데이터 등

기본적인 구조

[value1, value2, value3]

예시

[
  {"상품": "노트북", "가격": 1500000},
  {"상품": "스마트폰", "가격": 800000},
  {"상품": "태블릿", "가격": 600000}
]

---

다음 예시로 좀 더 자세히 알아보자.

{
  "이름": "홍길동",
  "나이": 30,
  "주소": {
    "도시": "서울",
    "구": "강남구"
  },
  "취미": ["독서", "등산", "음악 감상"]
}

• 위의 예시는 JSON 객체로 이름, 나이, 주소, 취미의 키(key)와 이에 해당하는 값들이 포함되어 있다. 각 데이터는 쉼표,로 구분된다.
• 여기서 주소는 값으로 또 다른 객체를 가지며, 그 객체는 도시, 구의 키와 이에 해당하는 값이 저장되어 있다.
• 그리고 취미의 값으로는 배열이 할당되어 있다.

주소 키에 할당된 값(객체)

{
    "도시": "서울",
    "구": "강남구"
}

취미 키에 할당된 값(배열)

["독서", "등산", "음악 감상"]

---

갑자기 뭔가 복잡해 보이는 코드의 구조를 뜯어보니 뭔가 헷갈릴 수도 있다.
그래서 JSON에서 사용 가능한 데이터 타입에 대해 알아보면서 복습해보자.

---

2. JSON에서 사용 가능한 데이터 타입

JSON 내에서 표현할 수 있는 데이터 타입은 다음 6개가 있다.

• 문자열 (String): "텍스트"
• 숫자 (Number): 정수ex) -1, 0, 1, 등...나 실수ex) 3.141592, 등...
• 객체 (Object): { "키": "값" }
• 배열 (Array): [값1, 값2, ...]
• 불리언 (Boolean): true 또는 false
• 널 (Null): null

이를 보고 다음 예시와 함께 다시 자세히 이해해보자.

{
  "name": "홍길동",                
  "age": 28,                      
  "height": 175.5,                
  "isMember": true,               
  "address": {                    
    "city": "서울",
    "district": "강남구",
    "zipcode": null               
  },
  "hobbies": ["독서", "등산", "영화 감상"]
}

1. 문자열 (String)
   • 예시 필드: "name": "홍길동", "city": "서울", "district": "강남구"
   • 텍스트 데이터를 저장하는 데 사용된다. 문자열은 항상 큰따옴표(" ")로 감싸서 써야한다.
2. 숫자 (Number)
   • 예시 필드: "age": 28, "height": 175.5
   • 정수와 실수, 모두를 지칭한다. JSON에서는 별도의 정수 타입과 실수 타입으로 구분하지 않는다.
3. 객체 (Object)
   • 예시 필드: "address": { ... }
   • 중괄호{}로 감싸여 있으며, 키-값 쌍으로 구성된다. 복잡한 데이터를 구조화하는 데 사용된다.
4. 배열 (Array)
   • 예시 필드: "hobbies": ["독서", "등산", "영화 감상"]
   • 대괄호[]로 감싸여 있으며, 값들의 순서가 있는 목록으로 구성된다. 동일한 타입의 데이터나 다양한 타입의 데이터를 포함할 수 있다.
5. 불리언 (Boolean)
   • 예시 필드: "isMember": true
   • 참(true) 또는 거짓(false) 값을 가진다.
6. 널 (Null)
   • 예시 필드: "zipcode": null
   • 값이 없음을 나타낸다. 데이터가 없거나 값이 아직 할당되지 않은 경우에 사용한다.

---

데이터 타입을 활용하면 아래와 같이 복잡한 구조도 표현 가능하다.

{
  "player": {
    "name": "김철수",
    "stats": {
      "level": 15,
      "experience": 2450.75,
      "isPremium": false
    },
    "inventory": [
      {
        "item": "검",
        "quantity": 1,
        "durability": 80.5
      },
      {
        "item": "방패",
        "quantity": 1,
        "durability": 60.0
      },
      {
        "item": "포션",
        "quantity": 10,
        "durability": null
      }
    ],
    "achievements": null
  }
}

• player : 객체 타입, 플레이어에 대한 모든 정보를 포함.
• name : 문자열 타입, 플레이어의 이름.
• stats : 객체 타입, 플레이어의 레벨, 경험치, 프리미엄 회원 여부에 대한 정보를 포함.
  • level: 숫자 타입, 플레이어의 레벨.
  • experience: 숫자 타입, 플레이어의 경험치.
• isPremium: 불리언 타입, 프리미엄 회원 여부.
• inventory: 배열 타입, 플레이어의 인벤토리 아이템 목록.
  • 각 아이템은 객체 타입으로, item(문자열), quantity(숫자), durability(숫자 또는 널) 필드를 가짐.
• achievements: 널 타입, 현재 플레이어가 달성한 업적이 없음을 의미.

---

3. JSON을 쓰면서 주의해야 할 것

• 키와 문자열 값은 작은따옴표''가 아닌 큰따옴표""로 감싸야 한다.

(X)    { 'name': '홍길동' }
(O)	   { "name": "홍길동" }

• 각 요소의 구분은 쉼표,로 구분하며, 마지막 요소 뒤엔 쉼표를 사용하지 않는다.

(X)
{
  "name": "홍길동",
  "age": 30,
}

(O)
{
  "name": "홍길동",
  "age": 30
}

• JSON 표준은 주석을 지원하지 않는다.

(X)
{
  "name": "홍길동" // 사용자 이름
}
또는
{
  "name": "홍길동" # 사용자 이름
}

(O)
{
  "name": "홍길동"
}

---

이렇게 해서 JSON에 대해 알아보았다.
쓰다보니 분량이 길어져서 유니티에서 JSON을 활용해 저장 기능을 만들어 보는 것은 다음 글에서 알아보자.