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。--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;请传递该令牌,并将转移的 GivingEntity 作为 --entity-id 和 --entity-type 传递。CLI 没有用于这些转移 API 的命令,因此请使用 playfab api 调用它们。交易 ID 不是操作令牌,PlayFab 会以 Bad OperationToken. 拒绝交易 ID。
库存交易
--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" 的转移:
