> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy v2 虚拟货币快速入门

> 使用 Game Manager 或使用 title 实体令牌的目录 API 创建和配置你的第一个 PlayFab Economy v2 虚拟货币。

# 设置你的第一个虚拟货币

<Info>
  Economy v2 现已正式发布。如需支持和反馈，请访问 [PlayFab 论坛](https://community.playfab.com)。
</Info>

通过使用 [PlayFab Services SDK](/services/playfab/sdks/playfab-sdk-intro) 设置你的第一个虚拟货币，开始使用 PlayFab Economy。在获取实体令牌以通过 API 与你的游戏交互后，你创建并配置虚拟货币。

## 先决条件

* 一个 [PlayFab 开发者账户](https://developer.playfab.com)
* PlayFab Beta SDK（你可以在 [Postman 快速入门](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections) 上找到更多信息）

## 获取 title 实体令牌

要通过 API 更改你的 title 配置数据，你首先需要获取一个 title 实体令牌。你可以在 [Postman 快速入门](/services/playfab/sdks/postman/postman-quickstart#getting-a-title-entity-token) 上找到更多信息

## 创建新的虚拟货币

要创建新的虚拟货币，你需要创建一个 Currency 类型的草稿物品。

### Game Manager

1. 在 Game Manager 中导航到 **Economy** 选项卡并选择 **Catalog (V2)**。
2. 选择 **Currency** 并选择 **New currency**。
3. 编辑 **Title** 并添加 **Description** - 例如 `Diamonds`、`Our in-game currency of choice.`。
4. 选择 **Save and publish** 以完成你的更改。
5. 在 **Currency** 列表中观察你的货币。

### REST API

调用 [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item)。使用以下正文：

```JSON theme={null}
{
  "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 物品的分类。你必须首先在 ⚙️ > Title Settings > Economy > Catalog (V2) Settings 中设置内容类型。
* `StartDate` 是一个日期时间字符串，表示货币对玩家可见的时间（默认为创建时间）

## 疑难解答

* 缺少/过期的实体令牌
  * 如果你正在尝试调用 `CreateDraftItem` 并收到 `401: Unauthorized` 错误，你可能忘记获取 title 实体令牌，或者它可能已过期
* 不支持内容类型 `''`
  * 如果你正在尝试调用 `CreateDraftItem` 并收到带有上述消息的 `CatalogBadRequest`，你需要首先在 Game Manager 中你的 title 设置页面下的目录设置选项卡中创建内容类型

## 后续步骤

现在你已经设置了第一个虚拟货币，你可以：

1. 将货币添加到你在应用商店销售的 PlayFab 捆绑包中。
2. 让游戏服务器使用 [AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items) 将货币奖励给玩家。
3. 为与该货币对应的目录物品分配价格。
4. 允许玩家使用 [PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items) 用该货币购买目录物品。


## Related topics

- [使用 Economy v2、Unity IAP 和 Android 快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android.md)
- [快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [物品（旧版 Economy）快速入门](/zh-CN/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy（旧版）快速入门](/zh-CN/services/playfab/economy-monetization/economy/quickstart.md)
- [欺诈防范快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)