Passer au contenu principal
Modèle de données PFItemInstance. Une instance unique d’un article dans l’inventaire d’un utilisateur. Notez que pour récupérer des informations supplémentaires sur un article, comme les balises (Tags) et la description (Description), qui sont identiques pour toutes les instances de l’article, un appel à GetCatalogItems est requis. L’ItemID peut être associé à une entrée de catalogue, qui contient les informations supplémentaires. Notez également que les données personnalisées (Custom Data) ne sont définies que lorsque l’instance propre à l’utilisateur a mis à jour CustomData au moyen d’un appel à UpdateUserInventoryItemCustomData. D’autres champs, comme UnitPrice et UnitCurrency, ne sont définis que lorsque l’article a été accordé au moyen d’un achat.

Syntaxe

Membres

annotation   const char*
se termine par un caractère nul
(Facultatif) Commentaire propre au jeu associé à cette instance lorsqu’elle a été ajoutée à l’inventaire de l’utilisateur. bundleContents   const char* const*
peut être nullptr
(Facultatif) Tableau des articles uniques qui ont été attribués lors de l’achat de cet article de catalogue. bundleContentsCount   uint32_t Nombre de bundleContents bundleParent   const char*
se termine par un caractère nul
(Facultatif) Identificateur unique de l’article d’inventaire parent, tel que défini dans le catalogue, pour les objets ajoutés à partir d’un ensemble ou d’un conteneur. catalogVersion   const char*
se termine par un caractère nul
(Facultatif) Version du catalogue de l’article d’inventaire, au moment où cette instance a été créée. customData   PFStringDictionaryEntry const*
peut être nullptr
(Facultatif) Un ensemble de paires clé-valeur personnalisées sur l’instance de l’article d’inventaire, à ne pas confondre avec les données personnalisées de l’article de catalogue. customDataCount   uint32_t Nombre de customData displayName   const char*
se termine par un caractère nul
(Facultatif) CatalogItem.DisplayName au moment de l’achat de cet article. expiration   time_t const*
peut être nullptr
(Facultatif) Horodatage de l’expiration de cette instance. itemClass   const char*
se termine par un caractère nul
(Facultatif) Nom de classe de l’article d’inventaire, tel que défini dans le catalogue. itemId   const char*
se termine par un caractère nul
(Facultatif) Identificateur unique de l’article d’inventaire, tel que défini dans le catalogue. itemInstanceId   const char*
se termine par un caractère nul
(Facultatif) Identificateur d’article unique pour cette instance précise de l’article. purchaseDate   time_t const*
peut être nullptr
(Facultatif) Horodatage de l’achat de cette instance. remainingUses   int32_t const*
peut être nullptr
(Facultatif) Nombre total d’utilisations restantes, s’il s’agit d’un article consommable. unitCurrency   const char*
se termine par un caractère nul
(Facultatif) Type de monnaie pour le coût de l’article de catalogue. Non disponible lors de l’octroi d’articles. unitPrice   uint32_t Coût de l’article de catalogue dans la monnaie donnée. Non disponible lors de l’octroi d’articles. usesIncrementedBy   int32_t const*
peut être nullptr
(Facultatif) Le nombre d’utilisations ajoutées à cet article ou retirées de celui-ci lors de cet appel.

Configuration requise

En-tête : PFTypes.h

Voir aussi

Membres PFTypes
Dernière modification le 6 octobre 2026