GDK 商业系统
GDK 中提供的与商业相关的功能和服务支持多种货币化模型,并能够将后端服务与这些商业选项进行深度集成。 本文档概述了 GDK 文档的"商务"部分中更深入地介绍的这些系统和选项。
客户端功能
GDK 允许游戏实现多种类型的游戏内加载项和产品类型,例如易耗品、耐用品(可下载内容)、订阅、捆绑包和试用版。 XStore API 集提供从客户端查询、播发和管理这些产品所需的功能。 有关功能齐全的游戏内应用商店的示例,请参阅 GDK 游戏内应用商店示例。
"基础知识"部分下的以下文章介绍了以下 API 和方案:
基本存储操作 - 查询可销售的内容以及用户拥有的内容
如何在没有程序包的情况下使用耐用品 - 使用没有单独下载包的耐用品。
管理和许可证可下载内容 (DLC) - 将传统耐用品与下载包配合使用。
基于易耗品的生态系统 - 在游戏中设置和配置基于易耗品的货币化模型。
实现游戏试用- 实现内置于游戏中的试用版。
捆绑包和季度通行证 - 使用捆绑包和季度通行证为客户提供产品价值和参与度。
游戏的产品共享模型 - Xbox 主机和 Windows 电脑上 GDK 游戏的许可模型,以及如何应用用户之间的共享。
服务器端功能
支持客户端 API 并允许服务到服务调用的Microsoft Store服务拆分为以下服务:
集合 - 提供有关用户拥有或有权使用和履行易耗品的产品的信息。 还可用于检测授权合作伙伴的Game Pass订阅状态。
恢复 - 允许合作伙伴服务检测和管理为已完成的易耗品向用户颁发的退款。
购买 - 允许合作伙伴服务向用户帐户添加免费项目。
重复周期 - 提供有关用户订阅的详细信息,并允许合作伙伴服务代表用户管理这些订阅。
使用Microsoft Store服务进行身份验证
有关如何使用Microsoft Store服务对服务进行身份验证的详细信息,请参阅 请求用户Store ID进行服务到服务身份验证。
注意
如果你熟悉 XSTS 令牌身份验证,集合服务确实支持 XSTS 令牌。 但是,其他Microsoft Store服务则不会。 由于其他服务中提供了有价值的功能,我们现在建议合作伙伴将其服务器到服务器的身份验证流转换为Microsoft Entra ID 和 UserStoreId 流。
若要帮助简化身份验证流并调用Microsoft Store服务,请查看 GitHub 上的 Microsoft.StoreServices 项目和示例。 Microsoft.StoreServices 库将帮助管理身份验证密钥,并提供包装器 API 来调用Microsoft Store服务来管理产品。 示例项目重点介绍服务如何使用 Microsoft.StoreServices 库、用于管理易耗品、协调已退款购买、续订过期凭据等的示例逻辑。 本示例随附分步配置指南,用于在电脑上或通过 Azure 设置示例服务。
面向使用 XDK 的开发人员的关键信息
如果你熟悉 XDK 中的商业系统,以下内容将帮助你了解所谓的等效 GDK 服务
清单服务 - XDK 的清单服务(查询所有权、履行易耗品等)的功能现在由集合服务处理。 这包括用于验证所有权和易耗品数量的所有服务器到服务器方案。 尽管用于清单的 XSTS 令牌可用于调用集合,但我们建议合作伙伴移动到Microsoft Entra ID 和 User Store Id 令牌身份验证流,以使用 Microsoft Store Services 的扩展功能。
例如: https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview清单客户端 API - 与查询项所有权相关的所有客户端功能现在都通过 XStore API 进行处理。
例如: XStoreQueryEntitledProductsAsync 将返回当前用户此时有权使用的项。目录浏览 API - 与查询可用产品以购买游戏内产品相关的所有客户端功能现在都通过 XStore API 进行处理。 没有服务器到服务器选项用于查询要在游戏中销售的可用产品。
例如: XStoreQueryAssociatedProductsAsync 将返回能够作为游戏内商店的一部分出售的产品。Trials and Licenses - 与试用许可证相关的所有客户端功能现在是 XStore API 的一部分。 例如: XStoreQueryGameLicenseAsync 将返回当前游戏的许可证信息,包括任何试用许可证信息。 若要在自己的服务上验证客户端许可证,请参阅使用许可证令牌验证服务上的许可。