Hive SDK v1.19.1부터 IAP v2의 지원을 종료합니다. Hive SDK v1.19.1 이상의 환경에서는 Hive IAP v4를 적용하시기 바랍니다.
본 가이드는 Hive IAP v2에 대해 안내하며, Hive SDK v1.19.0 이하 v1.9.0 이상에서 적용하실 수 있습니다.

C2SModuleHiveIAP_Info

C2SModuleHiveIAP_Info() 메소드는 Hive 콘솔에 설정된 Hive IAP v2 상점 구성을 위한 상품 정보, 러비 잔액 등의 정보를 요청한다. 유저가 상품 리스트를 볼 때, 항상 정확한 정보 및 최신 정보를 볼 수 있도록 상점에 들어갈 때마다 C2SModuleHiveIAP_Info()를 호출하며 구매 및 구매 복구를 요청하기 전에 반드시 serverId / gameLanguage 식별자를 세팅해주어야 한다.

Request
argument name type description platform 비고
상점 구성을 위한 아이템의 정보를 요청 할 때
type string “shopInfo” all
locationCode string 상점 구분 코드, “DEFAULT” all
worldName string 게임 서버 구분 값 (Hive 아이템 등록 시 사용한 게임 서버 구분 값)
서버 지역 코드값은 ‘ISO 3166 alpha-2’ 코드를 기준으로 하며Hive 연동 가이드라인 게임서버 ID 항목을 참고한다.
all 1.12.0+ 삭제
gameLanguage string 게임내 언어 구분값. gameLanguage에 따라 상점에 노출되는 언어가 결정된다.
ex. “ko”, “en”
게임 언어 코드값은 ‘ISO 639 alpha-2′(ISO 639-1) 코드를 기준으로 하며 Hive 연동 가이드라인 언어 항목을 참고한다.
gameLanguage를 입력하지 않거나 유효하지 않은 값을 입력하였을 경우 백오피스에 등록된 default 언어를 사용한다.
all 1.12.0+ 삭제
상점 구성을 위한 러비 잔액 정보를 요청 할 때
type string “balance” android
Response

locationCode = “DEFAULT” 를 사용한다면 비고에 * 표시가 되어 있는 값은 사용하지 않는다.

argument name type description platform 비고
상점 정보 요청에 대한 콜백 데이터
type string “shopInfo” all
locationCode string 상점 구분 코드
“DEFAULT,”
all
balance string 러비 잔액 all
products array 상품 정보들 all
isBadgeExist bool true or false
뱃지 정보 존재 유무
all *
badgeImageUrl string 뱃지 이미지 url all *
shopType string 상점 구분 코드 all 1.10.3+
*
러비 잔액 정보 요청에 대한 콜백 데이터
type string “balance” android
balance int 러비 잔액 android

array type for products
(locationCode = “DEFAULT” 를 사용한다면 비고에 * 표시가 되어 있는 값은 사용하지 않는다.)

argument name type description platform 비고
pid string 게임에서 사용하는 상품 pid all
marketPid string 마켓에 등록된 상품 pid all
price double 상품 가격 all
displayPrice string 상품 가격 문자열(ex. ₩1,000) all
currency string 통화 코드 all
title string 상품 타이틀 all *
description string 상품 설명 all *
badgeImageUrl string 뱃지 이미지 url all *
productImageUrl string 상품 이미지 url all *
titleLandscapeImageUrl string 상품 타이틀 이미지 (가로) all *
titlePortraitImageUrl string 상품 타이틀 이미지 (세로) all *
descLandscapeImageUrl string 상품 설명 이미지 (가로) all *
descPortraitImageUrl string 상품 설명 이미지 (세로) all *
productType string 상품 타입
일반 상품 : general / 시리즈 상품 : series
all 1.11.2+
*
salesStartUTC long 상품 판매 시작 시간
-1일 경우 무제한
all 1.11.2+
*
salesExpireUTC long 상품 판매 만료 시간
-1일 경우 무제한
all 1.11.2+
*
seriesInfo dictionary 시리즈 상품 정보
(productType = general일 땐 필드 없음)
all 1.11.2+
*


dictionary type for seriesInfo
(locationCode = “DEFAULT” 를 사용한다면 비고에 * 표시가 되어 있는 값은 사용하지 않는다.)

argument name type description platform 비고
seriesPurchaseStatus int 구매 상태
구매전 : 1 / 구매 완료 : 2
all 1.11.2+
*
seriesSeq int 시리즈 상품 순번 all 1.11.2+
*
seriesTotalCount int 시리즈 상품 수 all 1.11.2+
*
샘플코드
Unity®

API Reference: C2SModule.HiveIAP.Info

  • public static bool C2SModule.HiveIAP.Info(C2SModule.Parameter arg, out C2SModule.Error error);
  • public static bool C2SModule.HiveIAP.Info(C2SModule.Parameter arg, out C2SModule.Error error,
    C2SModule.CompletionHandler completionHandler);

Unreal

API Reference: HiveSDKUEHiveIAP_Info

  • void HiveSDKUEHiveIAP_Info(FString fstrJson);

Cocos2d-x

API Reference: C2SModuleHiveIAP_Info

  • bool C2SModuleHiveIAP_Info(const char* pstrJson, C2SModule_Cocos2dx::C2SModuleError* pkError,
    C2SModule_Cocos2dx::C2SModuleCompletionHandler* completionHandler = NULL);

iOS

API Reference: C2SModuleHiveIAP Info

  • +(BOOL)Info:(id)arg error:(NSError**)error;
  • +(BOOL)Info:(id)arg error:(NSError**)error completionHandler:(void(^)(NSDictionary *, NSError*))
    completionHandler;