playfab economy inventory, y compris
les collections, l’historique des transactions et les opérations d’inventaire par lots.
Les commandes d’inventaire ciblent l’entité appelante, sauf si vous passez à la fois --entity-id et
--entity-type. Pour un joueur, passez l’ID de son compte joueur de titre avec
--entity-type title_player_account, et non l’ID de son compte joueur principal ;
playfab player account get le renvoie sous la forme
UserInfo.TitleInfo.TitlePlayerAccount.Id. --collection-id sélectionne une collection
d’inventaire autre que default.
operation execute refuse un lot qui contient une opération Delete, sauf si vous passez
--confirm (--yes, -y), même dans un terminal. Les autres modifications de l’inventaire s’exécutent sans demander de confirmation.
Consultez Sécurité et opérations destructives.
Éléments d’inventaire
inventory listrenvoie une page de--limitéléments, 10 par défaut. Pour obtenir la page suivante, passez le jeton de continuation de la réponse avec--continuation-token.--filterest un filtre OData portant sur les propriétés d’élémenttype,idetstackId.inventory addrenvoieETag,IdempotencyIdet lesTransactionIdsqu’elle a enregistrés, et non l’inventaire modifié. Exécutezinventory listpour voir le résultat.
Collections d’inventaire
Opérations d’inventaire
operation execute exécute le lot en tant que transaction unique. Comme inventory add, elle renvoie
ETag, IdempotencyId et TransactionIds pour l’ensemble du lot. Exécutez inventory list ou
inventory transaction list pour voir ce qu’elle a fait.
operation status vérifie un transfert d’inventaire qui n’était pas terminé au retour de sa
requête. TransferInventoryItems et ExecuteTransferOperations renvoient un
OperationToken tant que leur OperationStatus vaut InProgress ; passez ce jeton, ainsi que le
GivingEntity du transfert en tant que --entity-id et --entity-type. La CLI n’a pas de commande pour
ces API de transfert : appelez-les donc avec playfab api. Un ID de transaction n’est pas un
jeton d’opération, et PlayFab le rejette avec Bad OperationToken.
Transactions d’inventaire
--filter peut faire référence à timestamp, transactionid, apiname et operationtype.
--order-by accepte timestamp asc ou timestamp desc.
Sortie sous forme de tableau
Ces commandes acceptent--output table ; inventory add et operation execute non. Consultez
Sortie sous forme de tableau.
Un tableau n’affiche pas le jeton de continuation : utilisez donc la sortie JSON pour aller au-delà de la
première page.
Exemples
Lire l’inventaire, les collections et l’historique des transactions d’un joueur :ops.json :
ops.json contient une opération Delete, ajoutez --confirm :
"OperationStatus": "InProgress", en utilisant
l’OperationToken de sa réponse et le joueur qui a donné les éléments :
