> ## 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 或搭配遊戲實體權杖的 Catalog API，建立並設定您的第一個 PlayFab Economy v2 虛擬貨幣。

# 設定您的第一個虛擬貨幣

<Info>
  Economy v2 現已正式推出。如需支援和意見反應，請前往 [PlayFab 論壇](https://community.playfab.com)。
</Info>

開始使用 PlayFab Economy，方法是使用 [PlayFab Services SDK](/zh-TW/services/playfab/sdks/playfab-sdk-intro) 設定您的第一個虛擬貨幣。取得實體權杖以透過 API 與您的遊戲互動之後，您會建立並設定虛擬貨幣。

## 必要條件

* [PlayFab 開發人員帳戶](https://developer.playfab.com)
* PlayFab Beta SDK (您可以在 [Postman 快速入門](/zh-TW/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections)中找到更多資訊)

## 取得遊戲實體權杖

若要透過 API 變更您的遊戲設定資料，您必須先取得遊戲實體權杖。您可以在 [Postman 快速入門](/zh-TW/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` 是貨幣代碼，可包含一到三個英數字元值
* `Title` 是向玩家顯示的顯示名稱
* `ContentType` 是 Economy 物品的分類。您必須先在 ⚙️ > Title Settings > Economy > Catalog (V2) Settings 中設定 Content Type。
* `StartDate` 是日期時間字串，代表貨幣對玩家可見的時間 (預設為建立時間)

## 疑難排解

* 遺失/已過期的實體權杖
  * 如果您嘗試呼叫 `CreateDraftItem` 並收到 `401: Unauthorized` 錯誤，您可能忘記取得遊戲實體權杖，或該權杖可能已過期
* 不支援內容類型 `''`
  * 如果您嘗試呼叫 `CreateDraftItem` 並收到包含上述訊息的 `CatalogBadRequest`，您必須先在 Game Manager 中遊戲設定頁面下的目錄設定索引標籤中建立內容類型

## 後續步驟

現在您已設定第一個虛擬貨幣，您可以：

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

- [快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [物品 (舊版 Economy) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy (舊版) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/quickstart.md)
- [玩家庫存快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [詐騙防範快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)