跳轉到主要內容
使用 playfab economy inventory 讀取及變更 PlayFab Economy v2 物品欄,包括集合、交易歷程記錄和批次物品欄作業。 除非您同時傳遞 --entity-id 和 --entity-type,否則物品欄命令會以呼叫實體為目標。若是玩家,請搭配 --entity-type title_player_account 傳遞其遊戲玩家帳戶 ID,而不是其主要玩家帳戶 ID;playfab player account get 會以 UserInfo.TitleInfo.TitlePlayerAccount.Id 傳回該 ID。--collection-id 會選取 default 以外的物品欄集合。 除非您傳遞 --confirm (--yes、-y),否則即使在終端機中,operation execute 也會拒絕包含 Delete 作業的批次。其他物品欄變更會在不詢問的情況下執行。請參閱安全性和破壞性作業。

物品欄項目

  • inventory list 會傳回一頁 --limit 個項目,預設為 10 個。若要取得下一頁,請以 --continuation-token 傳遞回應的接續權杖。
  • --filter 是針對項目屬性 type、id 和 stackId 的 OData 篩選。
  • inventory add 會傳回 ETag、IdempotencyId 及其記錄的 TransactionIds,而不是變更後的物品欄。請執行 inventory list 以查看結果。

物品欄集合

物品欄作業

operation execute 會將批次作為一筆交易執行。與 inventory add 一樣,它會傳回整個批次的 ETag、IdempotencyId 和 TransactionIds。請執行 inventory list 或 inventory transaction list 以查看其執行結果。 operation status 會檢查在其要求傳回時尚未完成的物品欄轉移。當 TransferInventoryItems 和 ExecuteTransferOperations 的 OperationStatus 為 InProgress 時,會傳回 OperationToken;請傳遞該權杖,並以 --entity-id 和 --entity-type 傳遞轉移的 GivingEntity。CLI 沒有這些轉移 API 的命令,因此請使用 playfab api 呼叫它們。交易 ID 不是作業權杖,PlayFab 會以 Bad OperationToken. 拒絕它。

物品欄交易

--filter 可以參考 timestamp、transactionid、apiname 和 operationtype。--order-by 接受 timestamp asc 或 timestamp desc。

表格輸出

這些命令接受 --output table;inventory add 和 operation execute 則不接受。請參閱表格輸出。 表格不會顯示接續權杖,因此若要翻過第一頁,請使用 JSON 輸出。

範例

讀取一位玩家的物品欄、集合和交易歷程記錄:
將一個項目新增至玩家的物品欄:
從 ops.json 執行一批物品欄作業:
如果 ops.json 包含 Delete 作業,請加入 --confirm:
使用轉移回應中的 OperationToken 以及提供項目的玩家,檢查傳回 "OperationStatus": "InProgress" 的轉移:
最後修改於 2026年11月19日