HIVE SDK for Unreal Engine

Classes | Enumerations | Functions
FHiveIAPV4

Hive IAP supports Apple AppStore, Google PlayStore, ONEStore, Samsung GalaxyStore,
Amazon AppStore, Huawei AppConnect, PG, Steam and Hive Lebi. More...

Classes

class  FHiveIAPV4
 Currently, Hive IAP supports Apple AppStore, Google PlayStore, ONEStore, Samsung GalaxyStore, Amazon AppStore, Facebook Cloud Games, Huawei AppConnect, PG, Steam and Hive Lebi. More...
 
class  FHiveIAPV4Product
 HIVE IAP 백오피스에서 생성한 상품 정보
마켓에 등록된 상품(Market Pid) 의 정보를 포함한다. More...
 
class  FHiveIAPV4Receipt
 Purchase 나 Restore API 에서 받을 수 있는 결과 정보. More...
 

Enumerations

enum class  EHiveIAPV4Type
 결제 마켓 형태 More...
 

Functions

static void FHiveIAPV4::MarketConnect (const FHiveIAPV4OnMarketConnectDelegate &Delegate)
 IAPV4 It initialize IAPV4 Purchase module. More...
 
static void FHiveIAPV4::GetMarketProductInfo (const TArray< FString > &MarketPidList, const FHiveIAPV4OnProductInfoDelegate &Delegate)
 Apple Appstore It returns information for composition of the product. More...
 
static void FHiveIAPV4::GetProductInfo (const FHiveIAPV4OnProductInfoDelegate &Delegate)
 Hive IAPV4 It returns information for composition of the product. More...
 
static void FHiveIAPV4::GetSubscriptionProductInfo (const FHiveIAPV4OnProductInfoDelegate &Delegate)
 Hive IAPV4 It returns information for composition of the product. More...
 
static void FHiveIAPV4::Purchase (const FString &MarketPid, const FString &IapPayload, const FHiveIAPV4OnPurchaseDelegate &Delegate)
 Request purchase of market product (marketPid) registered in App Store, Google Store, etc. More...
 
static void FHiveIAPV4::Purchase (const FString &MarketPid, const FString &IapPayload, int quantity, const FHiveIAPV4OnPurchaseDelegate &Delegate)
 Request purchase of market product (marketPid) registered in App Store, Google Store, etc. More...
 
static void FHiveIAPV4::PurchaseSubscription (const FHiveIAPV4PurchaseParam &Param, const FHiveIAPV4OnPurchaseDelegate &Delegate)
 Request purchase of market product (marketPid) registered in App Store, Google Store, etc. More...
 
static void FHiveIAPV4::Restore (const FHiveIAPV4OnRestoreDelegate &Delegate)
 Hive IAPV4 It restore the item that has not been delivered. More...
 
static void FHiveIAPV4::RestoreSubscription (const FHiveIAPV4OnRestoreDelegate &Delegate)
 HIVE IAPV4 It restore the item that has not been delivered. More...
 
static void FHiveIAPV4::TransactionFinish (const FString &MarketPid, const FHiveIAPV4OnTransactionFinishDelegate &Delegate)
 HIVE IAP v4 It requests the transaction completion processing for the purchase receipt of the item that have been delivered. More...
 
static void FHiveIAPV4::TransactionMultiFinish (const TArray< FString > &MarketPidList, const FHiveIAPV4OnTransactionMultiFinishDelegate &Delegate)
 Hive IAP v4 It requests the multiple transaction completion processing for the purchase receipt of the item that have been delivered. More...
 
static void FHiveIAPV4::ShowMarketSelection (const FIAPV4OnMarketSelectionDelegate &Delegate)
 It shows a UI to select a Lebi store or a Google store..
If the Google Store and the HIVE Lebi store are available at the same time, you should expose the store selection screen to allow the user to select a store. More...
 
static void FHiveIAPV4::GetBalanceInfo (const FHiveIAPV4OnBalanceDelegate &Delegate)
 It request Lebi balance information. More...
 
static void FHiveIAPV4::ShowCharge (const FHiveIAPV4OnBalanceDelegate &Delegate)
 It shows Lebi refill page. More...
 
static void FHiveIAPV4::CheckPromotePurchase (const FHiveIAPV4OnCheckPromotePurchaseDelegate &Delegate)
 Apple AppStore Promote InApp Purchase 동작으로 얻어온 MarketPID를 요청한다. More...
 
static TOptional< EHiveIAPV4TypeFHiveIAPV4::GetSelectedMarket ()
 현재 선택된 마켓 타입을 반환한다. More...
 
static FString FHiveIAPV4::GetAccountUuid ()
 현재 계정의 UUIDv3 값을 반환한다. More...
 
static void FHiveIAPV4::ShowInAppMessages (int32 CategoryId, const FHiveIAPV4OnInAppMessagesDelegate &Delegate)
 Google In-App Offers. More...
 
static void FHiveIAPV4::GetConsumeInfoAgreement (const FHiveIAPV4OnGetConsumeInfoAgreementDelegate &Delegate)
 소비정보 전송 약관에 대한 유저의 마지막 동의 상태 및 시기를 반환한다. More...
 
static void FHiveIAPV4::ShowConsumeInfoAgreement (const FHiveIAPV4OnShowConsumeInfoAgreementDelegate &Delegate)
 소비정보 전송 약관 팝업을 노출한다. More...
 

Detailed Description

Hive IAP supports Apple AppStore, Google PlayStore, ONEStore, Samsung GalaxyStore,
Amazon AppStore, Huawei AppConnect, PG, Steam and Hive Lebi.



Enumeration Type Documentation

◆ EHiveIAPV4Type

enum class EHiveIAPV4Type
strong

결제 마켓 형태

Function Documentation

◆ CheckPromotePurchase()

static void FHiveIAPV4::CheckPromotePurchase ( const FHiveIAPV4OnCheckPromotePurchaseDelegate &  Delegate)
static

Apple AppStore Promote InApp Purchase 동작으로 얻어온 MarketPID를 요청한다.


앱의 시작, 앱의 Background -> Foreground시에 이 API를 호출하여 MarketPID를 얻어오도록 한다.

얻어온 MarketPID로 구매를 진행하도록 한다.

Warning
iOS 11 이상에서만 지원한다.
Parameters
DelegateAPI 호출 결과 통지

◆ GetAccountUuid()

static FString FHiveIAPV4::GetAccountUuid ( )
static

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


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

◆ GetBalanceInfo()

static void FHiveIAPV4::GetBalanceInfo ( const FHiveIAPV4OnBalanceDelegate &  Delegate)
static

It request Lebi balance information.

Parameters
DelegateResult of API call

◆ GetConsumeInfoAgreement()

static void FHiveIAPV4::GetConsumeInfoAgreement ( const FHiveIAPV4OnGetConsumeInfoAgreementDelegate &  Delegate)
static

소비정보 전송 약관에 대한 유저의 마지막 동의 상태 및 시기를 반환한다.


Returns the lastest consent status and timing for the Consumption Information Transmission Terms.

◆ GetMarketProductInfo()

static void FHiveIAPV4::GetMarketProductInfo ( const TArray< FString > &  MarketPidList,
const FHiveIAPV4OnProductInfoDelegate &  Delegate 
)
static

Apple Appstore It returns information for composition of the product.


Parameters
DelegateResult of API call

◆ GetProductInfo()

static void FHiveIAPV4::GetProductInfo ( const FHiveIAPV4OnProductInfoDelegate &  Delegate)
static

Hive IAPV4 It returns information for composition of the product.


Parameters
DelegateResult of API call

◆ GetSelectedMarket()

static TOptional< EHiveIAPV4Type > FHiveIAPV4::GetSelectedMarket ( )
static

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


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

◆ GetSubscriptionProductInfo()

static void FHiveIAPV4::GetSubscriptionProductInfo ( const FHiveIAPV4OnProductInfoDelegate &  Delegate)
static

Hive IAPV4 It returns information for composition of the product.


Parameters
DelegateResult of API call

◆ MarketConnect()

static void FHiveIAPV4::MarketConnect ( const FHiveIAPV4OnMarketConnectDelegate &  Delegate)
static

IAPV4 It initialize IAPV4 Purchase module.


When Hive IAPV4 is initialized, it sends a list of available market information in the result callback.
This list of market information means the market available on the game client.

Parameters
DelegateResult of API call

◆ Purchase() [1/2]

static void FHiveIAPV4::Purchase ( const FString &  MarketPid,
const FString &  IapPayload,
const FHiveIAPV4OnPurchaseDelegate &  Delegate 
)
static

Request purchase of market product (marketPid) registered in App Store, Google Store, etc.


iapPayload is supplementary information for the purchase request, and it can be checked in Receipt Verification after purchase,
but, in case of purchasing outside of the app, such as a promo code purchase etc., it can not be included in verification result.

Parameters
MarketPidUnique code registered on the App Store, Google Store or etc.
IapPayloadA string containing supplementary information about the purchase request, specified by the developer.
DelegateResult of API call

◆ Purchase() [2/2]

static void FHiveIAPV4::Purchase ( const FString &  MarketPid,
const FString &  IapPayload,
int  quantity,
const FHiveIAPV4OnPurchaseDelegate &  Delegate 
)
static

Request purchase of market product (marketPid) registered in App Store, Google Store, etc.


iapPayload is supplementary information for the purchase request, and it can be checked in Receipt Verification after purchase,
but, in case of purchasing outside of the app, such as a promo code purchase etc., it can not be included in verification result.

Parameters
MarketPidUnique code registered on the App Store, Google Store or etc.
IapPayloadA string containing supplementary information about the purchase request, specified by the developer.
quantitypayment quantity
DelegateResult of API call

◆ PurchaseSubscription()

static void FHiveIAPV4::PurchaseSubscription ( const FHiveIAPV4PurchaseParam &  Param,
const FHiveIAPV4OnPurchaseDelegate &  Delegate 
)
static

Request purchase of market product (marketPid) registered in App Store, Google Store, etc.


iapPayload is supplementary information for the purchase request, and it can be checked in Receipt Verification after purchase,
but, in case of purchasing outside of the app, such as a promo code purchase etc., it can not be included in verification result. When upgrading or downgrading a subscription-type product, the unique code oldMarketPid of the existing subscription product must be entered.

Parameters
ParamA collection of parameters required for purchase.
DelegateResult of API call

◆ Restore()

static void FHiveIAPV4::Restore ( const FHiveIAPV4OnRestoreDelegate &  Delegate)
static

Hive IAPV4 It restore the item that has not been delivered.


It may happen that the item delivery fails due to various situations in the product purchase process.
In order to prepare for this situation, you should request to deliver the item that has not been delivered.

Parameters
DelegateAPI 결과 통지

◆ RestoreSubscription()

static void FHiveIAPV4::RestoreSubscription ( const FHiveIAPV4OnRestoreDelegate &  Delegate)
static

HIVE IAPV4 It restore the item that has not been delivered.


Parameters
DelegateResult of API call

◆ ShowCharge()

static void FHiveIAPV4::ShowCharge ( const FHiveIAPV4OnBalanceDelegate &  Delegate)
static

It shows Lebi refill page.

Parameters
DelegateResult of API call

◆ ShowConsumeInfoAgreement()

static void FHiveIAPV4::ShowConsumeInfoAgreement ( const FHiveIAPV4OnShowConsumeInfoAgreementDelegate &  Delegate)
static

소비정보 전송 약관 팝업을 노출한다.


Displays the Consumption Information Transmission Terms Popup.

◆ ShowInAppMessages()

static void FHiveIAPV4::ShowInAppMessages ( int32  CategoryId,
const FHiveIAPV4OnInAppMessagesDelegate &  Delegate 
)
static

Google In-App Offers.

Parameters
categoryId3(PROMOTIONAL)
listenerInt(responseCode) 가 2(NAVIGATE_TO_DEV_APP_STORE) 일 경우 유저가 제안(Offer)를 확인하고 사용하기를 원한 상황입니다. 개발자는 유저가 구매할 인앱 항목을 선택할 수 있는 게임/앱 내 상점으로 (유저가 해당 화면에 없는 경우) 유저를 이동해야 합니다.

0 은 아무런 액션을 하지 않아도 되고, 음수는 에러상황 입니다.

◆ ShowMarketSelection()

static void FHiveIAPV4::ShowMarketSelection ( const FIAPV4OnMarketSelectionDelegate &  Delegate)
static

It shows a UI to select a Lebi store or a Google store..
If the Google Store and the HIVE Lebi store are available at the same time, you should expose the store selection screen to allow the user to select a store.

Parameters
DelegateResult of API call

◆ TransactionFinish()

static void FHiveIAPV4::TransactionFinish ( const FString &  MarketPid,
const FHiveIAPV4OnTransactionFinishDelegate &  Delegate 
)
static

HIVE IAP v4 It requests the transaction completion processing for the purchase receipt of the item that have been delivered.


At the completion of item delivery after purchasing or restoring, this API should be called to complete the purchase on the market.

Warning
If you do not notify the completion of the purchase to the market after payment has been made, it will be left as an unpaid item..
Since the unpaid items will continue to be recovered until the transactionFinish API call, you should check for duplicate receipts.
Parameters
MarketPidThe unique ID of the item for which the transaction is to be completed.
DelegateResult of API call

◆ TransactionMultiFinish()

static void FHiveIAPV4::TransactionMultiFinish ( const TArray< FString > &  MarketPidList,
const FHiveIAPV4OnTransactionMultiFinishDelegate &  Delegate 
)
static

Hive IAP v4 It requests the multiple transaction completion processing for the purchase receipt of the item that have been delivered.


At the completion of item delivery after purchasing or restoring, this API should be called to complete the purchase on the market.

Warning
If you do not notify the completion of the purchase to the market after payment has been made, it will be left as an unpaid item..
Since the unpaid items will continue to be recovered until the transactionFinish API call, you should check for duplicate receipts.
Parameters
MarketPidListThe list of unique ID of the item for which the transaction is to be completed.
DelegateResult of API call
Copyright © Com2uS Platform Corporation. All Right Reserved. Terms of Use Privacy Policy