PFItemInstance

PFItemInstance データモデル。ユーザーのインベントリ内のアイテムの一意のインスタンス。アイテムのすべてのインスタンスで共通のタグや説明などの追加情報を取得するには、GetCatalogItems の呼び出しが必要です。ItemID をカタログエントリと突き合わせることで、追加情報を得られます。また、Custom Data は、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*
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

PlayFab API

構文

メンバー

要件

関連項目

​構文

​メンバー

​要件

​関連項目

構文

メンバー

要件

関連項目