PFItemInstance 데이터 모델입니다. 사용자 인벤토리에 있는 항목의 고유한 인스턴스입니다. 항목의 모든 인스턴스에서 동일한 태그, 설명과 같은 항목에 대한 추가 정보를 검색하려면 GetCatalogItems를 호출해야 합니다. ItemID는 추가 정보가 포함된 카탈로그 항목과 일치할 수 있습니다. 또한 Custom Data는 User의 특정 인스턴스가 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 상수 문자* 상수*
nullptr일 수 있음
(선택 사항) 이 카탈로그 항목을 구매할 때 수여된 고유 항목의 배열입니다.
bundleContentsCount uint32_t
bundleContents의 개수
bundleParent const char*
is null-terminated
(선택 사항) 번들 또는 컨테이너에서 추가된 개체에 대해 카탈로그에 정의된 상위 인벤토리 항목의 고유 식별자입니다.
catalogVersion const char*
is null-terminated
(선택 사항) 이 인스턴스가 생성되었을 때 인벤토리 항목의 카탈로그 버전입니다.
customData PFStringDictionaryEntry const*
nullptr일 수 있음
(선택 사항) 카탈로그 항목의 사용자 지정 데이터와 혼동하지 않아야 하는 인벤토리 항목 인스턴스의 사용자 지정 키-값 쌍 세트입니다.
customDataCount uint32_t
customData의 수
displayName const char*
is null-terminated
(선택 사항) 이 항목을 구매한 시점의 CatalogItem.DisplayName입니다.
expiration time_t const*
nullptr일 수 있음
(선택 사항) 이 인스턴스가 만료되는 시간에 대한 타임스탬프입니다.
itemClass const char*
is null-terminated
(선택 사항) 카탈로그에 정의된 인벤토리 항목의 클래스 이름입니다.
itemId const char*
is null-terminated
(선택 사항) 카탈로그에 정의된 인벤토리 항목의 고유 식별자입니다.
itemInstanceId const char*
is null-terminated
(선택 사항) 항목의 이 특정 인스턴스에 대한 고유 항목 식별자입니다.
purchaseDate time_t const*
nullptr일 수 있음
(선택 사항) 이 인스턴스를 구매한 시점의 타임스탬프입니다.
remainingUses int32_t const*
nullptr일 수 있음
(선택 사항) 소모성 항목인 경우 남은 총 사용 횟수입니다.
unitCurrency const char*
is null-terminated
(선택 사항) 카탈로그 항목 비용의 통화 유형입니다. 아이템 부여 시 사용할 수 없습니다.
unitPrice uint32_t
지정된 통화로 표시된 카탈로그 항목의 비용입니다. 아이템 부여 시 사용할 수 없습니다.
usesIncrementedBy int32_t const*
nullptr일 수 있음
(선택 사항) 이 호출에서 이 항목에 추가되거나 제거된 사용 횟수입니다.
요구 사항
헤더: PFTypes.h