​

Vue d’ensemble des articles et de l’inventaire PlayFab

​

Concepts clés

• Catalogue - Un catalogue est une collection de tous les articles offerts dans votre jeu. Les catalogues offrent un moyen simple de gérer les articles virtuels de votre jeu. Pour plus d’information, consultez la vue d’ensemble du catalogue.
• Articles du catalogue – Articles individuels définis dans votre catalogue. Ils peuvent représenter n’importe quel type de bien virtuel, comme des armes, des tenues, des bonus, des coffres à butin, etc. Vous pouvez personnaliser leurs propriétés et leurs comportements selon la conception de votre jeu.
• Boutiques du catalogue - Les boutiques vous permettent de créer plusieurs listes d’articles à différentes fins, comme des événements saisonniers, des promotions ou des tests. Consultez Boutiques.
• Ensembles - Les ensembles sont des articles du catalogue qui contiennent des références à d’autres articles. Lorsqu’un joueur achète un ensemble, les articles référencés sont dépaquetés et ajoutés à son inventaire.
• Abonnements - Les abonnements accordent un accès limité dans le temps à des biens durables. Les articles d’un abonnement sont disponibles dans l’inventaire d’un joueur pendant toute la durée de l’abonnement. Consultez Abonnements.
• Collections d’inventaire du joueur - L’inventaire est un registre des articles qu’un joueur possède dans votre jeu. Il contient de l’information sur les quantités d’articles, les soldes de devises virtuelles et les propriétés personnalisées. Tous les comptes de joueur peuvent avoir un ou plusieurs inventaires appelés collections.
• Piles - Les piles permettent à plusieurs instances distinctes d’un même article d’exister dans un seul inventaire, chacune avec sa propre quantité et ses propres propriétés personnalisées. Consultez Piles.
• Devise virtuelle - La devise virtuelle est un type d’article utilisé comme moyen d’échange dans votre jeu. Vous pouvez utiliser une devise virtuelle pour acheter des articles du catalogue ou d’une boutique, mettre en place une monnaie secondaire issue des achats intégrés ou alimenter des mécaniques de jeu.

​

API clés

​

Gestion de l’inventaire

• GetInventoryItems - Récupère l’inventaire actuel d’une entité. Prend en charge la pagination avec ContinuationToken et le chargement en bloc au moyen de TurboLoading.
• AddInventoryItems - Ajoute des articles directement à l’inventaire d’un joueur.
• SubtractInventoryItems - Réduit les quantités d’articles dans l’inventaire d’un joueur.
• UpdateInventoryItems - Définit les quantités d’articles ou modifie les propriétés d’affichage des articles d’inventaire.
• DeleteInventoryItems - Retire des piles entières d’articles de l’inventaire d’un joueur.

​

Achats et échanges

• PurchaseInventoryItems - Achète des articles ou des ensembles du catalogue avec une devise virtuelle. Déduit la devise de l’inventaire du joueur et octroie l’article acheté.
• TransferInventoryItems - Transfère des articles entre joueurs, entre les collections d’inventaire d’un joueur ou entre les piles d’un même inventaire.

​

Opérations par lots

• ExecuteInventoryOperations - Regroupe jusqu’à 10 opérations d’inventaire (Add, Subtract, Update, Purchase, Transfer, Delete) dans une seule requête atomique. Si une opération échoue, le lot entier est annulé.

​

Historique et diagnostics

• GetTransactionHistory - Récupère les événements de transaction de l’inventaire d’un joueur. Prend en charge le filtrage par horodatage et la pagination pour examiner l’historique complet des opérations. Consultez Historique des transactions.

​

Fiabilité

• Idempotence - Toutes les API d’inventaire prennent en charge un paramètre IdempotencyId pour relancer les requêtes en toute sécurité sans effets secondaires en double. Les ID sont appliqués pendant 14 jours. Consultez Idempotence.