> ## 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) 快速入門

> 在 PlayFab 舊版 Economy (v1) 中建立目錄物品的快速入門，包括物品屬性、虛擬貨幣，以及將物品授與給玩家。

# 物品快速入門 (舊版 Economy)

<Info>
  Economy v1 API 處於維護模式，不會再獲得任何新功能，只會修正錯誤。\*\*在可預見的未來，v1 API 將持續維護。\*\*請參閱 [Economy v2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview)以深入了解下一版的 PlayFab Economy！
</Info>

物品快速入門為您提供遊戲內經濟的基本要素：虛擬貨幣、目錄、物品和購買。

在本快速入門中，您將會：

* 為遊戲設定虛擬貨幣。
* 將虛擬貨幣提供給玩家。
* 將物品新增至遊戲內目錄。
* 使用 PlayFab API 以虛擬貨幣從目錄購買物品。
* 使用 Game Manager 中的資訊確認購買成功。

## 設定虛擬貨幣

PlayFab 支援具有多種貨幣和物品的強大遊戲經濟。

若要存取這些功能並建立虛擬貨幣：

1. 開啟 **Game Manager**，然後在左側列選取 **Economy**。
2. 選取 **Currency** 索引標籤，然後選取 **New Currency** (開啟如下所示的 **New Currency** 畫面)。
3. 若要建立虛擬貨幣，請編輯下列欄位：
   * 將 **Currency code (2 uppercase characters)** 設定為 **GD**。
   * 將 **Display name** 設定為 **Gold**。
4. 選取 **SAVE CURRENCY**。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="儲存新貨幣" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

## 將虛擬貨幣提供給玩家

您可以直接將虛擬貨幣提供給玩家。舉例來說，讓我們使用 Game Manager 為玩家新增金錢：

1. 在左側列選取 **Players**，然後選取玩家的 **ID**。
2. 前往玩家的 **Virtual Currency** 索引標籤。
3. 選擇 **GD** 貨幣 (開啟如下所示的 **Modify Virtual Currency** 畫面)。
4. 將 **Amount** 變更為 **100**。
5. 選取 **SAVE VIRTUAL CURRENCY**。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-players-modify-virtual-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=5d2fe1627373acec744bdc1b9eee490a" alt="修改貨幣" width="1200" height="698" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-players-modify-virtual-currency.png" />

<Tip>
  讓用戶端能夠呼叫 [AddUserVirtualCurrency](xref:titleid.playfabapi.com.client.playeritemmanagement.adduservirtualcurrency) API 可能會有危險。如需對特定 API 設定限制的相關資訊，請參閱 [API 存取原則](/zh-TW/services/playfab/api-references/api-access-policy)。
</Tip>

現在玩家擁有 100 金幣。他們可以用來做什麼？購買物品！

## 將物品新增至遊戲內目錄

*有錢卻不能花，就沒有意義了！*

您可以建立與遊戲發行平台或主要版本號碼對應的目錄 (物品集合)，任何方式皆可。

<Tip>
  我們不建議建立多個目錄來區分物品類型。您可以使用類別、標籤和商店更有效地篩選物品。
</Tip>

若要建立包含物品的目錄：

1. 在左側列選取 **Economy**，然後選取 **Catalogs** 索引標籤。
2. 選取 **New Catalog** 按鈕，並輸入 **main** 作為 **Catalog version**。系統會自動新增識別碼為 **One** 的物品。
3. 選取 **One** (開啟如下所示的 **Edit Catalog Item** 畫面)。編輯下列欄位：
   * 將 **Item ID** 設定為 **apple**。
   * 將 **Display name** 設定為 **apple**。
   * 將 **Description** 設定為 **Perfectly normal apple**。

表單底部有 **PRICES** 區段，您可以在此定義物品以遊戲虛擬貨幣計算的價格。

1. 將蘋果以金幣 (**GD**) 計算的價格設定為 **5**。
2. 選取 **SAVE ITEM**。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-edit-catalog-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ae4198cca873fbbc16663f5f7b827423" alt="新增至目錄" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-edit-catalog-item.png" />

## 使用虛擬貨幣購買物品

讓我們使用 PlayFab API 在您的遊戲中進行購買。

1. 以獲得 100 金幣虛擬貨幣的玩家身分登入 (如[將虛擬貨幣提供給玩家](#giving-virtual-currency-to-a-player)中所述)。
2. 在要求中使用下列參數呼叫 [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems)：
   * `CatalogVersion = "main"`
3. 確認結果中的 `Catalog` 包含 **GD** 價格為 **5** 的 **apple**。
4. 在要求中使用下列參數值呼叫 [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) 來購買蘋果：
   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency = "GD"`
   * `Price = 5`
5. 最後，呼叫 [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) 並查看該方法的結果。在玩家庫存的物品陣列中，您應該會看到一個蘋果！

## 確認購買成功

若要在 Game Manager 中確認購買：

1. 從左側列選取 **Players** 以開啟 **Players** 索引標籤。
2. 選取購買物品之玩家的 **ID**。

若要確認：

* 開啟 **PlayStream** 索引標籤。您應該會看到 [Player virtual currency item purchased](/zh-TW/services/playfab/api-references/events/Player/player-vc-item-purchased) 事件。
* 開啟 **Inventory** 索引標籤。庫存現在應該包含一個蘋果。您也可以使用 **Inventory** 索引標籤上的功能撤銷該物品，或授與玩家\_更多\_蘋果。
* 開啟 **Virtual Currency** 索引標籤。玩家應該只剩下 95 金幣。


## Related topics

- [Economy (舊版) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/quickstart.md)
- [商店 (舊版 Economy) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [玩家庫存快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [Economy v2 虛擬貨幣快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart.md)