# Cloud Save 게임 데이터

> Understand how Cloud Save stores key and value pairs for game-wide data with different access classes.

Cloud Save 게임 데이터는 게임과 연결된 **커스텀 아이템**인 오브젝트의 키/값 스토리지입니다. 플레이어와 연결되어 있는 오브젝트인 [플레이어 데이터](./player-data.md)와는 다릅니다.

**커스텀 아이템**은 플레이어가 읽을 수 있지만 서버에서만 쓸 수 있는 데이터나, 서버 권한이 있는 컨텍스트에서만 액세스할 수 있는 데이터(예: [Cloud Code](/cloud-code.md))에 사용할 수 있습니다.

**커스텀 아이템**을 [Cloud Code](/cloud-code.md)와 함께 사용하여 길드/클랜, 커뮤니티 목표, 배틀 패스와 같은 기능을 추가하거나 멀티플레이어 게임에서 아이템이나 NPC 상태를 저장할 수 있습니다.

[Unity Dashboard](https://cloud.unity.com/home/organizations/default/projects/default/environments/default/cloud-save/game-data/)를 사용하여 게임 데이터를 조회하고 수정할 수 있습니다.

## 액세스 클래스##access-classes

Cloud Save는 **커스텀 아이템**에 대해 2가지 액세스 클래스를 지원합니다.

| 액세스 클래스 | 설명                                  |
| :------ | :---------------------------------- |
| **기본**  | 모든 플레이어가 읽을 수 있지만, 쓰기는 서버에서만 가능합니다. |
| **비공개** | 서버에서만 읽고 쓸 수 있습니다.                  |

Cloud Code에서 게임 데이터를 작성하는 메서드 목록을 보려면 [Cloud Code용 Cloud Save SDK](https://cloud-code-sdk-documentation.cloud.unity3d.com/cloud-save/) 기술 자료를 참고하십시오.

## 제한 사항##limits

> **Note:**
>
> **참고**: 제한은 **커스텀 아이템**별로 적용되며, **커스텀 아이템**의 수는 제한이 없습니다.

* **커스텀 아이템**에는 액세스 클래스당 2,000개의 키/값 페어 제한이 적용됩니다.
  * 기본 액세스 클래스에서 키 2,000개
  * 비공개 데이터에서 키 2,000개
* **커스텀 아이템**에는 액세스 클래스당 총 5MiB 제한이 적용됩니다.
  * 기본 액세스 클래스에서 5MiB의 데이터
  * 5MiB의 비공개 데이터

예를 들어, 각 커스텀 아이템에서 각 2.5KiB의 키 2,000개를 보유하거나 5MiB인 커스텀 아이템에서 키 1개를 보유할 수 있습니다.

## 추가 리소스##additional-resources

* [Unity SDK를 사용하여 게임 데이터 액세스](/cloud-save/tutorials/unity-sdk.md#game-data)
* [Cloud Code를 사용하여 게임 데이터 액세스](/cloud-save/tutorials/cloud-code.md)