Google Play Store가 없는 중국 내에서 인앱 과금 처리를 위해 Hive에서 만든 모듈로써, 러비(Lebi)라는 단위의 가상화폐를 충전하여 아이템을 구매할 수 있습니다.
Android 단말기는 경우에 따라 Google Play Store과 Hive 러비 중 어떤 결제 수단을 사용할지 선택할 수 있습니다. Hive 러비를 선택한 경우 다음 안내에 따라 러비 결제를 구현하세요.
Hive 러비 상점 연동 플로우
상점 선택 화면 노출
만약 Google Play Store와 Hive 러비 상점을 동시에 이용할 수 있는 상황이라면 유저가 상점을 선택할 수 있도록 상점 선택 화면을 노출해야 합니다. C2SModuleInappV4 클래스의 SelectMarket() 메서드를 호출하면 상점 선택을 위한 화면을 노출할 수 있습니다.
- Android 단말기에서 이용 가능한 마켓이 Google과 Hive 러비 두 종류일 경우 예제 화면
C2SModuleInappV4_SelectMarket
- Request
별도 요청 데이터 없음 - Response
Argument Type Type Description Platform marketList string array 사용 가능한 마켓의 이름 정보 (1.18.4+) - apple_appstore
- google_playstore
- hive_lebi
- onestore
- amazone_appstore
- samsung_galaxystore
- huawei_appgallery
- hive_pg
Android
다음은 상점 선택 화면 노출을 요청하는 예제 코드입니다.
API Reference: C2SModule.InappV4.SelectMarket
|
1 2 3 4 5 6 |
C2SModule.Parameter arg = new C2SModule.Parameter(); C2SModule.Error error; if(!C2SModule.InappV4.SelectMarket(arg. out error)) { // 에러 발생 시 처리 } |
API Reference: C2SModuleInappV4_SelectMarket
|
1 2 3 4 5 |
C2SModule_Cocos2dx::C2SModuleError eror; if( ::C2SModuleInappV4_SelectMarket(strJSON.c_str(), &error ) == false) // 에러 발생 시 처리 } |
API Reference: N/A
iOS에서는 Hive 러비 상점을 지원하지 않습니다.
러비 잔액 조회 API
Hive 러비 상점이 선택되었다면 C2SModuleInappV4 클래스의 RequestBalance() 메서드를 호출하여 러비 잔액 조회를 요청하고, 상점에 잔액을 노출해야 합니다.
러비 잔액은 RequestBalance() 메서드의 콜백에 balance 키 값으로 전달받을 수 있습니다.
C2SModuleInappV4_RequestBalance
- Request
별도 요청 데이터 없음 - Response
Argument Type Type Description Platform balance int Hive 러비 잔액 (1.18.4+) Android
다음은 러비 잔액을 요청하는 예제 코드입니다.
API Reference: C2SModule.InappV4.RequestBalance
|
1 2 3 4 5 6 |
C2SModule.Parameter arg = new C2SModule.Parameter(); C2SModule.Error error; if(!C2SModule.InappV4.RequestBalance(arg. out error)) { // 에러 발생 시 처리 } |
API Reference: C2SModuleInappV4_RequestBalance
|
1 2 3 4 5 |
C2SModule_Cocos2dx::C2SModuleError eror; if( ::C2SModuleInappV4_RequestBalance(strJSON.c_str(), &error ) == false) // 에러 발생 시 처리 } |
API Reference: N/A
iOS에서는 Hive 러비 상점을 지원하지 않습니다.
러비 충전 화면 노출
러비 잔액이 부족한 경우 C2SModuleInappV4 클래스의 ChargeBalance() 메서드를 호출하여 러비 충전 화면을 노출합니다.
러비 충전을 완료한 후 잔액은 ChargeBalance() 메서드의 콜백에 balance 키 값으로 확인할 수 있습니다.
C2SModuleInappV4_ChargeBalance
- Request
별도 요청 데이터 없음 - Response
Argument Type Type Description Platform balance int Hive 러비 잔액 (1.18.4+) Android
다음은 러비 충전 페이지를 호출하는 예제 코드입니다.
API Reference: C2SModule.InappV4.ChargeBalance
|
1 2 3 4 5 6 |
C2SModule.Parameter arg = new C2SModule.Parameter(); C2SModule.Error error; if(!C2SModule.InappV4.ChargeBalance(arg. out error)) { // 에러 발생 시 처리 } |
API Reference: C2SModuleInappV4_ChargeBalance
|
1 2 3 4 5 |
C2SModule_Cocos2dx::C2SModuleError eror; if( ::C2SModuleInappV4_ChargeBalance(strJSON.c_str(), &error ) == false) // 에러 발생 시 처리 } |
API Reference: N/A
iOS에서는 Hive 러비 상점을 지원하지 않습니다.