Hive IAP v4 초기화

IAP v4를 사용하기 위해서는 구매 전 한 번 IAP 초기화를 요청해야 합니다. IAP 초기화를 요청하면 앱 클라이언트에서 이용 가능한 스토어 정보를 결과 값으로 반환합니다.

스토어 정보¶

스토어 정보는 IAPV4Type enum으로 정의되어 있으며, 필드 설명은 다음과 같습니다.

• HIVESTORE PG는 상품 목록 조회와 구매까지만 지원하며, 클라이언트 기반의 영수증 검증은 과정에서 제외됩니다.
• DMM 스토어는 Windows에서 DMM GAME PLAYER를 통해 실행한 경우에만 사용하며, DMM 포인트 기반으로 동작합니다. 자세한 내용은 [DMM 결제 사용 전 확인 사항](#dmm-billing)을 참조하세요.

스토어에서 앱 서비스를 종료하더라도 기존 사용자가 게임 플레이를 지속하려면 게임 내 재화 상점에 접근할 수 있어야 합니다. 이를 위해 앱에서는 현금 결제 상점과 게임 내 재화 상점을 반드시 분리해 설계해야 합니다. IAP v4 초기화로 전달되는 결과 값은 게임 내 상점에 접근하는 용도가 아니니 목적과 다르게 사용하지 마세요.

IAP v4 초기화¶

IAP v4를 초기화하려면 IAPV4 클래스의 marketConnect() 메서드를 호출해야 합니다.

다음은 IAP v4를 초기화하는 예제 코드입니다.

using hive;    
    IAPV4.marketConnect((ResultAPI result, List marketIdList) => {    
         if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HiveIAPV4.h"

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

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

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

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    IAPV4.INSTANCE.marketConnect((result, iapV4TypeList) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    IAPV4Interface.marketConnect() { result, marketIdList in    
        if result.isSuccess() {    
        // call successful    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 marketConnect: ^(HIVEResultAPI *result, NSArray<NSNumber *> *marketIdList) {    
         if ([result isSuccess]) {    
            // call successful    
         }    
}];

초기화 결과 확인¶

여러 스토어를 사용하는 경우, 콜백으로 전달되는 marketList에는 Hive 콘솔에 설정된 스토어가 포함되며, 스토어 초기화 성공 여부에 따라 콜백이 다음과 같이 나뉩니다.

• 모든 스토어 또는 일부 스토어만 연결에 성공한 경우: ResultAPI는 성공을 반환하며, marketList에는 연결에 성공한 스토어만 전달됩니다.
• 모든 스토어 연결에 실패한 경우: ResultAPI는 에러 코드를 반환하며, marketList는 값 없음(null)을 반환합니다.

예를 들어, Hive 콘솔에 App Store와 PG(Hive Store)를 모두 설정한 앱에서 PG(Hive Store) 연결에만 실패한 경우:

• ResultAPI: 성공 반환
• marketList: [APPLE_APPSTORE] (성공한 스토어만 전달)

초기화 시 참고 사항¶

Hive SDK v4 Unity Windows 25.8.0부터 Google Play용 Windows 앱을 지원하며, GOOGLE_PLAYSTORE 스토어를 사용할 수 있습니다. 이 경우, 개발 시 아래 사항을 참고하세요.

• IAPV4.marketConnect 호출 전 PC용 Google Play 게임즈 앱에서 사용자가 Google 계정 로그인을 필수적으로 진행해야 함
• manifest.xml 파일 준비 필수

Hive SDK v4 iOS 26.3.2 이후 버전부터 PG(HIVESTORE)를 사용할 수 있습니다.