ゲームでは、XStore API を使用して、ゲームとその関連製品 (アドオンなど) に関連付けられている、ライセンスと権利に対する操作が実行されます。
XStore 操作の多くが、Microsoft Store サービスによって管理されるゲームに関する情報を操作します。
注意
このページは、以前のバージョンから大幅に更新されています。
2023 年 6 月の時点で、ほとんどの*XStore API テストでは、ライセンス可能なビルド (contentIdOverride など) を設定し、各アカウントにゲームへの権利を付与する必要はなくなりました。
開発サンドボックスでコマースをテストするときは、1 つのテスト アカウントですべての購入を同じサンドボックスで行う必要があります。 テスト アカウントを別のサンドボックスに切り替えて追加のアイテムを購入すると、両方のサンドボックスのアカウントに対して予期しないクエリ結果が発生します。 これは、購入のライセンスと情報が、アイテムが単一のアカウントで購入された最初のサンドボックスに関連付けられているためです。
PC の開発サンドボックスでコマースをテストするときは、Microsoft Store アプリと Xbox アプリにサインインしているアカウントが同じであることを確認してください。 サンドボックス内の場合、Microsoft Store のアイテムに使用される資格情報は Xbox アカウントに明確に関連付けられています。 これは、すべての操作が、アクティブなサンドボックスに特化して発行された製品と対話するために重要です。 詳細については、「PC でのストア アカウントの不一致シナリオの取り扱い」を参照してください。
ほとんどの*XStore API をテストするには、ゲーム構成にパートナー センターから派生した適切な値が含まれていることを確認してください。
* 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の場合: これはパートナー センターでゲームに割り当てられているものと一致する必要があります。
本体では必須ではありませんが、パートナー センターに提出するパッケージの作成時にチェックされるため、実際は必要です。
Identity ノードの Name は [パッケージ/ID/名前] と一致する必要があります。Identity ノードの Publisher は、[パッケージ/ID/発行元] と一致する必要があります。
StoreID
これは、[ゲームのセットアップ]>[ID の詳細] にもあります。
