HIVE SDK for iOS

Classes | Typedefs | Functions
IAP

HIVE IAP can minimize the development costs of the market-specific purchase process and collect purchase logs consistently to provide information to business, development, and management departments. More...

Classes

class  HIVEIAPShop
 Store information configured in the HIVE IAP back office. More...
 
class  HIVEIAPProduct
 Product information created by HIVE IAP back office
It include (Market Pid) registered in the market(AppStore, PlayStore) and (Game Pid) registered in the HIVE IAP back office. More...
 
class  HIVEIAPReceipt
 purchase() 나 restoreReceipt() API 에서 받을 수 있는 결과 정보. More...
 
class  HIVEIAP
 HIVE IAP can minimize the development costs of the market-specific purchase process and collect purchase logs consistently to provide information to business, development, and management departments. More...
 

Typedefs

typedef void(^ HIVEIAPMarketInfoHandler) (HIVEResultAPI *result, NSArray< NSNumber *> *marketIDs)
 Result of information inquiry for HIVE IAP to organize stores and products. More...
 
typedef void(^ HIVEIAPShopInfoHandler) (HIVEResultAPI *result, HIVEIAPShop *iapShop, NSUInteger balance)
 HIVE IAP 백오피스에서 구성한 상점 정보 조회 결과 통지 More...
 
typedef void(^ HIVEIAPPurchaseHandler) (HIVEResultAPI *result, HIVEIAPProduct *product, NSString *iapTransactionId)
 Result of IAP purchase
Products ID are classified into two, one is 'marketPid' registered in Apple AppStore or Google PlayStore, the other is gamePid registered in HIVE IAP back office. More...
 
typedef void(^ HIVEIAPRestoreHandler) (HIVEResultAPI *result, NSArray< HIVEIAPProduct *> *productList, NSArray< NSString *> *iapTransactionIdList)
 Result of Restore HIVE IAP product which is not sent to user
In the process of purchasing a product, it may happen that the item fails to be delivered due to various situations. More...
 
typedef void(^ HIVEIAPPurchaseReceiptHandler) (HIVEResultAPI *result, HIVEIAPReceipt *receipt)
 Result of IAP purchase
Products ID are classified into two, one is 'marketPid' registered in Apple AppStore or Google PlayStore, the other is gamePid registered in HIVE IAP back office. More...
 
typedef void(^ HIVEIAPRestoreReceiptHandler) (HIVEResultAPI *result, NSArray< HIVEIAPReceipt *> *receiptList)
 Result of Restore HIVE IAP product which is not sent to user
In the process of purchasing a product, it may happen that the item fails to be delivered due to various situations. More...
 
typedef void(^ HIVEIAPCheckPromotePurchaseHandler) (HIVEResultAPI *result, NSString *gamePid)
 iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지 More...
 

Functions

typedef NS_ENUM (NSUInteger, HIVEIAPType)
 Market type. More...
 
(void) + HIVEIAP::initialize:
 Initialize HIVE IAP
HIVE IAP initialization will deliver a list of available market information in the result. More...
 
(void) + HIVEIAP::getShopInfo:handler:
 Return information for the configuration of shops and products
Stores can be exposed general shops, spot shops and event shops according to their sales strategy. More...
 
(void) + HIVEIAP::purchase:additionalInfo:handler:
 Purchase Item Products ID are classified into two, one is 'marketPid' registered in Apple AppStore or Google PlayStore, the other is 'pid' registered in HIVE IAP back office. More...
 
(void) + HIVEIAP::restoreReceipt:
 Restore HIVE IAP product which is not sent to user. More...
 

Detailed Description

HIVE IAP can minimize the development costs of the market-specific purchase process and collect purchase logs consistently to provide information to business, development, and management departments.


* Currently, HIVE IAP supports Apple App Store, Google Play Store, One Store (https://www.tstore.co.kr) and HIVE Lobby (Lebi).
HIVE LIVE (Lebi) store is a system that can organize stores and purchase goods in Chinese market. It is operated by HIVE itself.

Typedef Documentation

§ HIVEIAPCheckPromotePurchaseHandler

typedef void(^ HIVEIAPCheckPromotePurchaseHandler) (HIVEResultAPI *result, NSString *gamePid)

iTunes에서 Promotional In-App-Purchase를 통한 앱구매 예약에 대한 통지

Parameters
resultAPI call result
gamePid구매 예약한 상점아이템의 gamePid

§ HIVEIAPMarketInfoHandler

typedef void(^ HIVEIAPMarketInfoHandler) (HIVEResultAPI *result, NSArray< NSNumber * > *marketIDs)

Result of information inquiry for HIVE IAP to organize stores and products.

Parameters
resultAPI call result
marketIDsList of available market information
This list of market information means the market available to the game client.
If there is more than one market list, you should provide a screen that allows the user to select the store.
^(HIVEIAPMarketInfoHandler)(HIVEResultAPI *result, NSArray<NSNumber *> *marketIDs) {
if (result.isSuccess) {
for (NSNumber marketID in marketIDs) {
HIVEIAPType type = (HIVEIAPType)[marketID integerValue];
switch (type) {
// do something...
}
}
}
};

§ HIVEIAPPurchaseHandler

typedef void(^ HIVEIAPPurchaseHandler) (HIVEResultAPI *result, HIVEIAPProduct *product, NSString *iapTransactionId)

Result of IAP purchase
Products ID are classified into two, one is 'marketPid' registered in Apple AppStore or Google PlayStore, the other is gamePid registered in HIVE IAP back office.


The purchase of the HIVE IAP will require the gamePid registered in the HIVE IAP back office. (Note: You must call restore() before attempting a new purchase so that you can deliver an item that has not been delivered)

Parameters
resultAPI call result
Deprecated:
use HIVEIAPPurchaseReceiptHandler instead.

§ HIVEIAPPurchaseReceiptHandler

typedef void(^ HIVEIAPPurchaseReceiptHandler) (HIVEResultAPI *result, HIVEIAPReceipt *receipt)

Result of IAP purchase
Products ID are classified into two, one is 'marketPid' registered in Apple AppStore or Google PlayStore, the other is gamePid registered in HIVE IAP back office.


The purchase of the HIVE IAP will require the gamePid registered in the HIVE IAP back office. (Note: You must call restore() before attempting a new purchase so that you can deliver an item that has not been delivered)

§ HIVEIAPRestoreHandler

typedef void(^ HIVEIAPRestoreHandler) (HIVEResultAPI *result, NSArray< HIVEIAPProduct * > *productList, NSArray< NSString * > *iapTransactionIdList)

Result of Restore HIVE IAP product which is not sent to user
In the process of purchasing a product, it may happen that the item fails to be delivered due to various situations.


In order to prepare for this situation, you must restore for the item.

Parameters
resultAPI call result
productList구매 성공한 상품 정보 리스트
iapTransactionIdListHIVE IAP 서버의 트랜젝션 ID 리스트
Deprecated:
use HIVEIAPRestoreReceiptHandler instead.

§ HIVEIAPRestoreReceiptHandler

typedef void(^ HIVEIAPRestoreReceiptHandler) (HIVEResultAPI *result, NSArray< HIVEIAPReceipt * > *receiptList)

Result of Restore HIVE IAP product which is not sent to user
In the process of purchasing a product, it may happen that the item fails to be delivered due to various situations.


In order to prepare for this situation, you must restore for the item.

Parameters
resultAPI call result
receiptList구매 성공한 상품 정보 리스트

§ HIVEIAPShopInfoHandler

typedef void(^ HIVEIAPShopInfoHandler) (HIVEResultAPI *result, HIVEIAPShop *iapShop, NSUInteger balance)

HIVE IAP 백오피스에서 구성한 상점 정보 조회 결과 통지

Parameters
resultAPI 호출 결과
iapShop상점 정보
balanceHIVE Lebi 상점의 경우 잔액 정보 Result of shop information inquiry configured in HIVE IAP back office
resultAPI call result
iapShopShop information
balanceBalance information for HIVE Lebi stores

Function Documentation

§ getShopInfo:handler:()

+ (void) getShopInfo: (NSString *)  locationCode
handler: (HIVEIAPShopInfoHandler handler 

Return information for the configuration of shops and products
Stores can be exposed general shops, spot shops and event shops according to their sales strategy.

상점 정보 조회


Spot shops and event shops set the location code in the HIVE back office and insert the location code at the exposure location of the game.

Parameters
locationCodeStore location code set in back office
handlerAPI call result handler
account
locationCode
worldName
gameLanguage
handler

§ initialize:()

+ (void) initialize: (HIVEIAPMarketInfoHandler handler

Initialize HIVE IAP
HIVE IAP initialization will deliver a list of available market information in the result.


This list of market information means the market available on the game client.

Parameters
handlerAPI call result handler

§ NS_ENUM()

typedef NS_ENUM ( NSUInteger  ,
HIVEIAPType   
)

Market type.

< kHIVEIAPTypeAppStore Apple App Store

< kHIVEIAPTypeGoogle Google Play Store

< kHIVEIAPTypeLebi HIVE Lebi Store

< kHIVEIAPTypeOneStore One Store

§ purchase:additionalInfo:handler:()

+ (void) purchase: (NSString *)  pid
additionalInfo: (NSString *)  additionalInfo
handler: (HIVEIAPPurchaseReceiptHandler handler 

Purchase Item Products ID are classified into two, one is 'marketPid' registered in Apple AppStore or Google PlayStore, the other is 'pid' registered in HIVE IAP back office.


The purchase of the HIVE IAP will require the 'pid' registered in the HIVE IAP back office (Note: You must call restore() before attempting a new purchase so that you can deliver an item that has not been delivered)

Parameters
pidProduct specific code managed by HIVE IAP system.
additionalInfo구매 요청에 대한 보충 정보를 포함한 문자열로, 개발자가 지정합니다.
handlerAPI call result handler

§ restoreReceipt:()

+ (void) restoreReceipt: (HIVEIAPRestoreReceiptHandler handler

Restore HIVE IAP product which is not sent to user.


In the process of purchasing a product, it may happen that the item fails to be delivered due to various situations.
In order to prepare for this situation, you must restore for the item.

Parameters
handlerAPI call result handler
Copyright © GAMEVIL COM2US PLATFORM Inc. All Right Reserved. Terms of Use Privacy Policy