HIVE SDK for Unity3D

클래스 | 함수
IAPV4

클래스

class  hive.IAPV4
 현재 Hive IAP 가 제공하는 결제 마켓은 애플 앱스토어, 구글 플레이스토어, 원스토어, 삼성 갤럭시스토어, 아마존 앱스토어, 페이스북 클라우드 게임, 화웨이 앱커넥트, PG, Steam, Hive 러비(Lebi) 를 제공한다. 더 자세히 ...
 

함수

delegate void hive.IAPV4.onIAPV4MarketInfo (ResultAPI result, List< IAPV4Type > iapV4TypeList)
 HIVE IAPV4 에서 마켓의 구성을 위한 정보 조회 결과 통지
 
delegate void hive.IAPV4.onIAPV4ProductInfo (ResultAPI result, List< IAPV4Product > iapV4ProductList, int balance)
 HIVE IAPV4 상품 정보 조회 결과 통지
 
delegate void hive.IAPV4.onIAPV4Purchase (ResultAPI result, IAPV4Receipt iapV4Receipt)
 상품 결제 시도 결과 통지
App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.
 
delegate void hive.IAPV4.onIAPV4Restore (ResultAPI result, List< IAPV4Receipt > iapv4ReceiptList)
 HIVE IAPV4 상품에 대한 미지급된 아이템 지급을 요청 결과 통지
상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다.
 
delegate void hive.IAPV4.onIAPV4TransactionFinish (ResultAPI result, String marketPid)
 HIVE IAP v4에서 상품에 대한 지급 완료 후 결제 트랜잭션을 종료하기 위한 요청 결과 통지

 
static void hive.IAPV4.marketConnect (onIAPV4MarketInfo listener)
 IAPV4 결재 API 초기화 요청
HIVE IAPV4 의 초기화를 수행하면 결과 통지시 사용 가능한 마켓 정보의 목록을 전달하게 된다.
 
static void hive.IAPV4.getMarketProductInfo (List< String > marketPidList, onIAPV4ProductInfo listener)
 Hive IAPV4 에서 마켓 상품의 구성을 위한 정보를 조회할 수 있다.
 
static void hive.IAPV4.getProductInfo (onIAPV4ProductInfo listener)
 HIVE IAPV4 에서 상품의 구성을 위한 정보를 조회할 수 있다.
 
static void hive.IAPV4.getSubscriptionProductInfo (onIAPV4ProductInfo listener)
 HIVE IAPV4 에서 구독형 상품의 구성을 위한 정보를 조회할 수 있다.
 
static void hive.IAPV4.purchase (String marketPid, String iapPayload, onIAPV4Purchase listener)
 App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.
 
static void hive.IAPV4.purchaseSubscriptionUpdate (String marketPid, String oldMarketPid, String iapPayload, onIAPV4Purchase listener)
 App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.
 
static void hive.IAPV4.purchaseSubscription (IAPV4PurchaseParam param, onIAPV4Purchase listener)
 App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.
 
static void hive.IAPV4.restore (onIAPV4Restore listener)
 HIVE IAPV4 상품에 대한 미지급된 아이템 지급을 요청한다.
 
static void hive.IAPV4.restoreSubscription (onIAPV4Restore listener)
 HIVE IAPV4 상품에 대한 미지급된 구독 상품 지급을 요청한다.
 
static void hive.IAPV4.transactionFinish (String marketPid, onIAPV4TransactionFinish listener)
 HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 트랜잭션 완료 처리를 요청한다.
 
static void hive.IAPV4.transactionMultiFinish (List< String > marketPidList, onIAPV4TransactionMultiFinish listener)
 HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 복수 개의 트랜잭션 완료 처리를 요청한다.
 
static IAPV4Type hive.IAPV4.getSelectedMarket ()
 현재 선택된 마켓 타입을 반환한다.
 
static string hive.IAPV4.getAccountUuid ()
 현재 계정의 UUIDv3 값을 반환한다.
 

상세한 설명

함수 문서화

◆ getAccountUuid()

static string hive.IAPV4.getAccountUuid ( )
static

현재 계정의 UUIDv3 값을 반환한다.


Returns the Hive account ID converted to a UUID version 3. return null, if not logged in.

Since
4.16.3.0
반환값
accountUuid

◆ getMarketProductInfo()

static void hive.IAPV4.getMarketProductInfo ( List< String > marketPidList,
onIAPV4ProductInfo listener )
static

Hive IAPV4 에서 마켓 상품의 구성을 위한 정보를 조회할 수 있다.


매개변수
listenerAPI 결과 통지

◆ getProductInfo()

static void hive.IAPV4.getProductInfo ( onIAPV4ProductInfo listener)
static

HIVE IAPV4 에서 상품의 구성을 위한 정보를 조회할 수 있다.


매개변수
listenerAPI 결과 통지

◆ getSelectedMarket()

static IAPV4Type hive.IAPV4.getSelectedMarket ( )
static

현재 선택된 마켓 타입을 반환한다.


얻어온 마켓 타입으로 구매를 진행하도록 한다.

참고
#marketConnect(IAPV4MarketInfoListener)

◆ getSubscriptionProductInfo()

static void hive.IAPV4.getSubscriptionProductInfo ( onIAPV4ProductInfo listener)
static

HIVE IAPV4 에서 구독형 상품의 구성을 위한 정보를 조회할 수 있다.


매개변수
listenerAPI 결과 통지
Since
4.11.6

◆ marketConnect()

static void hive.IAPV4.marketConnect ( onIAPV4MarketInfo listener)
static

IAPV4 결재 API 초기화 요청
HIVE IAPV4 의 초기화를 수행하면 결과 통지시 사용 가능한 마켓 정보의 목록을 전달하게 된다.


이 마켓 정보의 목록은 게임 클라이언트에서 사용 가능한 마켓을 의미한다.

매개변수
listenerAPI 결과 통지

◆ onIAPV4MarketInfo()

delegate void hive.IAPV4.onIAPV4MarketInfo ( ResultAPI result,
List< IAPV4Type > iapV4TypeList )

HIVE IAPV4 에서 마켓의 구성을 위한 정보 조회 결과 통지

매개변수
resultAPI 호출 결과
iapV4TypeList사용 가능한 마켓 정보의 목록
이 마켓 정보의 목록은 게임 클라이언트에서 사용 가능한 마켓을 의미한다.
마켓 목록이 2개 이상이라면 유저가 상점을 선택할 수 있도록 게임에서 유저에게 노출할 수 있는 화면을 제공해야 한다
참고
#marketConnect(onIAPV4MarketInfo)

◆ onIAPV4ProductInfo()

delegate void hive.IAPV4.onIAPV4ProductInfo ( ResultAPI result,
List< IAPV4Product > iapV4ProductList,
int balance )

HIVE IAPV4 상품 정보 조회 결과 통지

매개변수
resultAPI 호출 결과
iapV4ProductList상품 정보
balanceHIVE Lebi 마켓의 경우 잔액 정보
참고
getProductInfo(onIAPV4ProductInfo)

◆ onIAPV4Purchase()

delegate void hive.IAPV4.onIAPV4Purchase ( ResultAPI result,
IAPV4Receipt iapV4Receipt )

상품 결제 시도 결과 통지
App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.


iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수
resultAPI 호출 결과
iapV4Receipt구매 성공한 상품 정보 와 영수증
참고
#purchase(String, String, IAPV4PurchaseListener)

◆ onIAPV4Restore()

delegate void hive.IAPV4.onIAPV4Restore ( ResultAPI result,
List< IAPV4Receipt > iapv4ReceiptList )

HIVE IAPV4 상품에 대한 미지급된 아이템 지급을 요청 결과 통지
상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다.


이런 상황을 대비하기 위해서 미 지급된 아이템 지급을 요청 해야 한다.

매개변수
resultAPI 호출 결과
iapv4ReceiptList구매 성공한 상품 정보 와 iapPayload 를 포함한 정보
참고
#restore(onIAPV4Restore)

◆ onIAPV4TransactionFinish()

delegate void hive.IAPV4.onIAPV4TransactionFinish ( ResultAPI result,
String marketPid )

HIVE IAP v4에서 상품에 대한 지급 완료 후 결제 트랜잭션을 종료하기 위한 요청 결과 통지

매개변수
resultAPI 호출 결과
marketPid트랜잭션이 종료된 상품의 marketPid
참고
#transactionFinish(String, onIAPV4TransactionFinish)

◆ purchase()

static void hive.IAPV4.purchase ( String marketPid,
String iapPayload,
onIAPV4Purchase listener )
static

App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.


iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다.

매개변수
marketPidApp Store, Google Store 등 에 등록된 하나의 상품을 지칭하는 고유 코드
iapPayload구매 요청에 대한 보충 정보를 포함한 문자열로, 개발자가 지정합니다.
listenerAPI 결과 통지

◆ purchaseSubscription()

static void hive.IAPV4.purchaseSubscription ( IAPV4PurchaseParam param,
onIAPV4Purchase listener )
static

App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.


iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다. 구독형 상품을 업그레이드하거나 다운그레이드를 수행하는 경우 기존에 구독 중인 상품의 고유코드 oldMarketPid를 필수로 넣어야 한다.

매개변수
param구매시 필요한 parameter 의 모음
listenerAPI 결과 통지
Since
4.16.4.0

◆ purchaseSubscriptionUpdate()

static void hive.IAPV4.purchaseSubscriptionUpdate ( String marketPid,
String oldMarketPid,
String iapPayload,
onIAPV4Purchase listener )
static

App Store, Google Store 등 에 등록된 마켓 상품(marketPid)의 구매를 요청 한다.


iapPayload 의 경우 구매 요청에 대한 보충 정보로 구매 후 영수증 검증에서 확인할 수 있다.
프로모 코드 구매 처럼 앱 외부에서 구매 등의 경우에는 포함될 수 없게 된다. 구독형 상품을 업그레이드하거나 다운그레이드를 수행하는 경우 기존에 구독 중인 상품의 고유코드 oldMarketPid를 필수로 넣어야 한다.

매개변수
marketPidApp Store, Google Store 에 등록된 하나의 상품을 지칭하는 고유 코드
oldMarketPid기존에 구독 중인 상품의 고유코드
iapPayload구매 요청에 대한 보충 정보를 포함한 문자열로, 개발자가 지정합니다.
listenerAPI 결과 통지
Since
4.11.6

◆ restore()

static void hive.IAPV4.restore ( onIAPV4Restore listener)
static

HIVE IAPV4 상품에 대한 미지급된 아이템 지급을 요청한다.


상품 구매 과정에서 여러가지 상황으로 인하여 아이템 지급을 실패하는 경우가 발생할 수 있다.
이런 상황을 대비하기 위해서 미 지급된 아이템 지급을 요청 해야 한다.

매개변수
listenerAPI 결과 통지

◆ restoreSubscription()

static void hive.IAPV4.restoreSubscription ( onIAPV4Restore listener)
static

HIVE IAPV4 상품에 대한 미지급된 구독 상품 지급을 요청한다.


상품 구매 과정에서 여러가지 상황으로 인하여 구독 상태를 갱신하지 못할 수 있다.
구독 상태를 확인할 수 없는 경우, 구독 상태 복구를 요청 해야 한다.

매개변수
listenerAPI 결과 통지
Since
4.11.6

◆ transactionFinish()

static void hive.IAPV4.transactionFinish ( String marketPid,
onIAPV4TransactionFinish listener )
static

HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 트랜잭션 완료 처리를 요청한다.


구매나 복구 기능 사용 후 아이템 지급이 완료된 시점에 이 API를 호출하여 마켓에 구매 완료 처리를 해야한다.

경고
만약, 지급 완료 후에도 마켓으로의 구매 완료 처리를 하지 않으면, 미지급된 상품으로 남는다.
미지급된 상품은 transactionFinish API 호출 전까지 계속 복구가 되므로, 영수증 중복 여부를 확인해야 한다.
매개변수
marketPid지급이 완료되어 트랜잭션 완료 처리를 위한 상품의 고유 ID
listenerAPI 결과 통지
참고
onIAPV4TransactionFinish
#transactionMultiFinish(List, onIAPV4TransactionMultiFinish)

◆ transactionMultiFinish()

static void hive.IAPV4.transactionMultiFinish ( List< String > marketPidList,
onIAPV4TransactionMultiFinish listener )
static

HIVE IAP v4에서 지급이 완료된 상품에 대한 구매 영수증에 대한 복수 개의 트랜잭션 완료 처리를 요청한다.


구매나 복구 기능 사용 후 아이템 지급이 완료된 시점에 이 API를 호출하여 마켓에 구매 완료 처리를 해야한다.

경고
만약, 지급 완료 후에도 마켓으로의 구매 완료 처리를 하지 않으면, 미지급된 상품으로 남는다.
미지급된 상품은 transactionFinish API 호출 전까지 계속 복구가 되므로, 영수증 중복 여부를 확인해야 한다.
매개변수
marketPidList지급이 완료되어 트랜잭션 완료 처리를 위한 상품의 고유 ID 목록
listenerAPI 결과 통지
참고
onIAPV4TransactionMultiFinish
#transactionFinish(String, onIAPV4TransactionFinish)
Copyright © Com2uS Platform Corporation. All Right Reserved. 이용약관 개인정보 처리방침