Skip to main content
PFItemInstance 데이터 모델입니다. 사용자의 인벤토리에 있는 항목의 고유 인스턴스입니다. 항목의 모든 인스턴스에서 동일한 Tags, Description과 같은 추가 정보를 검색하려면 GetCatalogItems를 호출해야 합니다. ItemID를 카탈로그 항목과 매칭할 수 있으며, 여기에 추가 정보가 포함되어 있습니다. 또한, Custom Data는 사용자의 특정 인스턴스가 UpdateUserInventoryItemCustomData 호출을 통해 CustomData를 업데이트한 경우에만 설정됩니다. UnitPrice 및 UnitCurrency와 같은 다른 필드는 항목이 구매를 통해 부여된 경우에만 설정됩니다.

구문

멤버

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 멤버
마지막 수정일 2026년 8월 13일