​

物品快速入門 (舊版 Economy)

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

• 為遊戲設定虛擬貨幣。
• 將虛擬貨幣提供給玩家。
• 將物品新增至遊戲內目錄。
• 使用 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。

​

將虛擬貨幣提供給玩家

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

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

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

​

將物品新增至遊戲內目錄

有錢卻不能花，就沒有意義了！ 您可以建立與遊戲發行平台或主要版本號碼對應的目錄 (物品集合)，任何方式皆可。 若要建立包含物品的目錄：

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。

​

使用虛擬貨幣購買物品

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

1. 以獲得 100 金幣虛擬貨幣的玩家身分登入 (如將虛擬貨幣提供給玩家中所述)。
2. 在要求中使用下列參數呼叫 GetCatalogItems：
   • CatalogVersion = "main"
3. 確認結果中的 Catalog 包含 GD 價格為 5 的 apple。
4. 在要求中使用下列參數值呼叫 PurchaseItem 來購買蘋果：
   • CatalogVersion = "main"
   • ItemId = "apple"
   • VirtualCurrency = "GD"
   • Price = 5
5. 最後，呼叫 GetUserInventory 並查看該方法的結果。在玩家庫存的物品陣列中，您應該會看到一個蘋果！

​

確認購買成功

若要在 Game Manager 中確認購買：

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

若要確認：

• 開啟 PlayStream 索引標籤。您應該會看到 Player virtual currency item purchased 事件。
• 開啟 Inventory 索引標籤。庫存現在應該包含一個蘋果。您也可以使用 Inventory 索引標籤上的功能撤銷該物品，或授與玩家_更多_蘋果。
• 開啟 Virtual Currency 索引標籤。玩家應該只剩下 95 金幣。