> ## 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.

# 게임 저장 개요

> XBOX 게임 저장이 XBOX 콘솔, PC, 휴대용 기기에서 플레이어 진행 상황을 동기화되게 유지하는 방식을 알아보고 설정에서 출시까지의 개발 수명 주기를 따라가 보세요.

## 소개

게임 저장은 사용자가 사인인할 때마다 진행 상황을 사용할 수 있도록 유지하여 디바이스 간을 원활하게 이동할 수 있게 해 줍니다. 이 시스템은 데이터를 로컬에 저장한 다음 디바이스가 인터넷에 연결되면 클라우드에 동기화합니다. 동기화가 완료되면 사용자는 지원되는 모든 디바이스에서 저장된 데이터에 접근할 수 있습니다.

## XBOX Play Anywhere 및 게임 저장

XBOX Play Anywhere는 게임 저장을 사용하여 사용자가 Windows 디바이스, XBOX 콘솔, PC 및 휴대용 디바이스 간에 게임 진행 상황을 원활하게 공유할 수 있게 해 줍니다. XBOX Play Anywhere는 일관된 저장 데이터 동기화에 의존합니다. 사용자는 지원되는 모든 디바이스에서 중단한 지점부터 다시 시작할 수 있습니다. 자세한 내용은 [XBOX Play Anywhere](https://www.xbox.com/games/xbox-play-anywhere)를 참조하세요.

## 게임 저장 개발 수명 주기

게임 저장 개발 수명 주기 문서에서는 안정적인 클라우드 연결 저장 시스템을 구축, 검증 및 유지 관리할 수 있는 구조화된 경로를 제공합니다. 새 타이틀에 게임 저장을 도입하는 방법을 안내하고, 디버깅, 테스트, 인증 및 게시 후 지원으로 이어집니다. 각 단계에서는 타이틀이 데이터를 일관되게 저장하고, 안전하게 동기화하며, 디바이스 간에 원활한 사용자 경험을 제공하는 데 필요한 요구 사항, 도구 및 모범 사례를 강조합니다.

이 수명 주기는 게임 저장 구현이 첫 번째 프로토타입부터 게시 및 그 이후까지 예측 가능하게 동작하도록 돕습니다.

수명 주기 문서에서는 게임 저장을 계획, 구현, 검증, 게시 및 유지 관리할 때의 엔드투엔드 흐름을 설명합니다. 이 수명 주기는 다음과 같이 설명됩니다.

1. **게임 저장 시작하기:** 게임 저장 개념, API, 스토리지 모델 및 플랫폼 요구 사항으로 초기 온보딩합니다.
2. **새 타이틀 설정:** 개발 초기에 게임 저장을 통합합니다. 예:
   * 사용자 사인인 종속 초기화를 추가합니다.
   * 서비스 구성 식별자(SCID) 및 Microsoft 계정(MSA) 앱 ID(MSAAppID)와 같은 식별자를 구성합니다.
   * 스토리지 설계 및 컨테이너 구조를 수립합니다.
3. **개발 중 문제 디버깅:** 초기 구현 문제를 해결합니다. 다음과 같은 문제에 부딪힐 수 있습니다.
   * SCID 구성 문제
   * 핸들 수명 문제
   * 할당량/메모리 문제
   * NTSTATUS 오류 해석
4. **테스트 계획:** 구조화된 테스트 계획을 정의합니다. 예를 들어, 다음 영역을 테스트합니다.
   * 데이터 읽기/쓰기 정확성
   * 오프라인 동작
   * 동기화 로직
   * 시스템 대화상자 흐름
   * 다중 디바이스 시나리오
5. **테스트 시나리오:** 상세한 기능 및 스트레스 테스트를 수행합니다. 예를 들어, 다음 상황에서 타이틀이 어떻게 동작하는지 테스트합니다.
   * 연결 변경
   * 충돌 상태
   * 사용자 전환
   * 손상 처리
   * 스토리지 제한 극단적 사례
6. **게시할 타이틀 준비:** 게시하기 전에 게임 저장 구성을 마무리합니다. 이 작업에는 일반적으로 다음 태스크가 포함됩니다.
   * Microsoft 파트너 센터 설정 검증
   * 타이틀이 올바른 할당량을 사용하고 있는지 확인
   * 시스템 대화상자가 예상대로 작동하는지 확인
   * 타이틀이 안전 쓰기 패턴을 사용하는지 확인
7. **인증 요구 사항:** XBOX 인증 요구 사항을 충족합니다. 여기에는 예를 들어 다음이 포함됩니다.
   * 적절한 동기화 동작.
   * 연결 변경 관리.
   * 사용자 데이터 및 개인 식별 정보(PII) 규칙 준수.
8. **게시 후 문제 관리:** 라이브 사이트 문제를 모니터링하고 해결합니다. 다음과 같은 상황에 부딪힐 수 있습니다.
   * 동기화 실패.
   * 사용자 데이터 손실 보고.
   * 스토리지 제한 문제.
9. **마이그레이션 시나리오:** 시나리오에는 다음 항목이 포함됩니다.
   * 스토리지 레이아웃 업데이트
   * 게임 저장 API 간 이동
   * 타이틀 버전 간 전환

## 게임 저장 문서 집합

이 문서 집합은 전체 게임 저장 에코시스템을 이해하고 구현하는 데 도움이 됩니다. 이 집합은 API가 어떻게 작동하는지, 사용자 모델 및 프로세스 수명 관리(PLM)가 저장 데이터 흐름을 어떻게 형성하는지, 스토리지 시스템, 할당량, 오프라인 동작이 설계에 어떻게 영향을 미치는지 설명합니다. 또한 테스트 및 디버깅에 대한 지침을 제공하고, 사용자가 접할 수 있는 시스템 대화상자를 설명하며, 게시하기 전에 충족해야 하는 인증 요구 사항을 개괄합니다.

### 게임 저장 개발자 가이드

이 문서에서는 게임 저장 에코시스템 개요와 사용 가능한 API, 사용자 모델, PLM, 보안/PII 지침, 인증 요구 사항, 스토리지 제한 세부 정보와 같은 주요 개발자 고려 사항을 제공합니다.

* [개요](/build/core-features/common/game-save/game-saves-developer-guide#overview)
* [새 타이틀](/build/core-features/common/game-save/game-saves-developer-guide#new-titles)
* [게임 저장 API](/build/core-features/common/game-save/game-saves-developer-guide#game-saves-apis)
* [사용자 모델](/build/core-features/common/game-save/game-saves-developer-guide#user-models)
* [보안](/build/core-features/common/game-save/game-saves-developer-guide#security)
* [인증 요구 사항](/build/core-features/common/game-save/game-saves-developer-guide#certification-requirements)

### 게임 저장 동기화 흐름 이해

이 문서에서는 컨테이너/폴더 수준의 원자성, 6단계 동기화 흐름, 오프라인 모드 동작 및 머신 전용 공급자 사용에 대해 설명합니다.

* [타이틀 시작](/build/core-features/common/game-save/game-saves-syncing#title-start)
* [연결 확인](/build/core-features/common/game-save/game-saves-syncing#connection-check)
* [데이터 소유권 확인](/build/core-features/common/game-save/game-saves-syncing#data-ownership-check)
* [클라우드와 데이터 동기화](/build/core-features/common/game-save/game-saves-syncing#syncing-data-with-the-cloud)
* [게임 플레이 루프](/build/core-features/common/game-save/game-saves-syncing#gameplay-loop)
* [세션 종료](/build/core-features/common/game-save/game-saves-syncing#session-end)
* [연결 손실 및 잠금 시나리오](/build/core-features/common/game-save/game-saves-syncing#connection-loss-and-lock-scenarios)
* [전원 손실](/build/core-features/common/game-save/game-saves-syncing#power-loss)

### 게임 저장 스토리지 시스템

이 문서에서는 다양한 스토리지 컨텍스트를 개괄합니다. 타이틀 스토리지(클라우드), 로컬 저장 스토리지 및 머신 공급자 스토리지와 함께 타이틀별 할당량 및 콘솔 특정 로컬 스토리지 세부 정보를 다룹니다.

* [게임 저장 스토리지 시스템](/build/core-features/common/game-save/game-saves-storage-systems)
* [제한 및 할당량](/build/core-features/common/game-save/game-saves-storage-systems#limits-and-quotas)
* [콘솔별 로컬 스토리지](/build/core-features/common/game-save/game-saves-storage-systems#console-specific-local-storage-system)

### 게임 저장 시스템 대화상자

이 문서에서는 사용자가 게임 저장 작업을 수행할 때 마주칠 수 있는 시스템 대화상자를 설명합니다.

* [시스템 대화상자 한눈에 보기](/build/core-features/common/game-save/game-saves-dialogues#system-dialogs-at-a-glance)
* [게임 저장 대화상자](/build/core-features/common/game-save/game-saves-dialogues#game-saves-dialogs)

### 게임 저장 연습 및 샘플

이 문서에서는 파트너 센터를 설정하는 방법과 임시 파일에 쓰고 원자적으로 교체하는 것과 같은 안전 쓰기 패턴 사용법을 설명합니다. 또한 오프라인 및 네트워크 외부 시나리오를 관리하는 방법과 시스템 대화상자 흐름을 사용하는 방법을 설명합니다. 그리고 사용 중인 디바이스에서 게임 저장 데이터를 관리하고, 클라우드 동기화 동작을 테스트하고, 타이틀 또는 API 간에 마이그레이션하는 방법을 설명합니다.

* [파트너 센터 구성](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#partner-center-configurations)
* [개발 시나리오](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#development-scenarios)
* [테스트 시나리오](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#testing-scenarios)
* [마이그레이션 시나리오](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#migration-scenarios)
* [코드 샘플](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#code-samples)

### 게임 저장 디버깅

이 문서에서는 SCID 문제, 핸들 수명 모범 사례, 할당량 및 메모리 제한, Win32 `NTSTATUS` 코드 해석 방법을 포함한 일반적인 게임 저장 오류와 문제 해결 단계를 설명합니다.

* [일반적인 오류 시나리오](/build/core-features/common/game-save/game-saves-debugging#common-game-saves-error-scenarios)
* [일반적인 오류 표](/build/core-features/common/game-save/game-saves-debugging#common-errors)

### 게임 저장 도구

이 문서에서는 Fiddler를 사용하여 게임 저장 네트워크 트래픽을 검사하는 방법을 설명합니다. 또한 콘솔과 PC에서 로컬 저장 데이터를 내보내거나 가져오기 위해 `xbstorage` 및 `gamesaveutil` 명령줄 도구를 사용하는 방법을 보여 줍니다.

* [게임 저장 네트워크 트래픽 검사](/build/core-features/common/game-save/game-saves-tools#inspecting-game-saves-network-traffic)
* [게임 저장 도구](/build/core-features/common/game-save/game-saves-tools)

### XGameSaveFiles API 개요

이 문서에서는 `XGameSaveFilesGetFolderWithUIAsync`의 초기화 흐름, 권장되는 Win32 자동 클라우드 동기화 의미 체계, 할당량/디버그 지침, 성능 모범 사례 및 FAQ에 대해 설명합니다.

* [구현](/build/core-features/common/game-save/xgamesavefiles#implementation-of-xgamesavefiles)
* [게임 저장 흐름](/build/core-features/common/game-save/xgamesavefiles#game-saves-flow)
* [제한 및 할당량](/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas)
* [FAQ](/build/core-features/common/game-save/xgamesavefiles#faqs)

### XGameSave API 개요

이 문서에서는 컨테이너 및 blob 스토리지 모델, 공급자를 초기화하고 닫는 방법, 업데이트 핸들이 수명 주기 동안 어떻게 이동하는지 설명합니다. 또한 원자적 업데이트 동작, 동기화 흐름 다이어그램, 파일 크기 및 할당량 제한, 권장 모범 사례 및 FAQ를 다룹니다.

* [구현](/build/core-features/common/game-save/xgamesave#implementation)
* [게임 저장 흐름](/build/core-features/common/game-save/xgamesave#game-saves-flow)
* [제한 및 할당량](/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas)
* [모범 사례](/build/core-features/common/game-save/xgamesave#best-practices)
* [FAQ](/build/core-features/common/game-save/xgamesave#faqs)


## Related topics

- [게임 저장(콘텐츠)](/ko/build/core-features/common/game-save/game-saves-toc.md)
- [XGameSave](/ko/reference/system/xgamesave/xgamesave_members.md)
- [XGameSaveFiles](/ko/reference/system/xgamesavefiles/xgamesavefiles_members.md)
- [Connected Storage](/ko/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md)
- [XGameSave Wrapper reference index and member list](/ko/reference/system/Wrappers/xgamesave_wrapper_members.md)