Game Saves のチュートリアルとサンプル

​

Partner Center の構成

​

タイトルの XBOX サービスと Game Saves を有効化する

• XBOX サービスを有効化します。
  1. Partner Center にサインインします。
  2. 自分のタイトルに移動し、設定で XBOX サービスを有効化します。この手順の詳細については、Setting up an app or game at Partner Center, for Managed Partners を参照してください。
• サービス構成識別子 (SCID) を取得します。すべての読み取りおよび書き込み操作は、SCID に関連付けられている必要があります。SCID は Game Saves の初期化にも使用されます。
  • Partner Center では、タイトルの XBOX services > XBOX settings タブに SCID があります。このページでは、Microsoft アカウント (MSA) の App ID (MSAAppID) も確認できます。

​

開発シナリオ

​

コード内のどこに Game Saves を統合すべきか?

​

ゲームセーブデータが破損しないようにするにはどうすればよいか?

1. 一時ファイルに書き込みます。
   • ライブセーブを上書きするのではなく、新しいファイル (例: save.tmp) にセーブデータをシリアライズします。この手順により、書き込み途中でプロセスが中断された場合に既存のセーブが保護されます。
2. 書き込みがディスクに完全にコミットされたら、書き込みハンドルを閉じます。
3. Win32 の ReplaceFile を使用して、古いセーブファイルを新しい一時ファイルにアトミックに置き換えます。

​

オフラインデバイスをサポートするにはどうすればよいか?

​

認識しておくべきユーザー操作は?

​

ローカルおよびデバイスのみに保存する方法はあるか?

​

デバイス経由でのゲームセーブの管理

​

File Explorer を使用して PC 上のローカルゲームセーブにアクセスする

​

コンソール上のローカルゲームセーブにアクセスする

1. XBOX コントローラーの Home ボタンを選択します。
2. My games & apps > See all を選択します。
3. 自分のゲームにカーソルを合わせて、View ボタンを選択します。
4. Saved data を選択します。

• システム UI を使用してコンソール上のデータを削除しても、クラウドに保存されているコピーは削除されません。タイトルを再起動すると、クラウドからデータが同期されます。
• マシンプロバイダーのデータは、名前のないユーザーとして表示されます。このデータはデバイス上に留まり、クラウドに同期されず、デバイスに紐付けられます。

​

テストシナリオ

​

ゲームセーブがクラウドと正しく同期されるかテストする

1. SCID が正しいことを確認します。
2. 正しいユーザーハンドルを使用していることを確認します。
3. 現在のゲームセッション中に、タイトルが XGameSaveFilesGetFolderWithUIAsync を呼び出していることを確認します。タイトルがサスペンド状態から復帰した場合は、この関数を呼び出してください。
   1. Fiddler を使用して、ロックが取得されたことを確認します。
   2. このパスを保存し、データがアップロードされていることを後で確認するために使用します。
4. XGameSaveFilesGetFolderWithUIAsync から提供されたファイルパスにデータを書き込みます。
5. タイトルを終了またはサスペンドします。
6. OS がデータを自動的にクラウドへアップロードしてロックを解放するまで、10～30 秒間待機します。
   1. Fiddler を使用して、データがアップロードされ、ロックが解放されたことを確認します。
7. XGameSaveFilesGetFolderWithUIAsync によって提供されたフォルダー内のデータを手動で削除します。
   1. コンソールでは、プレイヤー設定からこのデータにアクセスします。
8. タイトルを再度起動し、ユーザーのサインインを試みます。
9. クラウドからのアクティブなダウンロード同期を示す同期ダイアログが表示されます。

• Game Saves tools to inspect traffic and manipulate saves
• Understanding the Game Saves sync flow

​

ゲームセーブが正しくローミングするかテストする

​

マイグレーションシナリオ

​

タイトル間でゲームセーブを共有する

1. Partner Center で、アクセスしたいタイトルのアクセスポリシーを変更します。
2. ソースコードで両方のタイトルの Game Saves プロバイダーを初期化します。

​

アクセスポリシーを変更する

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 を選択します。変更は 1 時間以内に反映されます。

​

Game Save プロバイダーを初期化する

• XGameSave を使用している場合は、各タイトルに対して XGameSaveInitializeProvider または XGameSaveInitializeProviderAsync を呼び出します。
• XGameSaveFiles を使用している場合、プロバイダーは暗黙的に初期化されます。各タイトルに対して XGameSaveFilesGetFolderWithUiAsync を呼び出します。

​

XGameSave と XGameSaveFiles の相互運用

• パブリッシャーがコンソール上にすでに XGameSave を使用している既存タイトルを持っている。
• パブリッシャーがその既存タイトルを XGameSaveFiles を使用するように更新したくない。
• パブリッシャーが、PC タイトルに XGameSaveFiles を追加する方が XGameSave を使用するより簡単だと考えているが、それでも PC、コンソール、および XBOX ゲーム ストリーミング間でのクロスセーブをサポートしたい。

• コンテナー名内のスラッシュ (/) は、そのファイルが配置されるディレクトリ構造を作成します。
• 次の文字は XGameSaveFiles で無効です。システムがこれらの文字を検出した場合、アンダースコア (_) にマッピングされます。
  • \0 から \001f までの文字 (両端を含む)。
• 次の文字は XGameSaveFiles で有効ではありません。システムがこれらの文字を検出した場合、ピリオド (.) にマッピングされます。
  • 二重引用符 (”)
  • 未満記号 (<)
  • より大きい記号 (>)
  • パイプ (|)
  • アスタリスク (*)
  • クエスチョンマーク (?)
  • バックスラッシュ (\)
• ブロブ名内のスラッシュ (/) は、ファイル名内のピリオド (.) にマッピングされます。
• ファイルは 16 MB に制限されています。XGameSave の最大アップロードサイズは 16 MB です。

​

以前のタイトルをノーコード クラウド セーブで PC Game Saves に移植する

• タイトルが 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 contents)
  • Functions
    • XGameSaveFilesGetFolderWithUiAsync

​

関連項目