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 transmettez à la fois --entity-id et
--entity-type. Pour un joueur, transmettez l’ID de son compte de joueur du titre avec
--entity-type title_player_account, et non l’ID de son compte de joueur principal;
playfab player account get le retourne 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 transmettez
--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 destructrices.
Éléments d’inventaire
inventory listretourne une page de--limitéléments, 10 par défaut. Pour obtenir la page suivante, transmettez le jeton de continuation de la réponse avec--continuation-token.--filterest un filtre OData sur les propriétés d’élémenttype,idetstackId.inventory addretourneETag,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 une seule transaction. Comme inventory add, elle retourne
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é lorsque sa requête a
retourné une réponse. TransferInventoryItems et ExecuteTransferOperations retournent un
OperationToken pendant que leur OperationStatus est InProgress; transmettez ce jeton, ainsi que
l’entité GivingEntity du transfert avec --entity-id et --entity-type. La CLI n’a aucune 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 ne l’acceptent pas. 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 le
OperationToken de sa réponse et le joueur qui a donné les éléments :
