XStore の開発とテストの有効化

ゲームでは、XStore API を使用して、ゲームとその関連製品 (アドオンなど) に関連付けられている、ライセンスと権利に対する操作が実行されます。 XStore 操作の多くが、Microsoft Store サービスによって管理されるゲームに関する情報を操作します。

注意

このページは、以前のバージョンから大幅に更新されました。 2023 年 6 月の時点で、ほとんどの API テストでは*XStore 、ビルドをライセンス可能 (contentIdOverride など) に設定し、各アカウントに対してゲームの権利を持つ必要がなくなりました。

開発サンドボックスでコマースをテストするときは、1 つのテスト アカウントですべての購入を同じサンドボックスで行う必要があります。 テスト アカウントを別のサンドボックスに切り替えて追加のアイテムを購入すると、両方のサンドボックスのアカウントに対して予期しないクエリ結果が発生します。 これは、購入のライセンスと情報が、アイテムが単一のアカウントで購入された最初のサンドボックスに関連付けられているためです。

PC の開発サンドボックスでコマースをテストするときは、Microsoft Store アプリと Xbox アプリにサインインしているアカウントが同じであることを確認してください。 サンドボックス内の場合、Microsoft Store のアイテムに使用される資格情報は Xbox アカウントに明確に関連付けられています。 これは、すべての操作が、アクティブなサンドボックスに特化して発行された製品と対話するために重要です。 詳細については、「PC でのストア アカウントの不一致シナリオの取り扱い」を参照してください。

ほとんどの API*XStore テストするには、ゲーム構成にパートナー センターから派生した適切な値が含まれていることを確認します。

* XStoreQueryGameLicenseAsync などのライセンスに関連する API では、正しく機能するには、完全にライセンスされたコンテキストが必要です。詳細については、「ライセンス テストの有効化」を参照してください。

MicrosoftGameConfig にゲーム ID を適用する

まず、ゲームとアドオンを パートナー センターに公開します。

次に、ゲームの構成ファイルで、設定したタイトルの値と一致する値を確認します:

  <Identity
    Name="41336MicrosoftATG.InGameStoreXS"
    Publisher="CN=A4954634-DF4B-47C7-AB70-D3215D246AF1"
    Version="2023.5.5.0" />
  <StoreId>9NTL0QDWZ4FS</StoreId>
  <MSAAppId>000000004C2690C8</MSAAppId>
  <TitleId>62ab3c24</TitleId>

識別

パートナー センターの [ゲームのセットアップ] > [ID の詳細] にあります。

PCの場合: これはパートナー センターでゲームに割り当てられているものと一致する必要があります。

本体では必須ではありませんが、パートナー センターに提出するパッケージの作成時にチェックされるため、実際は必要です。

ゲームのセットアップ > パッケージ/ID/名前と発行元を丸で囲んだ ID の詳細

Identity ノードの Name[パッケージ/ID/名前] と一致する必要があります。Identity ノードの Publisher は、[パッケージ/ID/発行元] と一致する必要があります。

StoreID

これは、ゲームのセットアップ> ID の詳細にも記載されています

ゲームのセットアップ > URL とページで丸で囲まれた StoreId を含む ID の詳細

関連項目

コマースの概要

パートナー センターでの初期構成

ライセンス テストの有効化

ストア操作のためにサンドボックスを適切に切り替える

XStore API リファレンス