クライアント側の機能
GDK では、ゲームは消費型、耐久型 (ダウンロード可能コンテンツ)、サブスクリプション、バンドル、体験版など、複数の種類のゲーム内アドオンと製品タイプを実装できます。XStore API セットは、これらの製品をクライアント側から照会、宣伝、管理するために必要な機能を提供します。完全に機能するゲーム内 Store の例については、GDK In-Game Store サンプルを参照してください。 基本セクションの以下の記事では、これらの API とシナリオについて説明しています。- 基本的な Store 操作 - 販売可能なものとユーザーが所有するものを照会します
- パッケージのない耐久型の使用方法 - 個別のダウンロード パッケージを持たない耐久型の使用方法
- ダウンロード可能なコンテンツ (DLC) の管理とライセンス供与 - ダウンロード パッケージ付きの従来型の耐久型を使用
- 消費型ベースのエコシステム - ゲーム内で消費型ベースの収益化モデルを設定して構成
- ゲームの体験版の実装 - ゲームに組み込まれた体験版を実装
- バンドルとシーズン パス - バンドルとシーズン パスを使用して顧客に価値とエンゲージメントを提供
- ゲームの製品共有モデル - XBOX コンソールと Windows PC の両方における GDK ゲームのライセンス モデルと、ユーザー間の共有の適用方法
サーバー側の機能
クライアント側 API をサポートしサービス間呼び出しを可能にする Microsoft Store サービスは、以下のサービスに分割されます。- Collections - ユーザーが所有するか使用する権利のある製品に関する情報を提供し、消費型製品を履行します。また、承認済みのパートナーで Game Pass サブスクリプション状態を検出するためにも使用できます。
- Clawback - 既に履行された消費型に対してユーザーに発行された返金をパートナー サービスが検出および管理できるようにします。
- Purchase - パートナー サービスがユーザーのアカウントに無料アイテムを追加できるようにします。
- Recurrence - ユーザーのサブスクリプションに関する詳細情報を提供し、パートナー サービスがユーザーの代わりにそれらのサブスクリプションを管理できるようにします。
Microsoft Store サービスでの認証
Microsoft Store サービスでのサービスの認証方法の詳細については、サービス間認証用のユーザー Store ID を要求するを参照してください。X-Token 認証に慣れている場合、Collections サービスは X-Token をサポートしています。
XDK を使用した開発者向けの重要情報
XDK のコマース システムに慣れている場合、次の定義は同等の GDK サービスの名前を把握するのに役立ちます。- Inventory Service - XDK の Inventory サービスの機能 (所有権の照会、消費型の履行など) は、現在 Collections Service によって処理されます。これには、所有権と消費型数量を検証するためのすべてのサーバー間シナリオが含まれます。Inventory 用の X-Token は Collections の呼び出しに機能しますが、Microsoft Store サービスの拡張機能を使用するために、パートナーは Microsoft Entra ID とユーザー Store ID トークンの認証フローに移行することをお勧めします。
例: https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview - Inventory Client API - アイテムの所有権照会に関連するクライアント側機能はすべて、現在は XStore API を通じて処理されます。
例: XStoreQueryEntitledProductsAsync は、その時点で現在のユーザーが使用する権利のあるアイテムを返します。 - Catalog Browse API - ゲーム内で購入可能な製品の照会に関連するクライアント側機能はすべて、現在は XStore API を通じて処理されます。タイトル内で販売する製品を照会するためのサーバー間オプションはありません。
例: XStoreQueryAssociatedProductsAsync は、ゲーム内 Store の一部として販売できる製品を返します。 - 体験版とライセンス - 体験版ライセンスに関連するクライアント側機能はすべて、現在 XStore API の一部です。例: XStoreQueryGameLicenseAsync は、体験版ライセンス情報を含む現在のゲームのライセンス情報を返します。独自のサービス上でクライアント側ライセンスを検証する機能については、ライセンス トークンを使用してサービスでライセンスを検証するを参照してください。