PFItemInstance - XBOX Game Development Documentation

PFItemInstance 数据模型。用户库存中项目的唯一实例。注意，若要检索项目的其他信息（如项目的所有实例都相同的标签、描述），需要调用 GetCatalogItems。ItemID 可以与目录条目匹配，其中包含其他信息。另请注意，仅当用户的特定实例通过调用 UpdateUserInventoryItemCustomData 更新 CustomData 时，才会设置 Custom Data。其他字段（如 UnitPrice 和 UnitCurrency）仅在通过购买授予项目时设置。

语法

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;  

成员

annotation const char*
is null-terminated （可选）将此实例添加到用户库存时与此实例关联的游戏特定注释。 bundleContents const char* const*
may be nullptr （可选）购买此目录项目时授予的唯一项目数组。 bundleContentsCount uint32_t bundleContents 的计数 bundleParent const char*
is null-terminated （可选）父库存项目的唯一标识符，如目录中所定义，用于从捆绑包或容器中添加的对象。 catalogVersion const char*
is null-terminated （可选）创建此实例时库存项目的目录版本。 customData PFStringDictionaryEntry const*
may be nullptr （可选）库存项目实例上的一组自定义键值对，不要与目录项目的自定义数据混淆。 customDataCount uint32_t customData 的计数 displayName const char*
is null-terminated （可选）购买此项目时的 CatalogItem.DisplayName。 expiration time_t const*
may be nullptr （可选）此实例将到期的时间戳。 itemClass const char*
is null-terminated （可选）库存项目的类名，如目录中所定义。 itemId const char*
is null-terminated （可选）库存项目的唯一标识符，如目录中所定义。 itemInstanceId const char*
is null-terminated （可选）此项目特定实例的唯一项目标识符。 purchaseDate time_t const*
may be nullptr （可选）购买此实例的时间戳。 remainingUses int32_t const*
may be nullptr （可选）剩余使用次数总数（如果这是一个消耗品）。 unitCurrency const char*
is null-terminated （可选）目录项目成本的货币类型。授予项目时不可用。 unitPrice uint32_t 给定货币中目录项目的成本。授予项目时不可用。 usesIncrementedBy int32_t const*
may be nullptr （可选）在此调用中添加或移除到此项目的使用次数。

要求

头文件： PFTypes.h

另请参阅

PFTypes 成员

​语法

​成员

​要求

​另请参阅

语法

成员

要求

另请参阅