通过

防欺诈快速入门

  • 项目

重要

Economy v2 现已正式发布。 有关支持和反馈，请转到 PlayFab 论坛。

本快速入门将帮助你在 Microsoft Store（Windows 10/11、Xbox、Android）上运行收据验证。

先决条件

PlayFab Economy v2 快速入门将帮助你设置并准备好执行收据验证。

Microsoft Store 市场收据验证

若要使用兑换 API，首先请在使用的任何市场（Apple Store、Steam、Google Play 等）中设置产品 ID 和价格。 最初，所有产品都是无特征的，是玩家可以购买的数字条目，但在 PlayFab 中没有意义。

若要为这些条目赋予意义，我们需要在 PlayFab 目录中镜像它们。 镜像它们会将无特征实体转换为目录捆绑包。 在新服务中调用 RedeemMicrosoftStoreInventoryItems 时，我们会在目录中查找匹配的捆绑包以授予实体玩家的虚拟清单。

通过添加 AlternateId，每个捆绑包都可以关联到一个或多个合作伙伴市场产品。 AlternateId 是 PlayFab 与任何外部 IAP 市场之间的关联。 当游戏为某个给定玩家实体调用兑换时，我们会将此 ID 传递到 IAP 市场进行检查。 常规流程是：

  1. 在 Microsoft Store 中创建 1 个（或更多）真实产品/服务
  2. 为 PlayFab 中的加载项赋予 IAP 市场调用权限，然后在 Playfab 中创建与你创建的产品/服务关联的相应捆绑包
  3. 请致电 RedeemMicrosoftStoreInventoryItems

注意

与以前版本的 Playfab 不同，在新系统中，只需创建一个捆绑包产品/服务，然后将需要引用的每个市场 SKU 添加到 AlternateId 列表中。 无需为每个 IAP 市场创建新商品。

步骤 1 - 设置市场集成

需要在“加载项”部分下的 GameManager 中设置每个 IAP 市场集成，以允许 PlayFab 代表游戏调用市场。

步骤 2 - 创建用于收据验证的捆绑包

可以在 GameManager 中创建捆绑包，也可以通过调用 CreateDraftItem 创建捆绑包。 捆绑包至少需要标题、说明和商品。 在 GameManager 中，可以使用“市场映射”部分关联市场条目。

如果要使用 API 生成捆绑包，则需要在捆绑包的“alternateId”部分下添加 IAP 市场映射。 市场枚举是特定的，区分大小写；必须使用以下加载项之一：

  • Apple =“AppleAppStore”
  • Google Play = “GooglePlay”
  • 任天堂 = “NintendoEShop”
  • Microsoft = “MicrosoftStore”
  • PlayStation = “PlayStationStore”
  • Steam =“Steam”

步骤 3 - 从游戏调用兑换

游戏调用包含实体和收据详细信息的 RedeemMicrosoftStoreInventoryItems API 来“兑换”实际产品/服务，并填充相应的实体清单。 需要在调用中提供一些内容才能正常工作：

  • 在请求的标头中是必需的
    • X-EntityToken - 唯一标识 PlayFab 实体的令牌
    • 内容类型 - 应用程序/Json
  • 在请求正文中是必需的
    • CollectionsIdKey

每个 IAP 市场对发出这些调用的要求略有不同。 例如，Apple 和 GooglePlay 购买，你需要附加市场收据。

当游戏客户端启动时，首先为市场发起 PlayFab 兑换调用。 兑换调用允许 PlayFab 同步离线或游戏范围之外发生的任何潜在购买。 每当在游戏内购买市场的产品/服务时，游戏都应使用这些调用。

兑换可确保在调用兑换终结点后填充玩家实体的库存货币。

第 4 部分：购买商品

可以验证各个玩家视图中是否存在商品或货币。 在 GameManager 中，选择“玩家”，并导航到单个玩家实体。 使用“清单”选项卡可以查看和更新实体玩家的资产。

可在此处了解有关在 Microsoft 平台上变现的详细信息。