Lebi

Google Play Store가 없는 중국 내에서 인앱 과금 처리를 위해 Hive 플랫폼에서 만든 모듈로써, 러비(Lebi)라는 단위의 가상화폐를 충전하여 아이템을 구매할 수 있습니다. Android 단말기는 경우에 따라 Google Play Store과 러비 중 어떤 결제 수단을 사용할지 선택할 수 있습니다. 러비를 선택한 경우 다음 안내에 따라 러비 결제를 구현하세요. iOS에서는 러비 상점을 지원하지 않습니다.

인증 v4 적용 시 중국 유저가 러비를 이용하려면 멤버십 로그인이 필요합니다.

러비 상점 연동 플로우¶

상점 선택 화면 노출¶

만약 Google Play Store와 러비 상점을 동시에 이용할 수 있는 상황이라면, marketConnect() 메서드 호출 결과로 Google Play Store와 러비 마켓 코드를 모두 받은 후(Hive IAP v4 초기화)에, 유저가 상점을 선택할 수 있도록 showMarketSelection() 메서드를 호출하여 상점 선택을 위한 화면을 노출해야 합니다.

Android 단말기에서 이용 가능한 마켓이 Google과 Hive 러비 두 종류일 경우 예제 화면

다음은 상점 선택 화면 노출을 요청하는 예제 코드입니다.

UnityUnreal EngineC++KotlinJava

API Reference: hive .IAPV4.showMarketSelection

using hive;    
    IAPV4.showMarketSelection((ResultAPI result, List<IAPV4Type> typeList) => {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::ShowMarketSelection(FIAPV4OnMarketSelectionDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<EHiveIAPV4Type>& MarketIds) {
        if (Result.IsSuccess()) {
                // API 호출 성공
        }
}));

API Reference: IAPV4 ::showMarketSelection

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::showMarketSelection([=](ResultAPI const & result, vector<IAPV4Type> const & marketIDs) {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

API Reference: IAPV4.showMarketSelection

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.showMarketSelection(object : IAPV4.IAPV4MarketInfoListener {    
         override fun onIAPV4MarketInfo(result: ResultAPI, iapV4TypeList: ArrayList<IAPV4.IAPV4Type>?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

API Reference: IAPV4 .INSTANCE.showMarketSelection

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    

    IAPV4.INSTANCE.showMarketSelection((result, iapV4TypeList) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

러비 잔액 조회 API¶

Hive플랫폼의 러비 상점이 선택되었다면 IAPV4 클래스의 getBalanceInfo() 메서드를 호출하여 러비 잔액 조회를 요청하고, 상점에 잔액을 노출해야 합니다. 러비 잔액은 getBalanceInfo() 메서드의 결과에 balance 변수로 전달받을 수 있습니다.

다음은 러비 잔액을 요청하는 예제 코드입니다.

UnityUnreal EngineC++KotlinJava

API Reference: hive .IAPV4.getBalanceInfo

using hive;    
    IAPV4.getBalanceInfo((ResultAPI result, int balance) => {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::GetBalanceInfo(FHiveIAPV4OnBalanceDelegate::CreateLambda([this](const FHiveResultAPI& Result, int32 balance) {
        if (Result.IsSuccess()) {
                // API 호출 성공
        }
}));

API Reference: IAPV4 ::getBalanceInfo

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::getBalanceInfo([=](ResultAPI const & result, int balance) {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

API Reference: IAPV4.getBalanceInfo

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.getBalanceInfo(object : IAPV4.IAPV4BalanceInfoListener {    
         override fun onIAPV4Balance(result: ResultAPI, balance: Int) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

API Reference: IAPV4 .INSTANCE.getBalanceInfo

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    

    IAPV4.INSTANCE.getBalanceInfo((result, balance) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

러비 충전 화면 노출¶

러비 잔액이 부족한 경우 IAPV4 클래스의 showCharge() 메서드를 호출하여 러비 충전 화면을 노출합니다. 러비 충전을 완료한 후 잔액은 showCharge() 메서드의 결과 값 중 balance 변수로 확인할 수 있습니다.

다음은 러비 충전 페이지를 호출하는 예제 코드입니다.

UnityUnreal EngineC++KotlinJava

API Reference: hive .IAPV4.showCharge

using hive;    
    IAPV4.showCharge((ResultAPI result, int balance) => {    
    if (result.isSuccess()) {    
    // call successful    
    }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::ShowCharge(FHiveIAPV4OnBalanceDelegate::CreateLambda([this](const FHiveResultAPI& Result, int32 balance) {
        if (Result.IsSuccess()) {
                // API 호출 성공
        }
}));

API Reference: IAPV4 ::showCharge

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::showCharge([=](ResultAPI const & result, int balance) {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

API Reference: IAPV4.showCharge

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.showCharge(object : IAPV4.IAPV4BalanceInfoListener {    
         override fun onIAPV4Balance(result: ResultAPI, balance: Int) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

API Reference: IAPV4 .INSTANCE.showCharge

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    

    IAPV4.INSTANCE.showCharge((result, balance) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});