Hive IAP v4를 사용하기 위해서는 구매 전 한번 IAP 초기화를 요청해야 합니다. IAP 초기화를 요청하면 게임 클라이언트에서 이용 가능한 마켓 정보를 결과값으로 반환합니다. 마켓 정보는 IAPV4Type enum으로 정의되어 있으며, 필드 설명은 다음과 같습니다.
| 필드명 | 설명 |
|---|---|
| APPLE_APPSTORE | Apple App Store |
| GOOGLE_PLAYSTORE | Google Play Store |
| HIVE_LEBI | Hive 러비 상점 |
| ONESTORE | 원스토어 |
| AMAZON_APPSTORE | Amazon App Store (SDK v4 KS 전용) |
| SAMSUNG_GALAXYSTORE | Samsung Galaxy Store |
| HUAWEI_APPGALLERY | Huawei App Gallery |
| HIVESTORE | PG 결제 (Windows용, Unity만 지원) |
HIVESTORE(PG결제)는 상품 목록 조회와 구매까지만 지원하며, 클라이언트 기반의 영수증 검증은 과정에서 제외됩니다.
마켓에서 게임 서비스를 종료하더라도 기존 유저가 게임 플레이를 지속하려면 게임 내 재화 상점에 접근할 수 있어야 합니다. 이를 위해 게임 스튜디오에서는 현금 결제 상점과 게임 내 재화 상점을 반드시 분리해 설계해야 합니다. IAP v4 초기화로 전달되는 결과값은 게임 내 상점에 접근하는 용도가 아니니 목적과 다르게 사용하지 마세요. Hive IAP v4를 초기화하려면 IAPV4 클래스의 marketConnect() 메서드를 호출해야 합니다.
다음은 Hive IAP v4를 초기화하는 예제 코드입니다.
Unity®
API Reference: hive.IAPV4.marketConnect
|
1 2 3 4 5 6 7 8 9 |
// Hive IAP v4의 초기화 결과 콜백 핸들러 public void onIAPV4MarketConnectCB(ResultAPI result, List marketIdList) { if (result.isSuccess()) { } else { // Error Handling } } // Hive IAP v4의 초기화 요청 hive.IAPV4.marketConnect(onIAPV4MarketConnectCB); |
C++
API Reference: IAPV4::marketConnect
|
1 2 3 4 5 6 7 |
// Hive IAP v4의 초기화 요청 IAPV4::marketConnect([=](ResultAPI const & result, std::vector const & marketIDs){ if (result.isSuccess()) { } else { // Error Handling } }); |
Android
API Reference: com.hive.IAPV4.marketConnect
|
1 2 3 4 5 6 7 8 9 10 |
// Hive IAP v4의 초기화 요청 IAPV4.marketConnect(new IAPV4.IAPV4MarketInfoListener() { @Override public void onIAPV4MarketInfo(ResultAPI result, List iapV4TypeList) { if (result.isSuccess()) { } else { // Error Handling } } }); |
iOS
API Reference: HIVEIAPV4::marketConnect
|
1 2 3 4 5 6 7 |
// Hive IAP v4의 초기화 요청 [HIVEIAPV4 marketConnect:^(HIVEResultAPI *result, NSArray *marketIDs) { if( [result isSuccess] ) { } else { // Error Handling } }]; |