소개
게임 저장은 사용자가 사인인할 때마다 진행 상황을 사용할 수 있도록 유지하여 디바이스 간을 원활하게 이동할 수 있게 해 줍니다. 이 시스템은 데이터를 로컬에 저장한 다음 디바이스가 인터넷에 연결되면 클라우드에 동기화합니다. 동기화가 완료되면 사용자는 지원되는 모든 디바이스에서 저장된 데이터에 접근할 수 있습니다.XBOX Play Anywhere 및 게임 저장
XBOX Play Anywhere는 게임 저장을 사용하여 사용자가 Windows 디바이스, XBOX 콘솔, PC 및 휴대용 디바이스 간에 게임 진행 상황을 원활하게 공유할 수 있게 해 줍니다. XBOX Play Anywhere는 일관된 저장 데이터 동기화에 의존합니다. 사용자는 지원되는 모든 디바이스에서 중단한 지점부터 다시 시작할 수 있습니다. 자세한 내용은 XBOX Play Anywhere를 참조하세요.게임 저장 개발 수명 주기
게임 저장 개발 수명 주기 문서에서는 안정적인 클라우드 연결 저장 시스템을 구축, 검증 및 유지 관리할 수 있는 구조화된 경로를 제공합니다. 새 타이틀에 게임 저장을 도입하는 방법을 안내하고, 디버깅, 테스트, 인증 및 게시 후 지원으로 이어집니다. 각 단계에서는 타이틀이 데이터를 일관되게 저장하고, 안전하게 동기화하며, 디바이스 간에 원활한 사용자 경험을 제공하는 데 필요한 요구 사항, 도구 및 모범 사례를 강조합니다. 이 수명 주기는 게임 저장 구현이 첫 번째 프로토타입부터 게시 및 그 이후까지 예측 가능하게 동작하도록 돕습니다. 수명 주기 문서에서는 게임 저장을 계획, 구현, 검증, 게시 및 유지 관리할 때의 엔드투엔드 흐름을 설명합니다. 이 수명 주기는 다음과 같이 설명됩니다.- 게임 저장 시작하기: 게임 저장 개념, API, 스토리지 모델 및 플랫폼 요구 사항으로 초기 온보딩합니다.
- 새 타이틀 설정: 개발 초기에 게임 저장을 통합합니다. 예:
- 사용자 사인인 종속 초기화를 추가합니다.
- 서비스 구성 식별자(SCID) 및 Microsoft 계정(MSA) 앱 ID(MSAAppID)와 같은 식별자를 구성합니다.
- 스토리지 설계 및 컨테이너 구조를 수립합니다.
- 개발 중 문제 디버깅: 초기 구현 문제를 해결합니다. 다음과 같은 문제에 부딪힐 수 있습니다.
- SCID 구성 문제
- 핸들 수명 문제
- 할당량/메모리 문제
- NTSTATUS 오류 해석
- 테스트 계획: 구조화된 테스트 계획을 정의합니다. 예를 들어, 다음 영역을 테스트합니다.
- 데이터 읽기/쓰기 정확성
- 오프라인 동작
- 동기화 로직
- 시스템 대화상자 흐름
- 다중 디바이스 시나리오
- 테스트 시나리오: 상세한 기능 및 스트레스 테스트를 수행합니다. 예를 들어, 다음 상황에서 타이틀이 어떻게 동작하는지 테스트합니다.
- 연결 변경
- 충돌 상태
- 사용자 전환
- 손상 처리
- 스토리지 제한 극단적 사례
- 게시할 타이틀 준비: 게시하기 전에 게임 저장 구성을 마무리합니다. 이 작업에는 일반적으로 다음 태스크가 포함됩니다.
- Microsoft 파트너 센터 설정 검증
- 타이틀이 올바른 할당량을 사용하고 있는지 확인
- 시스템 대화상자가 예상대로 작동하는지 확인
- 타이틀이 안전 쓰기 패턴을 사용하는지 확인
- 인증 요구 사항: XBOX 인증 요구 사항을 충족합니다. 여기에는 예를 들어 다음이 포함됩니다.
- 적절한 동기화 동작.
- 연결 변경 관리.
- 사용자 데이터 및 개인 식별 정보(PII) 규칙 준수.
- 게시 후 문제 관리: 라이브 사이트 문제를 모니터링하고 해결합니다. 다음과 같은 상황에 부딪힐 수 있습니다.
- 동기화 실패.
- 사용자 데이터 손실 보고.
- 스토리지 제한 문제.
- 마이그레이션 시나리오: 시나리오에는 다음 항목이 포함됩니다.
- 스토리지 레이아웃 업데이트
- 게임 저장 API 간 이동
- 타이틀 버전 간 전환
게임 저장 문서 집합
이 문서 집합은 전체 게임 저장 에코시스템을 이해하고 구현하는 데 도움이 됩니다. 이 집합은 API가 어떻게 작동하는지, 사용자 모델 및 프로세스 수명 관리(PLM)가 저장 데이터 흐름을 어떻게 형성하는지, 스토리지 시스템, 할당량, 오프라인 동작이 설계에 어떻게 영향을 미치는지 설명합니다. 또한 테스트 및 디버깅에 대한 지침을 제공하고, 사용자가 접할 수 있는 시스템 대화상자를 설명하며, 게시하기 전에 충족해야 하는 인증 요구 사항을 개괄합니다.게임 저장 개발자 가이드
이 문서에서는 게임 저장 에코시스템 개요와 사용 가능한 API, 사용자 모델, PLM, 보안/PII 지침, 인증 요구 사항, 스토리지 제한 세부 정보와 같은 주요 개발자 고려 사항을 제공합니다.게임 저장 동기화 흐름 이해
이 문서에서는 컨테이너/폴더 수준의 원자성, 6단계 동기화 흐름, 오프라인 모드 동작 및 머신 전용 공급자 사용에 대해 설명합니다.게임 저장 스토리지 시스템
이 문서에서는 다양한 스토리지 컨텍스트를 개괄합니다. 타이틀 스토리지(클라우드), 로컬 저장 스토리지 및 머신 공급자 스토리지와 함께 타이틀별 할당량 및 콘솔 특정 로컬 스토리지 세부 정보를 다룹니다.게임 저장 시스템 대화상자
이 문서에서는 사용자가 게임 저장 작업을 수행할 때 마주칠 수 있는 시스템 대화상자를 설명합니다.게임 저장 연습 및 샘플
이 문서에서는 파트너 센터를 설정하는 방법과 임시 파일에 쓰고 원자적으로 교체하는 것과 같은 안전 쓰기 패턴 사용법을 설명합니다. 또한 오프라인 및 네트워크 외부 시나리오를 관리하는 방법과 시스템 대화상자 흐름을 사용하는 방법을 설명합니다. 그리고 사용 중인 디바이스에서 게임 저장 데이터를 관리하고, 클라우드 동기화 동작을 테스트하고, 타이틀 또는 API 간에 마이그레이션하는 방법을 설명합니다.게임 저장 디버깅
이 문서에서는 SCID 문제, 핸들 수명 모범 사례, 할당량 및 메모리 제한, Win32NTSTATUS 코드 해석 방법을 포함한 일반적인 게임 저장 오류와 문제 해결 단계를 설명합니다.
게임 저장 도구
이 문서에서는 Fiddler를 사용하여 게임 저장 네트워크 트래픽을 검사하는 방법을 설명합니다. 또한 콘솔과 PC에서 로컬 저장 데이터를 내보내거나 가져오기 위해xbstorage 및 gamesaveutil 명령줄 도구를 사용하는 방법을 보여 줍니다.
XGameSaveFiles API 개요
이 문서에서는XGameSaveFilesGetFolderWithUIAsync의 초기화 흐름, 권장되는 Win32 자동 클라우드 동기화 의미 체계, 할당량/디버그 지침, 성능 모범 사례 및 FAQ에 대해 설명합니다.