IAP v4 初期化

IAP v4を有効にするには、購入前にIAP初期化をリクエストしてください。IAPを初期化するようリクエストすると、ゲームクライアントは利用可能なストア情報を返します。ストア情報はIAPV4Type列挙型として定義されており、フィールドの詳細は以下の通りです;

市場情報¶

フィールド名	説明
APPLE_APPSTORE	Apple App Store
GOOGLE_PLAYSTORE	Google Play Store
HIVE_LEBI	Lebi Store
ONESTORE	ONE Store
AMAZON_APPSTORE	Amazon App Store (SDK v4のみ利用可能)
SAMSUNG_GALAXYSTORE	Samsung Galaxy Store
HUAWEI_APPGALLERY	Huawei App Gallery
HIVESTORE	PG決済 (Windows、Unity専用)

HIVESTORE(PG決済)は商品検索と購入のみをサポートしており、クライアントベースの領収書検証はサポートされていません。

ゲーム内のソフト通貨市場は、ゲームのダウンロードサービスが停止した後でもゲームプレイを楽しむユーザーのために利用可能であるべきです。したがって、各ゲームスタジオはハード通貨市場とソフト通貨市場を別々にコーディングする必要があります。IAP v4を初期化することによって送信される結果値は、ゲーム内市場へのアクセス用ではないため、結果値を異なる方法で使用しないでください。IAP v4を初期化するために、IAPV4クラスにmarketConnect()を実装してください。

IAPv4を初期化する¶

以下はIAP v4を初期化するためのサンプルコードです。

UnityアンリアルエンジンC++KotlinJavaスウィフトObjective-C

APIリファレンス: hive.IAPV4.marketConnect

using hive;    
    IAPV4.marketConnect((ResultAPI result, List marketIdList) => {    
         if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::MarketConnect(FHiveIAPV4OnMarketConnectDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<EHiveIAPV4Type>& MarketIds) {
        if (Result.IsSuccess()) {
                // call successful 
        }
}));

APIリファレンス: IAPV4::marketConnect

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::marketConnect([=](ResultAPI const & result, vector const & marketIdList) {    
         if (result.isSuccess()) {    
            // call successful    
         }    
});

APIリファレンス: IAPV4.marketConnect

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.marketConnect(object : IAPV4.IAPV4MarketInfoListener {    
         override fun onIAPV4MarketInfo(result: ResultAPI, iapV4TypeList: ArrayList<IAPV4.IAPV4Type>?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

APIリファレンス: com.hive.IAPV4.marketConnect

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    IAPV4.INSTANCE.marketConnect((result, iapV4TypeList) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

API リファレンス: IAPV4Interface .marketConnect

import HIVEService    
    IAPV4Interface.marketConnect() { result, marketIdList in    
        if result.isSuccess() {    
        // call successful    
        }    
}

APIリファレンス: HIVEIAPV4::marketConnect

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 marketConnect: ^(HIVEResultAPI *result, NSArray<NSNumber *> *marketIdList) {    
         if ([result isSuccess]) {    
            // call successful    
         }    
}];

Warning

marketConnect() メソッド呼び出しに失敗すると、商品一覧の照会や購入を正常に進められません。主な原因は次のとおりです。

デバイスアカウントログインが正常に行われていない
Google Play Store / Apple App Store などのマーケットアプリへのログインが正常に行われていない
Hive Console の App ID に対するマーケット設定が正常に行われていない

複数マーケットのうち一部の接続に失敗しても、コールバックの marketList には Hive Console に設定された全マーケット が含まれます。実際の接続成功/失敗に関係なく、コンソール登録値がそのまま返されます。

例: App Store と Hive Store を設定したアプリで Hive Store 接続のみ失敗した場合

ResultAPI: エラーコードを返す
marketList: [APPLE_APPSTORE, HIVESTORE]（設定済み全マーケット）

したがって ResultAPI が失敗でも、marketList の全マーケットが正常接続されているとは限りません。失敗コード受信時は、**成功コールバックを受けるまで再試行**するか、**マーケット利用不可をポップアップで案内**する実装が必要です。

関連コードは IAP v4 Result API Guide を参照してください。

Notes for initialization¶

Hive SDK v4 Unity Windows 25.8.0 以降、Google Play 向け Windows アプリをサポートし、GOOGLE_PLAYSTORE を利用できます。開発時は次に注意してください。

初期化 (IAPV4.marketConnect) の前に PC Google Play Games アプリで Google アカウントにログインしておく必要があります。
manifest.xml ファイルの準備が必要です。

Hive SDK v4 iOS 26.3.2 以降では HIVESTORE（PG）マーケットを利用できます。