메인 콘텐츠로 건너뛰기
이 가이드에서는 게임 저장 기능을 타이틀에 통합하기 위한 시작점을 제공합니다. 필수 용어에 대한 개요, 사용 가능한 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 서비스 및 게임 저장 활성화를 참조하세요. 파트너 센터가 설정된 후에는 게임 저장 구현에 XGameSaveFiles를 사용하는 것이 좋습니다.

게임 저장 API

사용자 모델

게임에는 두 가지 유형의 사용자 모델이 지원됩니다. 단순 사용자 모델(Simple User Model) 사용을 권장합니다. 사용자 모델에 대한 자세한 내용은 GDK 사용자 모델을 참조하세요. 사용자 사인인에 대한 모범 사례에 대한 자세한 내용은 방법: 사용자 사인인 모범 사례를 참조하세요.

보안

개인 데이터

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

안전하게 저장

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

인증 요구 사항

XR-052

XR-052 User State and Title-Save Location, Roaming, and Dependencies
마지막 수정일 2026년 10월 20일