PlayFab 物品與庫存概觀
Economy v2 現已正式推出。如需支援與意見反應，請前往 PlayFab 論壇。
主要概念
- 目錄 - 目錄是遊戲中所有可用物品的集合。目錄提供管理遊戲虛擬物品的簡便方式。如需詳細資訊，請參閱目錄概觀。
- 目錄物品 – 在目錄中定義的個別物品。它們可以代表任何類型的虛擬商品，例如武器、服裝、強化道具、戰利品箱等。您可以自訂屬性與行為，以符合您的遊戲設計。
- 目錄商店 - 商店可讓您針對不同用途建立多個物品清單，例如季節性活動、促銷或測試。請參閱商店。
- 組合包 - 組合包是包含其他物品參考的目錄物品。玩家購買組合包時，所參考的物品會被拆開並新增至其庫存。
- 訂閱 - 訂閱會授與耐久性商品的限時存取權。訂閱中的物品在訂閱期間內會出現在玩家的庫存中。請參閱訂閱。
- 玩家庫存集合 - 庫存是玩家在遊戲中所擁有物品的記錄。其中包含物品數量、虛擬貨幣餘額及自訂屬性的資訊。所有玩家帳戶都可以擁有一或多個庫存，稱為集合。
- 堆疊 - 堆疊可讓同一物品的多個不同執行個體存在於單一庫存中，每個執行個體都有自己的數量和自訂屬性。請參閱堆疊。
- 虛擬貨幣 - 虛擬貨幣是一種在遊戲中作為交易媒介的物品。您可以使用虛擬貨幣從目錄或商店購買物品、透過應用程式內購買實作軟性貨幣，或驅動遊戲機制。
主要 API
我們提供豐富的 API，可用於與遊戲中的物品和庫存互動。您可以使用這些 API 執行購買物品、授與物品、更新庫存、在玩家之間轉移物品，以及查詢交易記錄等動作。庫存管理
- GetInventoryItems - 擷取實體目前的庫存。支援使用
ContinuationToken分頁，以及透過 TurboLoading 大量載入。 - AddInventoryItems - 將物品直接新增至玩家的庫存。
- SubtractInventoryItems - 減少玩家庫存中的物品數量。
- UpdateInventoryItems - 設定物品數量，或修改庫存物品的顯示屬性。
- DeleteInventoryItems - 從玩家的庫存中移除整個物品堆疊。
購買與交易
- PurchaseInventoryItems - 使用虛擬貨幣購買目錄物品或組合包。從玩家的庫存中扣除貨幣，並授與所購買的物品。
- TransferInventoryItems - 在玩家之間、玩家的庫存集合之間，或同一庫存內的堆疊之間轉移物品。
批次作業
- ExecuteInventoryOperations - 在單一不可部分完成的要求中，批次處理最多 10 個庫存作業 (Add、Subtract、Update、Purchase、Transfer、Delete)。若有任何作業失敗，整個批次都會復原。
記錄與診斷
- GetTransactionHistory - 從玩家的庫存擷取交易事件。支援依時間戳記篩選及分頁，以檢閱完整的作業記錄。請參閱交易記錄。
可靠性
- 等冪性 - 所有庫存 API 都支援
IdempotencyId參數，可安全地重試要求，而不會產生重複的副作用。ID 會強制執行 14 天。請參閱等冪性。