> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 게임 저장 개발자 가이드

> 용어, XGameSave 및 XGameSaveFiles API, 사용자 모델, PLM, 보안, 인증에 대한 지침과 함께 XBOX GDK 게임 저장을 타이틀에 통합하세요.

이 가이드에서는 게임 저장 기능을 타이틀에 통합하기 위한 시작점을 제공합니다. 필수 용어에 대한 개요, 사용 가능한 API의 개요와 사용자 모델, 보안, 인증 요구 사항과 같은 중요한 고려 사항을 다룹니다.

## 개요

게임 저장 에코시스템 전체에서 다음 용어가 나타납니다.

* **게임 저장 에코시스템**: 이전에는 *연결된 스토리지(Connected Storage)* 또는 `XGameSave`라고 했으며, 이 에코시스템은 게임이 디바이스에서 데이터를 저장하고 해당 데이터를 클라우드와 동기화하는 방식을 관리합니다. 이 에코시스템은 저장된 데이터를 컨테이너와 blob으로 구성합니다. 이러한 구성을 통해 타이틀은 디바이스 간에 플레이어 진행 상황을 저장, 업데이트 및 검색할 수 있습니다.
* **타이틀**: 개발 중인 게임입니다.
* **샌드박스**: 타이틀이 실행되는 환경입니다.
* **Microsoft 파트너 센터**: 타이틀 구성과 샌드박스를 관리하는 Microsoft 웹 포털입니다.
* **서비스 구성 식별자(SCID):** XBOX 서비스 내 타이틀의 서비스 구성에 대한 고유 식별자입니다.
* **Microsoft 계정(MSA) 앱 ID(MSAAppID)**: 게임을 Microsoft 계정 ID와 연결하는 필수 식별자입니다. 이 값은 파트너 센터에서 생성되며 MicrosoftGame.config에 배치되므로 사인인, 도전 과제, 클라우드 저장 및 사용자 데이터를 포함한 XBOX 서비스가 타이틀을 올바르게 인증할 수 있습니다.

다음 일반적인 서비스 용어가 게임 저장 API에 나타납니다.

* **로컬 스토리지**: 게임 플레이 중 디바이스에 저장되는 데이터입니다.
* **타이틀 스토리지/클라우드:** 디바이스가 인터넷에 연결되면 스토리지가 자동으로 클라우드의 타이틀 스토리지와 동기화됩니다.
* **잠금:** 활성적으로 사용하는 디바이스에서 특정 사용자에 대한 타이틀의 게임 저장에 대한 배타적 접근을 부여하는 메커니즘입니다. 잠금은 잠금이 유지되는 동안 다른 디바이스가 사용자의 게임 저장을 수정할 수 없도록 합니다.
  * 예를 들어, 사용자가 디바이스 A에서 타이틀 T를 플레이하면 해당 사용자의 타이틀 T에 대한 잠금을 갖게 됩니다.
* **공급자:** Game Save 시스템과 통신하는 중개 메커니즘으로, 게임 데이터 관리를 담당합니다. 공급자는 또한 디바이스에서 사용자의 잠금을 관리합니다.
* **컨테이너**: 폴더에 해당합니다.
* **Blob**: 개별 파일에 해당합니다.

## 새 타이틀

게임 저장을 사용하기 전에 타이틀은 파트너 센터에서 XBOX 서비스가 활성화되어 있어야 합니다. 이 서비스는 타이틀에 SCID와 MSAAppID를 제공합니다. 자세한 내용은 [타이틀에 대해 XBOX 서비스 및 게임 저장 활성화](/ko/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md#enabling-xbox-services-and-game-saves-for-your-title)를 참조하세요.

파트너 센터가 설정된 후에는 게임 저장 구현에 [XGameSaveFiles](/ko/build/core-features/common/game-save/xgamesavefiles.md)를 사용하는 것이 좋습니다.

## 게임 저장 API

| API | 설명 | 플랫폼 | 사용 사례 | 샘플 |
| - | - | - | - | - |
| [XGameSaveFiles](/ko/build/core-features/common/game-save/xgamesavefiles.md) | 자동으로 클라우드에 동기화되는 게임 저장 로컬 스토리지의 파일 경로를 제공합니다. | PC, XBOX | 대부분의 시나리오에 이 API를 권장합니다. 읽기/쓰기가 가능하고 자동으로 클라우드에 동기화되는 파일 경로를 제공합니다. | [GameSaveFilesCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavefilescombo/) |
| [코드 없는 클라우드 저장](/ko/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md#porting-previous-titles-to-pc-game-saves-with-no-code-cloud-saves) | 자동으로 클라우드에 동기화되는 파일 경로를 제공합니다. | PC | GDK를 직접 사용할 수 없거나 PC Game Pass로 이식하는 PC 게임에 이상적입니다. 게임 .config 파일에 읽기/쓰기 경로를 제공합니다. | 없음 |
| [XGameSave](/ko/build/core-features/common/game-save/xgamesave.md) | 데이터가 로컬에 저장되고 클라우드에 동기화됩니다. | PC, XBOX | 더 크거나 더 복잡한 사용자당 스토리지가 필요한 타이틀을 지원합니다. 파일 관리에 대한 상세한 제어를 제공합니다. | [GameSaveCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavecombo/) |

## 사용자 모델

게임에는 두 가지 유형의 사용자 모델이 지원됩니다. 단순 사용자 모델(Simple User Model) 사용을 권장합니다.

| 방법 | 설명 | 샘플 링크 | 소매 플랫폼 차이점 |
| - | - | - | - |
| 단순 사용자 모델 | 기본 사용자가 필요합니다. 이들이 게임 인스턴스의 수명을 제어합니다. OS는 게임이 실행될 때 사용자가 사인인하도록 보장합니다. | [SimpleUserModel](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/simpleusermodel/) | PC: 기본 사용자가 사인아웃하면 게임이 종료됩니다.  콘솔: 기본 사용자가 사인아웃하면 게임이 일시 중단됩니다. |
| 고급 사용자 모델 | 기본 사용자 없음. 게임이 실행될 때 사용자가 사인인되어 있다는 보장이 없습니다. | 없음 | 없음 |

사용자 모델에 대한 자세한 내용은 [GDK 사용자 모델](/ko/build/core-features/common/user/gamecore-user-models.md)을 참조하세요.

사용자 사인인에 대한 모범 사례에 대한 자세한 내용은 [방법: 사용자 사인인 모범 사례](/ko/build/core-features/common/user/xuser_howto_best_practice_signing_in.md)를 참조하세요.

## 보안

### 개인 데이터

Microsoft는 특정 사용자의 게임 저장 데이터에 접근할 수 있게 해 주는 API나 도구를 제공하지 않습니다. 문제를 해결하기 위해 이 정보가 필요한 경우, 사용자에게 직접 연락하여 공유를 요청하세요.

### 안전하게 저장

PC 접근성이 활성화되면 게임 저장은 안전하지 않습니다. PC 접근성을 사용하면 사용자가 파일 경로를 직접 열 수 있으므로 저장된 데이터가 노출됩니다. 게임 저장의 적절한 상태를 확인하기 위해 자체 서버 측 검사를 두는 것을 권장합니다.

## 인증 요구 사항

### XR-052

[XR-052 User State and Title-Save Location, Roaming, and Dependencies](https://learn.microsoft.com/build/store/policies/XR/XR052)


## Related topics

- [게임 저장 개요](/ko/build/core-features/common/game-save/game-saves-overview.md)
- [게임 저장(콘텐츠)](/ko/build/core-features/common/game-save/game-saves-toc.md)
- [PC 개발자를 위한 FAQ](/ko/build/gdk-and-engines/guides/pc-faq.md)
- [XBOX GDK를 위한 PC 개발자 도구](/ko/tools/tools-pc/index.md)
- [XBOX 콘솔 개발자 도구 (GDK)](/ko/tools/tools-console/index.md)