> ## 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 以三個基礎要素為基礎來簡化此體驗：貨幣、物品和庫存。

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

1. 設定虛擬貨幣。
2. 建立物品。
3. 將物品新增至玩家的庫存。
4. 了解自訂經濟的後續步驟。

## 設定虛擬貨幣

虛擬貨幣是遊戲內經濟的基礎。玩家和角色可以獲得這些貨幣，然後用來購買或交易物品。

物品的成本可以是虛擬貨幣或真實貨幣。每個遊戲都可以支援多種任意的虛擬貨幣，讓您的遊戲能彈性實作任何交換媒介 (例如金幣、寶石、愛心或星際點數)。

若要建立虛擬貨幣：

1. 開啟 **Game Manager**，然後在左側列選取 **Economy**。
2. 選取 **Currency** 索引標籤。
3. 選擇 **New Currency** 並變更下列欄位 (如下圖所示)：
   * 將 **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" />

既然已設定貨幣，就可以為目錄物品指派以該虛擬貨幣計算的價格。

## 建立物品

許多遊戲會提供物品給玩家購買，例如盾牌、關卡解鎖或能量提升道具。這些物品會在目錄中指定。玩家必須先由您建立物品來填入目錄，才能從目錄購買物品。

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

1. 在左側列選取 **Economy**，然後選取 **Catalogs** 索引標籤。

2. 選擇 **NEW CATALOG** 按鈕，並輸入 **main** 作為 **Catalog version**。系統會自動新增識別碼為 **One** 的物品。

3. 選取 **One** 並變更下列欄位 (如下圖所示)：

   * 將 **Item ID** 設定為 **apple**。
   * 將 **Display name** 設定為 **apple**。
   * 將 **Description** 設定為 **Perfectly normal apple**。

4. **PRICES** 區段位於表單底部。

5. 將蘋果以金幣 (**GD**) 計算的價格設定為 **5**。

6. 選取 **SAVE ITEM** 按鈕。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b07c6dc306edea1d41c9a4d73f5c3915" alt="編輯或儲存貨幣" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/create-item.png" />

## 將物品新增至玩家庫存

PlayFab 的 [Player Item Management (Server)](xref:titleid.playfabapi.com.server.playeritemmanagement) 和 [Player Item Management (Client)](xref:titleid.playfabapi.com.client.playeritemmanagement) API 支援許多物品購買策略：

* 真實貨幣
* 虛擬貨幣
* 根據購買其他物品而觸發的物品授與
* 鎖定 (搭配可掠奪/可購買的鑰匙) 和未鎖定的箱子
* 隨機結果表
* 根據遊戲內付費或免費事件授與的不可購買物品
* 以及更多案例，特別是搭配[使用 Azure Functions 的 PlayFab CloudScript](/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)

**以虛擬貨幣購買物品，將其新增至玩家的庫存。**

1. 在您的遊戲中，以已獲得虛擬貨幣的玩家身分登入。(如有需要，[將虛擬貨幣提供給玩家](/zh-TW/services/playfab/economy-monetization/economy/items/quickstart#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) 購買 **apple**，並在要求中使用下列參數值：

   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency  = "GD"`
   * `Price =  5`

5. 最後，呼叫 [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) 並查看該方法的結果。在玩家 `Inventory` 的物品陣列中，您應該會看到一個蘋果！

## 自訂經濟的後續步驟

當您擁有包含以虛擬貨幣支援之物品的目錄後，就可以透過下列方式讓您的經濟更加活躍：

* **真實世界購買**：我們的[開始使用 PlayFab、Unity IAP 和 Android](/zh-TW/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android) 和[非收據付款處理](/zh-TW/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing)教學課程可協助您將虛擬經濟與現有商店連結。
* **善用您的目錄**：建立組合、容器和掉落表。如需詳細資訊，請參閱我們的[目錄](/zh-TW/services/playfab/economy-monetization/economy/items/catalogs)教學課程。
* **使用物品屬性**：定義多個價格，並指定可堆疊、可交易和限量版的[物品](/zh-TW/services/playfab/economy-monetization/economy/items)。
* **設定獨特的遊戲內商人或特賣活動**：使用[商店和特賣](/zh-TW/services/playfab/economy-monetization/economy/tutorials/stores-and-sales)。
* **建立一些玩家區段並使用商店**：無論玩家處於遊戲生命週期的哪個階段，都能為他們推送不同的物品和組合優惠。如需範例，請參閱我們的[為玩家區段自訂商店](/zh-TW/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments)教學課程。
* **收集經濟資料**：讓您能夠使用 PlayFab [報告](/zh-TW/services/playfab/data-analytics/learn-data/reports/overview)來改善及反覆修改遊戲。


## Related topics

- [物品 (舊版 Economy) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/items/quickstart.md)
- [商店 (舊版 Economy) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [實體快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [錦標賽與排行榜快速入門](/zh-TW/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)