iOS 11 버전부터 ‘App Store에 노출한 인앱 상품의 인게임 구매 연동’ (이하 Promotional IAP) 기능을 지원합니다. Apple App Store의 상품 페이지 및 검색창에서 게임 내 인앱 상품을 노출할 수 있으며, 최대 20개까지 등록 가능합니다. Promotional IAP로 등록한 상품은 iOS 11 버전 이상에서만 볼 수 있습니다.
Promotional IAP에 대한 자세한 설명은 다음을 참고해주세요.
Promotional IAP를 구현하기 위해 Hive SDK에서는 Apple App Store에서 구매 요청이 들어온 마켓 PID 값을 반환해주는 checkPromotePurchase API를 제공합니다. checkPromotePurchase API를 호출하기 전에 게임에서는 다음의 선행 작업을 수행해야 합니다.
두 작업이 완료되었다면 IAP v4 초기화 이후 UE 전역 콜백을 통해서 iappromote 이벤트를 받을 수 있으며 이벤트 전달 시, 상품 목록 조회를 호출 후 checkPromotePurchase API를 호출하여 App Store에서 구매 요청이 들어온 마켓 PID 값을 반환받을 수 있습니다. 마켓 PID를 반환받았다면 마켓 PID에 해당하는 상품을 구매할 수 있도록 구현하세요.
API Reference: hive.IAPV4.checkPromotePurchase
|
1 2 3 4 5 6 7 |
using hive; IAPV4.checkPromotePurchase((ResultAPI result, String marketPid) => { if (result.isSuccess()) { // TODO: marketPid 확인 및 purchase API로 상품 구매 진행 } }); |
API Reference: IAPV4::checkPromotePurchase
|
1 2 3 4 5 6 7 8 9 |
#include <HIVE_SDK_Plugin/HIVE_CPP.h> using namespace std; using namespace hive; IAPV4::checkPromotePurchase([=](ResultAPI const & result, string marketPid) { if (result.isSuccess()) { // TODO: marketPid 확인 및 purchase API로 상품 구매 진행 } } |
API Reference: IAPV4Interface.checkPromotePurchase
|
1 2 3 4 5 6 7 |
import HIVEService IAPV4Interface.checkPromotePurchase() { result, marketPid in if result.isSuccess() { // TODO: marketPid 확인 및 purchase API로 상품 구매 진행 } } |
API Reference: HIVEIAPV4 checkPromotePurchase
|
1 2 3 4 5 6 7 |
#import <HIVEService/HIVEService-Swift.h> [HIVEIAPV4 checkPromotePurchase: ^(HIVEResultAPI *result, NSString *marketPid) { if ([result isSuccess]) { // TODO: marketPid 확인 및 purchase API로 상품 구매 진행 } }]; |