Skip to main content
XStore API 是 Microsoft Store 商务在 XBOX 和基于 GDK 构建的 PC 游戏上的运行时端。加上合作伙伴中心(在其中建模你的产品)和 Microsoft Store 服务到服务 (S2S) REST API(你的后端在其中查询并授予权益),它们共同为基础游戏、DLC、试玩、消耗品、订阅和捆绑包提供了完整的商务平台。 本节参照 Microsoft Learn 上的主题布局,涵盖你设计、集成、测试和运营游戏 Store 商务所需的全部内容。
正在寻找 Microsoft Store 服务到服务 REST 参考(collections、purchase、clawback、grant、recurrences)?它位于 API 选项卡下的 Microsoft Store REST API

本节内容

入门

概述、产品类型、合作伙伴中心设置、测试、授权和故障排除。

基础知识

商店基本操作、DLC、试玩、消耗品、捆绑包、DWOB 以及更新。

从你的服务管理

对服务进行身份验证、查询权益、订阅、退款以及 User Store ID。

PC 特有注意事项

DRM、许可证令牌、商店账号不匹配的处理,以及沙盒切换。

Microsoft Store REST API

v8/v9 collections、purchase、clawback、grant 和 recurrences 端点的参考。完整参考现位于 API 选项卡下的 Microsoft Store REST API

系列游戏中心

将多个产品归入同一个 Store 系列中心。

全景:各部分如何协同工作

  • 合作伙伴中心 — 你在其中创建产品(基础游戏、附加内容、捆绑包、季票、订阅、消耗品),定义定价与可用性,并分配标识符(StoreIdProduct IDBigIdSKU ID)。
  • MicrosoftGame.config — 随游戏包一起发布,通过 TitleIdStoreIdMSAAppId 将运行的可执行文件与 Store 产品绑定。
  • XStore 运行时 API (XStore*) — 从游戏发起的客户端调用,用于枚举产品、查询许可证与权益、显示购买 UI,以及报告消耗品履约。
  • XPackage API (XPackage*) — 挂载并授权可选包(DLC)、安装区块,并观察包状态变化。
  • Microsoft Store S2S REST API — 你的后端调用的服务端端点,用于权威地查询权益、履约消耗品、发放产品、查找订阅以及处理退款/追索。
  • User Store ID (UserStoreId) — 一种短期密钥,你的游戏通过 XUserGetTokenAndSignatureAsync(或 XStoreGetUserCollectionsIdAsync / XStoreGetUserPurchaseIdAsync)获得,然后交给你的服务,让服务可以代表该用户调用 Store。

客户端与服务

几乎每种 Store 场景都同时有 客户端(XStore)和 服务端 (S2S REST) 路径。使用客户端处理实时 UX(显示购买按钮、解锁内容、上报一次消耗品消费);当权威性重要时使用服务端(例如:履约一次必须在游戏重装后仍生效的虚拟货币消费、发放促销物品、检测 Game Pass、处理退款)。 一个可靠的模式:
  1. 客户端检测到购买或消费并显示即时 UX。
  2. 客户端向你的服务发送 UserStoreId。
  3. 服务调用 Store S2S API 确认权益或履约消耗品,并更新你的记录数据库。

下一步

如果你不熟悉 XStore,请从 GDK 商务系统概述 开始,然后阅读选择合适的产品类型
最后修改于 2026年8月24日