启用 XStore 开发和测试

游戏将使用 XStore API 对与游戏及其相关产品(例如加载项)关联的许可证和权利执行操作。 许多 XStore 操作操作操作有关由Microsoft Store服务管理的游戏的信息。

注意

与先前版本相比,此页面已经过大量更新。 从 2023 年 6 月开始,大多数*XStore API 测试不再需要将版本设置为可许可(例如 contentIdOverride),并且对于每个帐户,都设置为具有游戏权利。

在开发沙盒中测试商务功能时,必须在同一沙盒中完成单个测试帐户上的所有购买。 将测试帐户切换到另一个沙盒并购买其他项目将导致两个沙盒中帐户的意外查询结果。 这是因为购买的许可证和信息与为单个帐户购买商品的第一个沙盒关联。

在电脑上的开发沙盒中测试商务功能时,请确保登录到 Microsoft Store 应用和 Xbox 应用的账户相同。 在沙盒中时,用于购买 Microsoft Store 商品的凭据将绑定到特定 Xbox 帐户。 若要确保所有操作都与专门发布到活动沙盒的产品进行交互,这一点至关重要。 有关详细信息,请参阅在电脑上处理不匹配的商店帐户的方案

为了测试大多数*XStore API,请确保游戏配置包含从合作伙伴中心派生的相应值。

* 与许可相关的 API(如 XStoreQueryGameLicenseAsync)需要完全授权的上下文才能正常工作。 有关完整详细信息,请参阅“启用许可证测试”。

将游戏 ID 应用于 MicrosoftGameConfig

首先,请在合作伙伴中心发布游戏和加载项。

然后,在游戏的配置文件中,确保这些值与已配置的游戏的值匹配:

  <Identity
    Name="41336MicrosoftATG.InGameStoreXS"
    Publisher="CN=A4954634-DF4B-47C7-AB70-D3215D246AF1"
    Version="2023.5.5.0" />
  <StoreId>9NTL0QDWZ4FS</StoreId>
  <MSAAppId>000000004C2690C8</MSAAppId>
  <TitleId>62ab3c24</TitleId>

标识

此内容位于合作伙伴中心的“游戏设置>标识详细信息”下。

在电脑上,严格要求此内容与在合作伙伴中心分配给游戏的内容完全相同。

虽然主机不需要它,但在实践中,它应在创建程序包以提交到合作伙伴中心时进行检查。

游戏设置>标识详细信息,圈出包/标识/名称和发行商

Identity 节点中的 Name,需要匹配 包/标识/名称; Identity 节点中的 Publisher 需要与 包/标识/发布服务器 匹配。

StoreID

还可通过“游戏设置”>“标识详细信息”找到此信息

游戏设置>标识详细信息,在 URL 和页面上圈出 StoreId

另请参阅

商业概述

合作伙伴中心的初始配置

启用许可证测试

为 Microsoft Store 操作正确切换沙盒

XStore API 参考