Hive IAP v4를 사용하기 위해서는 SDK 초기화 진행 시 IAP v4(InappV4) 초기화를 요청해야 합니다. IAP 초기화를 요청하면 게임 클라이언트에서 이용 가능한 마켓 정보를 결과값으로 반환합니다. IAP 초기화는 C2SModuleSocial_Initialize 호출 시 자동 호출되며마켓 정보는 C2SModuleInappV4_Initialize 콜백으로 marketList(array) 키에 전달됩니다. marketList 데이터의 설명은 다음과 같습니다.

필드명 설명
apple_appstore Apple App Store
google_playstore Google Play Store
hive_lebi Hive 러비 상점
onestore 원스토어
amazon_appstore Amazon App Store
samsung_galaxystore Samsung Galaxy Store
huawei_appgallery Huawei App Gallery

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

 

마켓 연결

마켓 연결이 필요한 경우 MarketConnect()를 호출할 수 있습니다. (1.20.0+)
C2SModuleSocial_Initialize 호출 후 C2SModuleInappV4_Initialize 콜백으로 데이터 전달이 정상적으로 진행되지 않았거나 마켓을 다시 연결해야 하는 경우에 MarketConnect()를 호출합니다.

C2SModuleInappV4_MarketConnect

  • Request
    Argument Type Type Description Platform
    별도 설정 없음
  • Response
    Argument Type Type Description Platform
    marketList array (string) 사용 가능한 마켓 정보
    (marketList 데이터 표 참고)    		 all