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

# 認定テストからゲームセーブファイルを取得する

> XblConnectedStorage、xbstorage、および xgamesaveutil を使用して、XBOX Live CERT サンドボックスからゲームセーブを取得し、開発用テストアカウントに適用します。

## 認定レポートにクラッシュが記載されていますか?

これは特に、すべてのバグが修正される前の任意の認定テストパスで、珍しいことではありません。多くの場合、スタジオでの開発ビルドでこれらの問題を再現することが難しくなります。

クラッシュダンプが利用できない、または役に立たない場合、認定チームが使用していたアカウントのセーブファイルが役立つ可能性があります。認定テストアカウントのセーブファイルを開発サンドボックスのテストアカウントに適用することで、問題をより素早く特定できる場合があります。

この記事ではその方法を説明します。

## CERT からセーブを取得してテストアカウントに適用する方法

[XblConnectedStorage](/tools/tools-services/live-connected-storage-tool) を使用して、XBOX Live CERT サンドボックスからセーブ blob を取得します。

[Xbstorage](/tools/tools-console/commandlinetools/xbstorage) を使用して、コンソール用の開発サンドボックスのテストアカウントにセーブを適用します。

[Xgamesaveutil](/tools/tools-pc/commandlinetools/gr-xgamesaveutil) を使用して、PC 用の開発サンドボックスのテストアカウントにセーブを適用します。

### 前提条件

1. 使用する PC に [GDK または GDK Tools](https://aka.ms/gdkdl) がインストールされていること
2. ゲームを公開している Partner Center アカウントのログイン資格情報
   * ゲーム製品に対する XBOX Live "Tools Access" 権限が付与されていること ([権限のドキュメント](https://learn.microsoft.com/windows/apps/publish/partner-center/assign-product-level-custom-permissions-to-account-users#xbox-live-))
   * ログインがゲストアカウントの場合は、そのアカウントがゲストとして招かれている Microsoft Entra テナント名 (おそらく ?.onmicrosoft.com の形式) が必要です。
3. Partner Center の Game Setup/Identity details セクションから取得できる、ゲームの XBOX Service Configuration ID (SCID)。
4. 同じ場所から取得できる、ゲームの Package Family Name (PFN)。
5. セーブを取得したいアカウントのゲーマータグ (認定チームから提供)。
6. 認定チームが使用していたサンドボックス名: CERT または CERT.DEBUG。
7. セーブを適用したいテストアカウントのメールアドレス。

### XBOX Live からセーブ blob を取得する

1. GDK コマンドプロンプトウィンドウを開きます
2. [xbldevaccount](/tools/tools-services/live-dev-account-tool) を使用して、前提条件 #2 の Partner Center アカウントにサインインします。例:
   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com)</pre>

   別のテナントのゲストとしてサインインする場合は --tenant オプションを使用します。例:

   <pre>C:\temp>xbldevaccount signin --name [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) --tenant sombodyelseslovelygamecompany.onmicrosoft.com</pre>
3. XblConnectedStorage コマンドラインを使用して、XBOX Live からセーブを取得します。例:
   <pre>C:\temp>xblconnectedstorage --scid 00000000-0000-0000-0000-000012345678 -s CERT --gamertag "2 SomeCertAccount" --output .\GameSaveFrom2SomeCertAccount.xml
   Using Dev account [billyray@mylovelygamecompany.com](mailto:billyray@mylovelygamecompany.com) from WindowsDevCenter
   Operation complete. Downloaded 4 save containers to .\GameSaveFrom2SomeCertAccount.xml.</pre>

すべてが成功すると、指定した xml ファイルにセーブ blob が保存されているはずです。その中には base64 エンコードされたバイナリ blob が含まれているはずです。ファイル形式の詳細については、[こちら (NDA トピック)](/tools/tools-console/commandlinetools/xbstorage#xbstorage_fileformat) を参照してください。

### テストアカウントにセーブを適用する (コンソール)

xbstorage のドキュメントに従って、xml ファイルをストレージスペースに適用します。例:

<pre>C:\temp>xbstorage import .\GameSaveFrom2SomeCertAccount.xml /msa:[MLGC-MyTestAccount0000@xboxtest.com](mailto:MLGC-MyTestAccount0000@xboxtest.com) /replace /verbose</pre>

### テストアカウントにセーブを適用する (PC)

XGameSaveUtil のドキュメントに従って、xml ファイルをストレージスペースに適用します。例:

<pre>C:\temp>xgamesaveutil import .\GameSaveFrom2SomeCertAccount.xml /pfn:mygame\_xxxxxx /replace</pre>

## 注意事項

### タイミング

認定のテスト方法により、問題が発生した後もアカウントが引き続き使用される場合があります。認定レポートは通常、テストが完了した後に発行されます。

このため、XBOX Live 上のセーブが、問題が発生した時点で使用されていたものよりも新しい状態になっている可能性があります。

### Xblconnectedstorage の出力ディレクトリ

xblconnectedstorage.exe に --output を指定しない場合、現在の作業ディレクトリへの出力を試みます。GDK コマンドプロンプトを起動した直後の場合、そこは Windows System ディレクトリになる可能性が高く、xblconnectedstorage は失敗します。書き込み可能な場所を指すよう、明示的に --output パラメータを指定することをお勧めします。

### 最新のゲーマータグ

この手順は現在、最新のゲーマータグではテストされていません。


## Related topics

- [サンドボックス](/ja-jp/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [失敗の多い XBOX 認定テスト](/ja-jp/publishing/certification/xr-top-failing.md)
- [XBOX Connected Storage ツール (XblConnectedStorage.exe)](/ja-jp/tools/tools-services/live-connected-storage-tool.md)
- [Game Saves のチュートリアルとサンプル](/ja-jp/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [ゲームを認定する](/ja-jp/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game.md)
