PFItemInstance - XBOX Game Development Documentation

Modelo de datos de PFItemInstance. Instancia única de un artículo en el inventario de un usuario. Tenga en cuenta que, para recuperar información adicional de un artículo, como Tags o Description, que es la misma en todas las instancias del artículo, se requiere una llamada a GetCatalogItems. El ItemID se puede hacer coincidir con una entrada del catálogo, que contiene la información adicional. Tenga en cuenta también que los datos personalizados (Custom Data) solo se establecen cuando la instancia específica del usuario ha actualizado CustomData mediante una llamada a UpdateUserInventoryItemCustomData. Otros campos, como UnitPrice y UnitCurrency, solo se establecen cuando el artículo se concedió mediante una compra.

Sintaxis

typedef struct PFItemInstance {  
    const char* annotation;  
    const char* const* bundleContents;  
    uint32_t bundleContentsCount;  
    const char* bundleParent;  
    const char* catalogVersion;  
    PFStringDictionaryEntry const* customData;  
    uint32_t customDataCount;  
    const char* displayName;  
    time_t const* expiration;  
    const char* itemClass;  
    const char* itemId;  
    const char* itemInstanceId;  
    time_t const* purchaseDate;  
    int32_t const* remainingUses;  
    const char* unitCurrency;  
    uint32_t unitPrice;  
    int32_t const* usesIncrementedBy;  
} PFItemInstance;  

Miembros

annotation const char*
is null-terminated (Opcional) Comentario específico del juego asociado a esta instancia cuando se agregó al inventario del usuario. bundleContents const char* const*
may be nullptr (Opcional) Matriz de artículos únicos que se otorgaron cuando se compró este artículo del catálogo. bundleContentsCount uint32_t Recuento de bundleContents bundleParent const char*
is null-terminated (Opcional) Identificador único del artículo de inventario principal, tal como se define en el catálogo, para los objetos que se agregaron desde un lote o contenedor. catalogVersion const char*
is null-terminated (Opcional) Versión del catálogo del artículo de inventario en el momento en que se creó esta instancia. customData PFStringDictionaryEntry const*
may be nullptr (Opcional) Conjunto de pares clave-valor personalizados de la instancia del artículo de inventario, que no debe confundirse con los datos personalizados del artículo del catálogo. customDataCount uint32_t Recuento de customData displayName const char*
is null-terminated (Opcional) CatalogItem.DisplayName en el momento en que se compró este artículo. expiration time_t const*
may be nullptr (Opcional) Marca de tiempo que indica cuándo expirará esta instancia. itemClass const char*
is null-terminated (Opcional) Nombre de clase del artículo de inventario, tal como se define en el catálogo. itemId const char*
is null-terminated (Opcional) Identificador único del artículo de inventario, tal como se define en el catálogo. itemInstanceId const char*
is null-terminated (Opcional) Identificador de artículo único de esta instancia específica del artículo. purchaseDate time_t const*
may be nullptr (Opcional) Marca de tiempo que indica cuándo se compró esta instancia. remainingUses int32_t const*
may be nullptr (Opcional) Número total de usos restantes, si se trata de un artículo consumible. unitCurrency const char*
is null-terminated (Opcional) Tipo de moneda del costo del artículo del catálogo. No está disponible al conceder artículos. unitPrice uint32_t Costo del artículo del catálogo en la moneda indicada. No está disponible al conceder artículos. usesIncrementedBy int32_t const*
may be nullptr (Opcional) Número de usos que se agregaron o quitaron a este artículo en esta llamada.

Requisitos

Encabezado: PFTypes.h

Consulte también

Miembros de PFTypes

​Sintaxis

​Miembros

​Requisitos

​Consulte también

Sintaxis

Miembros

Requisitos

Consulte también