次の方法で共有

Xbox 接続ストレージ ツール (XblConnectedStorage.exe)

  • [アーティクル]

Xbox 接続ストレージ ツールは、セーブ データのダウンロードに使用されます。 RETAIL を含む任意のサンドボックスからセーブ データをダウンロードできます。 これは、デバッグで再現するのが難しい問題の場合に役立ちます。

このコマンドライン ツールは Microsoft Game Development Kit (GDK) および XboxLiveTools.zip の一部です。「Xbox サービス の開発ツール」を参照してください。 バージョン 2104 以降の GDK でも使用できます。

XblConnectedStorage.exe は、ユーザーの接続ストレージ データをダウンロードするために使用されます。 Xbox サービス Connected Storage ツールを使用する前に、開発者アカウントを使用してサインインするには、Xbox 開発者アカウント ツール(XblDevAccount.exe)が必要です。

使用方法

接続ストレージ ツールを使用すると、ゲーム のセーブ データを表す XML ファイルを インポートおよびエクスポート ファイル形式 (NDA topic) でフェッチできます。 XMLファイルは、 xbstorage.exe ツール)で使用するためのものです。 これは、XML ファイルから Xbox Development Kit で使用する接続ストレージ領域にデータをインポートするために使用できます。 このツールは、gzipped セーブ データの展開を自動的に処理します。

セーブ データの XML ファイルをフェッチするには、次の 3 つの要件があります。

  1. ツール アクセス許可の読み取りアクセス許可を持つ開発者アカウント。 詳細については、[接続ストレージ ツールを使用するために必要なアクセス許可][#permissions-needed-to-use-the-tool] をご覧ください。
  2. タイトルのサービス構成 ID (SCID)。 パートナー センターで調べることができます。
  3. セーブ データをプルするユーザーのクラシック ゲーマータグ。

コマンドラインの使用方法の例。

XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe

コマンドライン オプション

--help オプションを使用して、ツールでサポートされている使用可能なコマンド ライン オプションの完全な一覧を表示します。

バージョン 2020.6.0.0 では、出力は次のようになります。

XblConnectedStorage 2020.6.0.0
Copyright (C) 2021 Microsoft Corporation
USAGE:
Downloads the Connected Storage data for this user to ./output/xbstorage.xml:
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe --output ./output/xbstorage.xml
 --sandbox TEST.0

  -c, --scid        Required. The service configuration ID (SCID) of the title

  -s, --sandbox     Required. The target sandbox for title storage

  -g, --gamertag    Required. The legacy gamertag of the player to retrieve storage for

  -o, --output      (Default: ./output/xbstorage.xml) The output file to write the xbstorage xml file to.

  --help            Display this help screen.

  --version         Display version information.

ツールを使用するために必要なアクセス許可

ユーザーとセーブ データのプライバシーを保護することは重要です。 開発者アカウントには、Xbox 接続ストレージ ツールを使用してセーブ データにアクセスするための特定のアクセス許可が必要です。 開発者アカウントのアクセス許可を表示または変更するには、次の手順に従います。

  1. Microsoft パートナー センター で [ユーザー管理] ページ を開く
  2. 表示または変更するアクセス許可を持つユーザーまたはグループを選択します
  3. [アクセス許可のカスタマイズ] リンクをクリックします
  4. アクセス許可を表示または変更する製品を選択します
  5. [Xbox Live] を選択します。
  6. [ツール アクセス] を選択する

製品のゲーム セーブ データをダウンロードするためには、"ツール アクセス"読み取りアクセス許可を持つ開発者アカウントが必要です。

エラー メッセージを理解する

500 内部サーバー エラー

このエラーは、現在の開発者アカウントにアクセス許可がない SCID/サンドボックスの組み合わせにアクセスしようとしたときに発生します。 この問題を解決する方法のガイダンスについては、このドキュメントの「ツールセクションを使用するために必要なアクセス許可」 に関するセクションを参照してください。