跳轉到主要內容

設定您的第一個虛擬貨幣

Economy v2 現已正式推出。如需支援和意見反應,請前往 PlayFab 論壇。
開始使用 PlayFab Economy,方法是使用 PlayFab Services SDK 設定您的第一個虛擬貨幣。取得實體權杖以透過 API 與您的遊戲互動之後,您會建立並設定虛擬貨幣。

必要條件

取得遊戲實體權杖

若要透過 API 變更您的遊戲設定資料,您必須先取得遊戲實體權杖。您可以在 Postman 快速入門中找到更多資訊

建立新的虛擬貨幣

若要建立新的虛擬貨幣,您必須建立類型為 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。使用下列本文:

  • FriendlyId 是貨幣代碼,可包含一到三個英數字元值
  • Title 是向玩家顯示的顯示名稱
  • ContentType 是 Economy 物品的分類。您必須先在 ⚙️ > Title Settings > Economy > Catalog (V2) Settings 中設定 Content Type。
  • StartDate 是日期時間字串,代表貨幣對玩家可見的時間 (預設為建立時間)

疑難排解

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

後續步驟

現在您已設定第一個虛擬貨幣,您可以:
  1. 將貨幣新增至您在應用程式商店中販售的 PlayFab 組合。
  2. 讓遊戲伺服器使用 AddInventoryItems 將貨幣獎勵給您的玩家。
  3. 為目錄物品指派對應於該貨幣的價格。
  4. 允許玩家使用 PurchaseInventoryItems 以該貨幣購買目錄物品。
最後修改於 2026年10月6日