게임 저장 워크스루 및 샘플

​

Partner Center 구성

​

타이틀에 대해 XBOX 서비스 및 게임 저장 활성화

• XBOX 서비스를 활성화합니다.
  1. Partner Center에 로그인합니다.
  2. 타이틀로 이동한 다음, 설정에서 XBOX 서비스를 활성화합니다. 이 단계에 대한 자세한 내용은 Managed Partners를 위한 Partner Center에서 앱 또는 게임 설정하기를 참조하세요.
• 서비스 구성 식별자(SCID)를 가져옵니다. 모든 읽기 및 쓰기 작업은 SCID와 연결되어야 합니다. SCID는 게임 저장 초기화에도 사용됩니다.
  • Partner Center에서 타이틀의 XBOX services > XBOX settings 탭에서 SCID를 확인할 수 있습니다. 이 페이지에서 Microsoft 계정(MSA) App ID(MSAAppID)도 확인할 수 있습니다.

​

개발 시나리오

​

게임 저장을 코드의 어디에 통합해야 하나요?

​

게임 저장 데이터가 손상되지 않도록 하려면 어떻게 해야 하나요?

1. 임시 파일에 씁니다.
   • 현재 저장 파일을 덮어쓰는 대신, 저장 데이터를 새 파일(예: save.tmp)로 직렬화합니다. 이 단계는 쓰기 도중에 프로세스가 중단되더라도 기존 저장 파일을 보호합니다.
2. 쓰기가 디스크에 완전히 커밋된 후 쓰기 핸들을 닫습니다.
3. Win32 ReplaceFile을 사용하여 기존 저장 파일을 새 임시 파일로 원자적으로 교체합니다.

​

오프라인 장치는 어떻게 지원하나요?

​

어떤 사용자 상호작용을 알고 있어야 하나요?

​

로컬 및 장치에만 저장하는 방법이 있나요?

​

장치를 통한 게임 저장 관리

​

파일 탐색기를 사용하여 PC에서 로컬 게임 저장에 액세스하기

​

콘솔에서 로컬 게임 저장에 액세스하기

1. XBOX 컨트롤러의 홈 버튼을 선택합니다.
2. 내 게임 및 앱 > 모두 보기를 선택합니다.
3. 게임 위에 커서를 놓고 보기 버튼을 선택합니다.
4. 저장된 데이터를 선택합니다.

• 시스템 UI를 사용하여 콘솔에서 데이터를 삭제해도 클라우드에 저장된 사본은 제거되지 않습니다. 타이틀을 다시 실행하면 클라우드에서 데이터를 동기화합니다.
• 장치 전용 공급자 데이터는 이름이 없는 사용자로 표시됩니다. 이 데이터는 장치에 유지되며, 클라우드와 동기화되지 않고 장치에 종속됩니다.

​

테스트 시나리오

​

게임 저장이 클라우드와 올바르게 동기화되는지 테스트하기

1. SCID가 올바른지 확인합니다.
2. 올바른 사용자 핸들을 사용하고 있는지 확인합니다.
3. 타이틀이 현재 게임 세션 동안 XGameSaveFilesGetFolderWithUIAsync를 호출하는지 확인합니다. 타이틀이 일시 중단 상태에서 재개되는 경우에는 이 함수를 호출합니다.
   1. Fiddler를 사용하여 잠금이 획득되었는지 확인합니다.
   2. 이 경로를 저장하고, 나중에 데이터가 업로드되고 있는지 확인하는 데 사용합니다.
4. XGameSaveFilesGetFolderWithUIAsync가 제공한 파일 경로에 일부 데이터를 씁니다.
5. 타이틀을 종료하거나 일시 중단합니다.
6. OS가 자동으로 클라우드에 데이터를 업로드하고 잠금을 해제할 때까지 10~30초 정도 기다립니다.
   1. Fiddler를 사용하여 데이터가 업로드되고 잠금이 해제되었는지 확인합니다.
7. XGameSaveFilesGetFolderWithUIAsync가 제공한 폴더 내의 데이터를 수동으로 삭제합니다.
   1. 콘솔에서는 플레이어 설정을 통해 이 데이터에 액세스합니다.
8. 타이틀을 다시 실행한 후 사용자를 로그인시키려고 시도합니다.
9. 동기화 대화 상자가 나타나 클라우드에서의 활성 다운로드 동기화를 표시합니다.

• 트래픽을 검사하고 저장을 조작하기 위한 게임 저장 도구
• 게임 저장 동기화 흐름 이해하기

​

게임 저장이 올바르게 로밍되는지 테스트하기

​

마이그레이션 시나리오

​

타이틀 간에 게임 저장 공유하기

1. Partner Center에서 액세스하려는 타이틀의 액세스 정책을 수정합니다.
2. 소스 코드에서 두 타이틀 모두에 대해 게임 저장 공급자를 초기화합니다.

​

액세스 정책 수정하기

1. Partner Center로 이동합니다.
2. Apps and games > <your title> > Gameplay settings를 선택합니다.
3. Gameplay Settings에서 Access Policies를 선택한 다음, Connected Storage를 펼칩니다.
4. Add app/service를 선택한 다음, 액세스를 제공할 타이틀을 추가합니다.
5. 타이틀 추가를 마쳤으면 Save를 선택한 다음, Publish를 선택합니다. 변경 사항은 한 시간 이내에 적용됩니다.

​

게임 저장 공급자 초기화하기

• XGameSave를 사용하는 경우, 각 타이틀에 대해 XGameSaveInitializeProvider 또는 XGameSaveInitializeProviderAsync를 호출합니다.
• XGameSaveFiles를 사용하는 경우, 공급자는 암묵적으로 초기화됩니다. 각 타이틀에 대해 XGameSaveFilesGetFolderWithUiAsync를 호출합니다.

​

XGameSave와 XGameSaveFiles 간의 상호 운용성

• 게시자가 이미 XGameSave를 사용하는 콘솔용 기존 타이틀을 보유하고 있는 경우.
• 게시자가 그 기존 타이틀을 XGameSaveFiles를 사용하도록 업데이트하고 싶지 않은 경우.
• 게시자가 PC 타이틀에 XGameSaveFiles를 추가하는 것이 XGameSave를 사용하는 것보다 쉽다고 판단하지만, 여전히 PC, 콘솔, XBOX 게임 스트리밍 간의 크로스 저장을 지원하고자 하는 경우.

• 컨테이너 이름의 슬래시(/)는 파일이 위치할 디렉터리 구조를 생성합니다.
• 다음 문자는 XGameSaveFiles에서 유효하지 않습니다. 시스템이 이러한 문자를 만나면 밑줄(_)로 매핑합니다.
  • \0에서 \001f까지의 문자(포함).
• 다음 문자는 XGameSaveFiles에서 유효하지 않습니다. 시스템이 이러한 문자를 만나면 마침표(.)로 매핑합니다.
  • 따옴표(”)
  • 보다 작음 기호(<)
  • 보다 큼 기호(>)
  • 파이프(|)
  • 별표(*)
  • 물음표(?)
  • 백슬래시(\)
• 블롭 이름의 슬래시(/)는 파일 이름의 마침표(.)로 매핑됩니다.
• 파일은 16MB로 제한됩니다. XGameSave는 최대 16MB의 업로드 크기를 지원합니다.

​

코드 없는 클라우드 저장을 사용하여 이전 타이틀을 PC 게임 저장으로 이식하기

• 타이틀이 x86 애플리케이션으로 실행되는 경우. 이 경우 패키지 형태로만 Microsoft Game Development Kit(GDK)를 사용합니다.
• Unreal Engine의 Blueprint나 Unity의 Bolt와 같은 도구를 사용하여 사용자 지정 코드 없이 타이틀이 만들어진 경우.

• 타이틀이 종료된 경우.
• 추적되는 사용자가 로그아웃한 경우.
• PC 전원 상태가 변경된 경우.
• 타이틀이 지정된 저장 영역에 마지막으로 쓴 지 30분이 경과한 경우.

​

코드 없는 클라우드 저장 활성화

1. MicrosoftGame.config 파일을 수정합니다.
2. 간소화된 사용자 모델을 활성화합니다.
3. 저장 파일의 루트 폴더를 지정합니다.
4. 타이틀에 해당하는 SCID를 제공합니다.

<Game configVersion="1">
   <Identity Name="SampleNameOne" Publisher="CN=NoPublisher"/>
   <SaveGameStorage>
      <NoCodePCRoot RelativeTo="SavedGames">test\path</NoCodePCRoot>
      <SCID>DF9D8061-4790-4B84-86B4-CD060B00B4DD</SCID>
      <MaxUserQuota>256</MaxUserQuota>
   </SaveGameStorage>
   <!-- Content removed for brevity -->
   
   <!-- Must also opt into requiring a default user at launch -->
   <AdvancedUserModel>false</AdvancedUserModel>
</Game>

​

코드 샘플

• GameSaveCombo
• GameSaveFilesCombo

​

참조 API 문서

• XGameSaveFiles (API 콘텐츠)
  • 함수
    • XGameSaveFilesGetFolderWithUiAsync

​

참고 항목