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 IAPv4 초기화

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

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

Unity®

API Reference: hive.IAPV4.marketConnect

C++

API Reference: IAPV4::marketConnect

Kotlin

API Reference: IAPV4.marketConnect

Java

API Reference: com.hive.IAPV4.marketConnect

Swift

API Reference: IAPV4Interface.marketConnect

Objective-C

API Reference: HIVEIAPV4::marketConnect

 

초기화 시 참고 사항

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

  • 초기화(IAPV4.marketConnect)는 AuthV4 IdP 로그인 이후에 실행해야 합니다.
  • IAPV4.marketConnect가 처음으로 호출될 때, 마켓에서 상품을 결제할 Google 계정을 선택하는 상품 결제용 Google 계정 로그인 화면이 앱 사용자에게 나타납니다. 이 로그인 과정은 앱 개발사가 구현하는 기능이 아니며, Hive SDK에서 자동으로 수행합니다.
  • 상품 결제용 Google 계정 로그인은 Hive SDK 인증 모듈(AuthV4)에서 제공하는 Google IdP 로그인과는 다릅니다. Google IdP를 포함해 어떤 IdP(AuthV4) 사용자가 로그아웃하면 상품 결제용 Google 계정도 자동으로 로그아웃됩니다.