跳轉到主要內容
PFItemInstance 資料模型。使用者庫存中項目的唯一執行個體。請注意,若要擷取項目在所有執行個體間都相同的其他資訊 (例如 Tags、Description),必須呼叫 GetCatalogItems。ItemID 可以對應到包含其他資訊的目錄項目。另請注意,只有在使用者的特定執行個體透過呼叫 UpdateUserInventoryItemCustomData 更新 CustomData 時,才會設定 Custom Data。其他欄位 (例如 UnitPrice 和 UnitCurrency) 只有在項目是透過購買授與時才會設定。

語法

成員

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 成員
最後修改於 2026年10月6日