Pular para o conteúdo principal
Modelo de dados de PFItemInstance. Uma instância exclusiva de um item no inventário de um usuário. Observação: para recuperar informações adicionais de um item, como Tags e Description, que são iguais em todas as instâncias do item, é necessária uma chamada para GetCatalogItems. O ItemID pode ser correspondido a uma entrada do catálogo, que contém as informações adicionais. Observe também que Custom Data só é definido quando a instância específica do usuário atualizou o CustomData por meio de uma chamada para UpdateUserInventoryItemCustomData. Outros campos, como UnitPrice e UnitCurrency, só são definidos quando o item foi concedido por meio de uma compra.

​
Sintaxe

​
Membros

annotation   const char*
is null-terminated (Opcional) Comentário específico do jogo associado a esta instância quando ela foi adicionada ao inventário do usuário. bundleContents   const char* const*
may be nullptr (Opcional) Matriz de itens exclusivos concedidos quando este item do catálogo foi comprado. bundleContentsCount   uint32_t Contagem de bundleContents bundleParent   const char*
is null-terminated (Opcional) Identificador exclusivo do item de inventário pai, conforme definido no catálogo, para objetos adicionados de um pacote ou contêiner. catalogVersion   const char*
is null-terminated (Opcional) Versão do catálogo do item de inventário, quando esta instância foi criada. customData   PFStringDictionaryEntry const*
may be nullptr (Opcional) Um conjunto de pares chave-valor personalizados na instância do item de inventário, que não deve ser confundido com os dados personalizados do item do catálogo. customDataCount   uint32_t Contagem de customData displayName   const char*
is null-terminated (Opcional) CatalogItem.DisplayName no momento em que este item foi comprado. expiration   time_t const*
may be nullptr (Opcional) Carimbo de data/hora de quando esta instância expirará. itemClass   const char*
is null-terminated (Opcional) Nome da classe do item de inventário, conforme definido no catálogo. itemId   const char*
is null-terminated (Opcional) Identificador exclusivo do item de inventário, conforme definido no catálogo. itemInstanceId   const char*
is null-terminated (Opcional) Identificador exclusivo do item para esta instância específica do item. purchaseDate   time_t const*
may be nullptr (Opcional) Carimbo de data/hora de quando esta instância foi comprada. remainingUses   int32_t const*
may be nullptr (Opcional) Número total de usos restantes, se este for um item consumível. unitCurrency   const char*
is null-terminated (Opcional) Tipo de moeda do custo do item do catálogo. Não disponível ao conceder itens. unitPrice   uint32_t Custo do item do catálogo na moeda especificada. Não disponível ao conceder itens. usesIncrementedBy   int32_t const*
may be nullptr (Opcional) O número de usos adicionados ou removidos deste item nesta chamada.

​
Requisitos

Cabeçalho: PFTypes.h

​
Confira também

Membros de PFTypes
Última modificação em 20 de outubro de 2026