PFItemInstance

PFItemInstance データ モデル。 ユーザーのインベントリ内のアイテムの一意のインスタンス。 アイテムのすべてのインスタンスで同じであるタグや説明などのアイテムの追加情報を取得するには、GetCatalogItems の呼び出しが必要であることに注意してください。 の項目 ID は、追加情報を含むカタログ エントリと照合できます。 また、カスタム データは、ユーザーの特定のインスタンスが UpdateUserInventoryItemCustomData の呼び出しを通じて CustomData を更新した場合にのみ設定されることにも注意してください。 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*
が null で終わる

(省略可能) このインスタンスがユーザー インベントリに追加されたときに関連付けられたゲーム固有のコメント。

bundleContents const char* const*
nullptr でもかまいません

(省略可能) このカタログ項目の購入時に付与された一意のアイテムの配列。

bundleContentsCount uint32_t

bundleContents の数

bundleParent const char*
が null で終わる

(省略可能) バンドルまたはコンテナーから追加されたオブジェクトに対して、カタログで定義されている親インベントリ項目の一意識別子。

catalogVersion const char*
が null で終わる

(省略可能) このインスタンスが作成されたときの、インベントリ項目のカタログ バージョン。

customData PFStringDictionaryEntry const*
nullptr でもかまいません

(省略可能) インベントリ項目のインスタンス上のカスタム キーと値のペアのセット。カタログ項目のカスタム データと混同しないでください。

customDataCount uint32_t

customData の数

displayName const char*
が null で終わる

(省略可能) このアイテムを購入した時点の CatalogItem.DisplayName。

expiration time_t const*
nullptr でもかまいません

(省略可能) このインスタンスの有効期限が切れる時刻のタイムスタンプ。

itemClass const char*
が null で終わる

(省略可能) カタログで定義されているインベントリ項目のクラス名。

itemId const char*
が null で終わる

(省略可能) カタログで定義されているインベントリ項目の一意識別子。

itemInstanceId const char*
が null で終わる

(省略可能) アイテムのこの特定のインスタンスの一意の項目識別子。

purchaseDate time_t const*
nullptr でもかまいません

(省略可能) このインスタンスが購入されたときのタイムスタンプ。

remainingUses int32_t const*
nullptr でもかまいません

(省略可能) 消費型アイテムの場合は、残りの使用の合計数。

unitCurrency const char*
が null で終わる

(省略可能) カタログ項目のコストの通貨の種類。 アイテムを付与する場合は使用できません。

unitPrice uint32_t

指定された通貨でのカタログ項目のコスト。 アイテムを付与する場合は使用できません。

usesIncrementedBy int32_t const*
nullptr でもかまいません

(省略可能) この呼び出しでこの項目に追加または削除された使用回数。

要件

ヘッダー： PFTypes.h

関連項目

PFTypes メンバー