認定テスト中に生成されたゲーム セーブ ファイルの取得
認定レポートにはクラッシュが記載されていますか?
これは、特にすべてのバグが解消される前にオプションの認定テストに合格する場合には、珍しいことではありません。 多くの場合、スタジオでの開発ビルドでこれらの問題を再現することが課題となることがあります。
クラッシュ ダンプが利用できない、または役に立たない場合は、証明書が使用していたアカウントの保存ファイルが利用できない可能性があります。 証明書テスト アカウントの保存ファイルを開発サンドボックス テスト アカウントに適用すると、問題をより簡単に特定できる可能性があります。
この記事では、その方法について説明します。
CERT から保存データを取得してテスト アカウントに適用する方法
XblConnectedStorage は、Xbox Live CERT サンドボックスから保存 BLOB を取得します。
XbStorage (NDA トピック)認可が必須です を使用して、コンソールの開発サンドボックス内のテスト アカウントに保存を適用します。
XGameSaveUtil は、PC 用開発サンドボックス内のテスト アカウントに保存を適用するために使用されます。
前提条件
- 使用中の PC にインストールされている GDK または GDK ツール
- ゲームの公開元のパートナー センター アカウントへのログイン資格情報
- ゲーム製品に対する Xbox Live の "ツール アクセス" アクセス許可 (アクセス許可に関するドキュメント)
- ログインがゲスト アカウントである場合は、アカウントがゲストである Microsoft Entra テナント名 (おそらく ?.onmicrosoft.com の形式) が必要になります。
- パートナー センターのゲーム セットアップ/ID の詳細セクションからのゲームの Xbox サービス構成 ID (SCID)。
- 同じ場所にあるゲームのパッケージ ファミリ名 (PFN)。
- 認定チームが提供する、セーブデータを取得するアカウントのゲーマータグ。
- 証明書が使用していたサンドボックス名: CERT または CERT.DEBUG。
- 保存を適用するテスト アカウントの電子メール アドレス。
Xbox Live から保存 BLOB を取得する
GDK コマンド プロンプト ウィンドウを開く
xbldevaccount を使用して、前提条件 #2 からパートナー センター アカウントにサインインします。次に例を示します。
C:\temp>xbldevaccount signin --name billyray@mylovelygamecompany.com
別のテナントにゲストとしてサインインしている場合は、次のように --tenant オプションを使用します。
C:\temp>xbldevaccount signin --name billyray@mylovelygamecompany.com --tenant sombodyelseslovelygamecompany.onmicrosoft.com
XblConnectedStorage コマンド ラインを使用して、Xbox Live からセーブデータを取得します。次に例を示します。
C:\temp>xblconnectedstorage --scid 00000000-0000-0000-0000-000012345678 -s CERT --gamertag "2 SomeCertAccount" --output .\GameSaveFrom2SomeCertAccount.xml Using Dev account billyray@mylovelygamecompany.com from WindowsDevCenter Operation complete. Downloaded 4 save containers to .\GameSaveFrom2SomeCertAccount.xml.
すべてが成功すると、指定した XML ファイルに保存 BLOB が作成されるはずです。 内部に Base64 でエンコードされたバイナリ BLOB が表示されるはずです。 ファイル形式の詳細については、こちら (NDA トピック)認可が必須です を参照してください。
テスト アカウント (コンソール) に保存を適用する
xbstorage ドキュメントの指示に従って、xml ファイルをストレージ スペースに適用します。次に例を示します。
C:\temp>xbstorage import .\GameSaveFrom2SomeCertAccount.xml /msa:MLGC-MyTestAccount0000@xboxtest.com /replace /verbose
テスト アカウント (PC) に保存を適用する
XGameSaveUtil ドキュメントの指示に従って、xml ファイルをストレージ スペースに適用します。次に例を示します。
C:\temp>xgamesaveutil import .\GameSaveFrom2SomeCertAccount.xml /pfn:mygame_xxxxxx /replace
注意事項
タイミング
認証をテストする必要がある方法により、問題が発生した後もアカウントが使用され続ける可能性があります。 認定レポートは通常、テストの完了後に発行されます。
これにより、Xbox Live の保存内容が、問題が発生した時点で使用されていたものよりも最新になる可能性があります。
Xblconnectedstorage 出力ディレクトリ
--output を xblconnectedstorage.exe に指定しない場合、現在の作業ディレクトリに出力しようとします。 GDK コマンド プロンプトを起動したばかりの場合、それは Windows システム ディレクトリである可能性が高いため、xblconnectedstorage は失敗します。 明示的に、書き込み可能な場所を指す --output パラメータを指定することをお勧めします。
モダン ゲーマータグ
この手順は現在、最新のゲーマータグではテストされていません。