客户端功能
GDK 允许游戏实现多种类型的游戏内附加内容和产品类型，如消耗品、耐用品（可下载内容）、订阅、捆绑包和试玩。XStore API 集合提供了从客户端查询、宣传和管理这些产品所需的功能。有关功能完整的游戏内商店示例，请参阅 GDK In-Game Store 示例。 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 浏览 API - 与在游戏中查询可购买产品相关的所有客户端功能现在通过 XStore API 处理。没有查询游戏中可销售产品的服务到服务选项。
示例：XStoreQueryAssociatedProductsAsync 返回可作为游戏内商店的一部分销售的产品。 - 试玩和许可证 - 与试玩许可证相关的所有客户端功能现在都是 XStore API 的一部分。示例：XStoreQueryGameLicenseAsync 返回当前游戏的许可证信息，包括任何试玩许可证信息。有关如何在你自己的服务上验证客户端许可证的能力，请参阅使用许可证令牌在你的服务上校验授权。