用戶端功能
GDK 可讓遊戲實作多種類型的遊戲內附加元件和產品類型,例如消耗性產品、耐久性產品 (可下載內容)、訂閱、套件組合和試用版。XStore API 集提供從用戶端查詢、宣傳和管理這些產品所需的功能。如需功能完整的遊戲內商店範例,請參閱 GDK 遊戲內商店範例。 Fundamentals 一節中的下列文章涵蓋這些 API 和案例:- 基本商店作業 - 查詢可供銷售的項目以及使用者擁有的項目
- 如何使用沒有套件的耐久性產品 - 使用沒有獨立下載套件的耐久性產品。
- 管理和授權可下載內容 (DLC) - 使用具有下載套件的傳統耐久性產品。
- 以消耗性產品為基礎的生態系統 - 在您的遊戲中設定和配置以消耗性產品為基礎的營利模式。
- 為您的遊戲實作試用版 - 實作內建於遊戲中的試用版。
- 套件組合和季票 - 使用套件組合和季票,透過您的產品為客戶提供價值並提升參與度。
- 遊戲的產品共用模型 - XBOX 主機和 Windows PC 上 GDK 遊戲的授權模型,以及使用者之間的共用如何套用。
伺服器端功能
支援用戶端 API 並允許服務對服務呼叫的 Microsoft Store 服務分為下列服務:- Collections - 提供使用者擁有或有權使用之產品的相關資訊,並履行消耗性產品。也可供授權的合作夥伴用來偵測 Game Pass 訂閱狀態。
- Clawback - 可讓合作夥伴服務偵測和管理針對已履行之消耗性產品向使用者發出的退款。
- Purchase - 可讓合作夥伴服務將免費項目新增至使用者的帳戶。
- Recurrence - 提供使用者訂閱的詳細資訊,並可讓合作夥伴服務代表使用者管理這些訂閱。
向 Microsoft Store 服務進行驗證
如需如何向 Microsoft Store 服務驗證您服務的詳細資訊,請參閱要求 User Store ID 以進行服務對服務驗證。如果您熟悉 X-token 驗證,Collections 服務確實支援 X-token。
曾使用 XDK 之開發人員的重要資訊
如果您熟悉 XDK 的商務系統,下列定義應可協助您了解對應的 GDK 服務名稱- Inventory 服務 - XDK Inventory 服務的功能 (查詢擁有權、履行消耗性產品等) 現在由 Collections 服務處理。這包括驗證擁有權和消耗性產品數量的所有伺服器對伺服器案例。雖然用於 Inventory 的 X-token 也可用於呼叫 Collections,但我們建議合作夥伴改用 Microsoft Entra ID 和 User Store ID 權杖驗證流程,以使用 Microsoft Store 服務的擴充功能。
範例:https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview - Inventory 用戶端 API - 所有與查詢項目擁有權相關的用戶端功能,現在都透過 XStore API 處理。
範例:XStoreQueryEntitledProductsAsync 會傳回目前使用者在當下有權使用的項目。 - Catalog Browse API - 所有與查詢可在遊戲內購買之產品相關的用戶端功能,現在都透過 XStore API 處理。沒有伺服器對伺服器的選項可用來查詢可在您遊戲中銷售的產品。
範例:XStoreQueryAssociatedProductsAsync 會傳回可作為遊戲內商店一部分銷售的產品。 - 試用版和授權 - 所有與試用版授權相關的用戶端功能,現在都是 XStore API 的一部分。範例:XStoreQueryGameLicenseAsync 會傳回目前遊戲的授權資訊,包括任何試用版授權資訊。如需在您自己的服務上驗證用戶端授權的功能,請參閱使用授權權杖在您的服務上驗證授權。
