设置第一种虚拟货币

重要

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

使用 PlayFab 服务 SDK 设置第一个虚拟货币，开始使用 PlayFab Economy。 获取实体令牌以通过 API 与游戏交互后，需要创建并配置虚拟货币。

先决条件

• PlayFab 开发人员帐户
• PlayFab Beta SDK（可以在 Postman 快速入门中找到详细信息）

获取游戏实体令牌

若要通过 API 更改游戏配置数据，首先需要获取游戏实体令牌。 可以在 Postman 快速入门中找到详细信息

创建新的虚拟货币

若要创建新的虚拟货币，需要创建货币类型的草稿项目。

Game Manager

1. 导航到游戏管理器中的“Economy”选项卡，然后选择“目录 (V2) ”。
2. 选择“货币”，然后选择“新货币”。
3. 编辑“游戏”并添加“说明” - 例如，Diamonds、Our in-game currency of choice.。
4. 选择“保存并发布”以完成更改。
5. 在“货币”列表中观察你的货币。

REST API

调用 CreateDraftItem。 使用以下正文：

{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "diamonds"
      }
    ],
    "Title": {
      "NEUTRAL": "Diamonds"
    },
    "Description": {
      "NEUTRAL": "Our in-game currency of choice."
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
  },
  "Publish": true,
  "CustomTags": {
    "user": "{{Email}}"
  }
}

• FriendlyId 是货币代码，可以包含 1 到 3 个字母数字值
• Title 是显示给玩家的显示名称
• ContentType 是 Economy 项目的分类。 必须首先在⚙️“>游戏设置”>“Economy> 目录 (V2) 设置”中设置“内容类型”。
• StartDate 是一个日期/时间字符串，表示货币对玩家可见的时间（默认值是创建时间）

故障排除

• 实体令牌缺失/已过期
  • 如果尝试调用 CreateDraftItem 并收到 401: Unauthorized 错误，则可能忘记获取游戏实体令牌，或者它可能已过期
• 不支持内容类型''
  • 如果尝试调用 CreateDraftItem 并接收包含上述消息的 CatalogBadRequest，则需要首先在游戏管理器中游戏设置页面下的目录设置选项卡中创建内容类型

后续步骤

设置第一种虚拟货币后，可以：

1. 将货币添加到你在应用商店中销售的 PlayFab 捆绑包。
2. 使用 AddInventoryItems 让游戏服务器向玩家奖励货币。
3. 将价格分配给与货币相对应的目录项。
4. 允许玩家使用 PurchaseInventoryItems 以货币购买目录项。