​

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

​

Concepts clés

• Catalogue - Un catalogue est une collection de tous les objets disponibles dans votre jeu. Les catalogues offrent un moyen simple de gérer les objets virtuels de votre jeu. Pour plus d’informations, consultez la vue d’ensemble du catalogue.
• Objets de catalogue – Objets individuels définis dans votre catalogue. Ils peuvent représenter tout 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 en fonction de la conception de votre jeu.
• Boutiques de catalogue - Les boutiques vous permettent de créer plusieurs listes d’objets à des fins différentes, comme des événements saisonniers, des promotions ou des tests. Consultez Boutiques.
• Lots - Les lots sont des objets de catalogue qui contiennent des références à d’autres objets. Lorsqu’un joueur achète un lot, les objets référencés sont décompressés et ajoutés à son inventaire.
• Abonnements - Les abonnements accordent un accès limité dans le temps à des biens durables. Les objets inclus dans un abonnement sont disponibles dans l’inventaire du joueur pendant la durée de l’abonnement. Consultez Abonnements.
• Collections d’inventaire du joueur - L’inventaire est un registre des objets qu’un joueur possède dans votre jeu. Il contient des informations sur les quantités d’objets, les soldes de devises virtuelles et les propriétés personnalisées. Tous les comptes de joueurs peuvent avoir un ou plusieurs inventaires appelés collections.
• Piles - Les piles permettent à plusieurs instances distinctes d’un même objet 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’objet utilisé comme moyen d’échange dans votre jeu. Vous pouvez utiliser une devise virtuelle pour acheter des objets dans le catalogue ou dans une boutique, mettre en place une devise secondaire issue d’achats intégrés ou piloter 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 masse via TurboLoading.
• AddInventoryItems - Ajoute des objets directement à l’inventaire d’un joueur.
• SubtractInventoryItems - Réduit les quantités d’objets dans l’inventaire d’un joueur.
• UpdateInventoryItems - Définit les quantités d’objets ou modifie les propriétés d’affichage des objets d’inventaire.
• DeleteInventoryItems - Supprime des piles entières d’objets de l’inventaire d’un joueur.

​

Achats et échanges

• PurchaseInventoryItems - Achète des objets de catalogue ou des lots avec une devise virtuelle. Déduit la devise de l’inventaire du joueur et octroie l’objet acheté.
• TransferInventoryItems - Transfère des objets entre joueurs, entre les collections d’inventaire d’un joueur ou entre des 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, l’ensemble du lot 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 permettant de réessayer des requêtes en toute sécurité sans effets secondaires en double. Les ID sont appliqués pendant 14 jours. Consultez Idempotence.