playfab economy inventory, incluindo
coleções, histórico de transações e operações de inventário em lote.
Os comandos de inventário têm como destino a entidade chamadora, a menos que você passe --entity-id e
--entity-type. Para um jogador, passe a ID da conta de jogador do título dele com
--entity-type title_player_account, e não a ID da conta de jogador mestre;
playfab player account get a retorna como
UserInfo.TitleInfo.TitlePlayerAccount.Id. --collection-id seleciona uma coleção de inventário
diferente de default.
operation execute recusa um lote que contenha uma operação Delete, a menos que você passe
--confirm (--yes, -y), mesmo em um terminal. As outras alterações de inventário são executadas sem perguntar.
Consulte Segurança e operações destrutivas.
Itens de inventário
inventory listretorna uma página de--limititens, 10 por padrão. Para obter a próxima página, passe o token de continuação da resposta com--continuation-token.--filteré um filtro OData sobre as propriedades de itemtype,idestackId.inventory addretornaETag,IdempotencyIde asTransactionIdsque registrou, e não o inventário alterado. Executeinventory listpara ver o resultado.
Coleções de inventário
Operações de inventário
operation execute executa o lote como uma única transação. Assim como inventory add, ele retorna
ETag, IdempotencyId e TransactionIds para o lote inteiro. Execute inventory list ou
inventory transaction list para ver o que ele fez.
operation status verifica uma transferência de inventário que não havia terminado quando sua solicitação
retornou. TransferInventoryItems e ExecuteTransferOperations retornam um
OperationToken enquanto o OperationStatus deles é InProgress; passe esse token e a
GivingEntity da transferência como --entity-id e --entity-type. A CLI não tem nenhum comando para
essas APIs de transferência; portanto, chame-as com playfab api. Uma ID de transação não é um
token de operação, e o PlayFab a rejeita com Bad OperationToken.
Transações de inventário
--filter pode se referir a timestamp, transactionid, apiname e operationtype.
--order-by aceita timestamp asc ou timestamp desc.
Saída em tabela
Estes comandos aceitam--output table; inventory add e operation execute não. Consulte
Saída em tabela.
Uma tabela não mostra o token de continuação; portanto, use a saída JSON para paginar além da primeira
página.
Exemplos
Ler o inventário, as coleções e o histórico de transações de um jogador:ops.json:
ops.json contiver uma operação Delete, adicione --confirm:
"OperationStatus": "InProgress", usando o
OperationToken da resposta dela e o jogador que deu os itens:
