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_Show
Hive IAP v2 관련 마켓 선택 팝업, 러비 충전 팝업을 호출한다.
Hive SDK v1.12.0 버전부터 기존의 식별자 파라미터가 삭제되고 통합 식별자로 통일되었다.
현재 사용중인 통합 식별자 serverId와 gameLanguage는 아래 API에서 설정 가능하다.
Request
| argument name | type | description | platform | 비고 |
|---|---|---|---|---|
| type | string | “payment” : 러비/구글플레이 선택 팝업을 호출한다. “charge” : 러비 사용시 러비 충전 팝업을 호출한다. |
android | |
| gameLanguage | string | 게임내 언어 구분값. gameLanguage에 따라 상점에 노출되는 언어가 결정된다. 예. “ko”, “en”, “zh-CN” 게임 언어 코드값은 ‘ISO 639 alpha-2′(ISO 639-1) 코드를 기준으로 하며 Hive 연동 가이드라인 언어 항목을 참고한다. ** gameLanguage를 입력하지 않거나 유효하지 않은 값을 입력하였을 경우 백오피스에 등록된 default 언어를 사용한다. |
android | 1.12.0+ 삭제 |
Response
| argument name | type | description | platform | 비고 |
|---|---|---|---|---|
| type | string | “payment” “charge” |
android | |
| balance | string | type이 charge일 때 러비 잔액 | android |
샘플 코드
Unity®
API Reference: C2SModule.HiveIAP.Show
- public static bool C2SModule.HiveIAP.Show(C2SModule.Parameter arg, out C2SModule.Error error);
- public static bool C2SModule.HiveIAP.Show(C2SModule.Parameter arg, out C2SModule.Error error,
C2SModule.CompletionHandler completionHandler);
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
//payment webview API call example public void getHiveIAPPayment(string gameLanguage,Action<HiveIAPBadge,C2SError> completionHandler) { C2SError error; C2SParameter arg = new C2SParameter (); arg ["type"] = "payment"; // 구글플레이/러비 결제 선택 팝업 요청 부분 C2SModule.HiveIAP.Show(arg,out error,(C2SParameter resultArg,C2SError resultError) => { // 콜백 처리. }); } //charge webview API call example public void getHiveIAPCharge(string gameLanguage,Action<HiveIAPBadge,C2SError> completionHandler) { C2SError error; C2SParameter arg = new C2SParameter (); arg ["type"] = "charge"; // 러비 충전 팝업 요청 부분 C2SModule.HiveIAP.Show(arg,out error,(C2SParameter resultArg,C2SError resultError) => { // 콜백 처리. }); } |
Unreal
API Reference: HiveSDKUEHiveIAP_Show
- void HiveSDKUEHiveIAP_Show(FString fstrJson);
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
//Payment webview API Call example TSharedPtr arg = MakeShareable(new FJsonObject); arg->SetStringField(TEXT("type"), TEXT("payment")); // 구글플레이/러비 결제 선택 팝업 요청 부분 FString OutputString; TSharedRef< TJsonWriter<> > Writer = TJsonWriterFactory<>::Create(&OutputString); FJsonSerializer::Serialize(arg.ToSharedRef(), Writer); FHiveSDKModule::Get().HiveSDKUEHiveIAP_Show(OutputString); //Charge webview API Call example TSharedPtr arg = MakeShareable(new FJsonObject); arg->SetStringField(TEXT("type"), TEXT("charge")); // 러비 충전 팝업 요청 부분 FString OutputString; TSharedRef< TJsonWriter<> > Writer = TJsonWriterFactory<>::Create(&OutputString); FJsonSerializer::Serialize(arg.ToSharedRef(), Writer); FHiveSDKModule::Get().HiveSDKUEHiveIAP_Show(OutputString); |
Cocos2d-x
API Reference: C2SModuleHiveIAP_Show
- bool C2SModuleHiveIAP_Show(const char* pstrJson, C2SModule_Cocos2dx::C2SModuleError* pkError,
C2SModule_Cocos2dx::C2SModuleCompletionHandler* completionHandler = NULL);
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
//Payment webview API Call example void SampleProject::menuHiveIAPShowPaymentCallback(cocos2d::Ref* pSender) { Json::Value arg; arg ["type"] = "payment"; // 구글플레이/러비 결제 선택 팝업 요청 부분 Json::StyledWriter writer; std::string strJSON = writer.write(arg); C2SModule_Cocos2dx::C2SModuleError error; if( C2SModuleHiveIAP_Show( strJSON.c_str(), &error ) == false ) { CCLog( "====>>>> C2SModuleHiveIAP_Show payment error (%s)", error.get()->GetMessage() ); } } //Charge webview API Call example void SampleProject::menuHiveIAPShowChargeCallback(cocos2d::Ref* pSender) { Json::Value arg; arg ["type"] = "charge"; // 러비 충전 팝업 요청 부분 Json::StyledWriter writer; std::string strJSON = writer.write(arg); C2SModule_Cocos2dx::C2SModuleError error; if( C2SModuleHiveIAP_Show( strJSON.c_str(), &error ) == false ) { CCLog( "====>>>> C2SModuleHiveIAP_Show charge error (%s)", error.get()->GetMessage() ); } } |
iOS
API Reference: C2SModuleHiveIAP Show
|
1 |