商品リストの表示と購入

商品リストを検索¶

ユーザーがアプリ内ストアに入るときに、製品リスト検索APIを呼び出します。ユーザーが製品リストを要求した場合、製品情報を含むIAPV4Productクラスを返します。

商品リストと詳細¶

displayPrice¶

• 通貨記号と価格の組み合わせでdisplayPriceを送信します（例：$0.99）。AndroidやiOSはそれぞれ独自の表示形式を持っているため、通貨記号と価格の順序は、OSに応じて異なる国で異なる表示になることがあります。
• 各国の通貨記号をその表と同じように出力することを確認してください。通貨記号の表を確認するには、識別子ポリシーを参照してください。
• 追加の国を追加したりVATを変更する場合、サーバーはすべての通貨のVATを計算し、displayPrice、price、displayOriginalPriceおよびoriginalPriceに追加します。したがって、VATに関連する作業はもうありません。

製品リストを検索するには、IAPV4クラスのgetProductInfo()メソッドを呼び出して、リストの製品情報とLebi残高を受け取ります。
以下は、製品リストの検索をリクエストするためのサンプルコードです。

using hive;    
    IAPV4.getProductInfo((ResultAPI result, List<IAPV4Product> productInfoList, int balance) => {    
         if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::GetProductInfo(FHiveIAPV4OnProductInfoDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<FHiveIAPV4Product>& ProductInfoList, uint32 Balance) {
        if (Result.IsSuccess()) {
                // call successful
        }
}));

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

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.getProductInfo(object : IAPV4.IAPV4ProductInfoListener {    
         override fun onIAPV4ProductInfo(result: ResultAPI, iapV4ProductList: ArrayList<IAPV4.IAPV4Product>?, balance: Int) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

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

import HIVEService    
    IAPV4Interface.getProductInfo() { result, productInfoList, balance in    
        if result.isSuccess() {    
            // call successful    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 getProductInfo: ^(HIVEResultAPI *result, NSArray<HIVEIAPV4Product *> *productInfoList, NSUInteger balance) {    
         if ([result isSuccess]) {    
            // call successful    
         }    
}];

商品購入¶

purchase()メソッドをIAPV4クラスで呼び出し、Apple App StoreおよびGoogle Play Storeに登録されたパラメータであるMarket PIDを使用して、IAP v4での製品購入をリクエストします。

以下は、製品購入をリクエストするためのサンプルコードです。

using hive;    
    String marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    String iapPayload = "{YOUR_CUSTOM_PAYLOAD}"    

    IAPV4.purchase(marketPid, iapPayload, (ResultAPI result, IAPV4Receipt receipt) => {    
    if (result.isSuccess()) {    
             // TODO: 受け取ったレシートでレシートの検証をリクエストする    
         }    
});

#include "HiveIAPV4.h"

FString MarketPid = TEXT("YOUR_PRODUCT_MARKET_PID");
FString IapPayload = TEXT("YOUR_CUSTOM_PAYLOAD");

FHiveIAPV4::Purchase(MarketPid, IapPayload, FHiveIAPV4OnPurchaseDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveIAPV4Receipt& Receipt) {
        if (Result.IsSuccess()) {
                //TODO: 受領書の検証を要求する
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    string marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    string iapPayload = "{YOUR_CUSTOM_PAYLOAD}";    
    IAPV4::purchase(marketPid, iapPayload, [=](ResultAPI const & result, IAPV4Receipt const & receipt) {    
         if (result.isSuccess()) {    
             // TODO: 受領書の検証を要求する    
         }    
});

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    val marketPid = "{YOUR_PRODUCT_MARKET_PID}"    
    val iapPayload = "{YOUR_CUSTOM_PAYLOAD}"    
    IAPV4.purchase(marketPid, iapPayload, object : IAPV4.IAPV4PurchaseListener {    
         override fun onIAPV4Purchase(result: ResultAPI, iapV4Receipt: IAPV4.IAPV4Receipt?) {    
             if (result.isSuccess) {    
                 // 成功した場合の呼び出し    
             }    
         }    
})

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    String marketPid = "{YOUR_PRODUCT_MARKET_PID}";    
    String iapPayload = "{YOUR_CUSTOM_PAYLOAD}";    
    IAPV4.INSTANCE.purchase(marketPid, iapPayload, (result, iapV4Receipt) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    let marketPid = "{YOUR_PRODUCT_MARKET_PID}"    
    let iapPayload = "{YOUR_CUSTOM_PAYLOAD}"    

    HIVEIAPV4.purchase(marketPid, iapPayload: iapPayload) { result, receipt in    
         if result.isSuccess() {    
             // TODO: 受け取ったレシートでレシートの検証をリクエストする    
         }    
}

#import <HIVEService/HIVEService-Swift.h> 

NSString *marketPid = @"{YOUR_PRODUCT_MARKET_PID}";
NSString *iapPayload = @"{YOUR_CUSTOM_PAYLOAD}";

[HIVEIAPV4 購入: marketPid iapPayload: iapPayload handler: ^(HIVEResultAPI *result, HIVEIAPV4Receipt *receipt) {
    if ([result isSuccess]) {
        // TODO: 受け取ったレシートでレシートの検証をリクエストする
    }
}];

iapPayload を使用する¶

購入 (purchase()) またはサブスクリプション (purchaseSubscription) メソッドを実行する際に、ゲーム会社は引数として iapPayload を渡すことができます。 iapPayload はゲーム会社によって定義された購入メタデータです。たとえば、ユーザーが製品を購入する際には、購入時間、購入ユーザー情報、購入したゲームキャラクター情報、購入数量（消耗品）、購入トークンなどが含まれる場合があります。

iapPayloadが引数として渡されると、IAPサーバーは購入レシートを検証します、このiapPayload値がどの購入レシートに対応するかを照合し、ゲームサーバーに通知します。具体的には、iapPayload値とユニークなレシートキーに対応するhiveiap_transaction_id値が照合され、ゲームサーバーに送信されます。

購入レシートとiapPayloadペアを利用することで、多くの問題を解決できます。例えば、ユーザーがアイテムを購入した際にエラーが発生し、支払いは完了したがアイテムが配信されなかったという状況が考えられます。この時、restore()メソッドを実行すれば、そのアイテムの購入レシートを取得できます。しかし、このレシートにはアイテムの種類、購入した時間、どのキャラクターがこのアイテムを購入したかに関する情報が含まれていないため、ゲーム会社がユーザーのためにどのアイテムを復元すべきか正確に知ることは難しいです。しかし、この情報は購入レシートにペアで付随するiapPayloadを通じて知ることができるため、ユーザーにアイテムを提供することができます。

消耗品の購入数量を設定する¶

Google Playストアでは、ユーザーがショッピングカートで数量を指定することにより、同じアプリ内製品を2つ以上1回の取引で購入できるようになっています。Google Play Consoleの製品設定で複数数量の購入が許可されている場合、アプリは複数数量の購入を処理し、指定された購入数量に基づいてアイテムを提供する必要があります。ただし、複数数量の購入は消耗品のアプリ内製品にのみ適用され、消費後に再度購入できる製品です。この機能を繰り返し購入できない製品には有効にしないでください。

purchase() メソッドを呼び出す前の注意事項¶

• purchase() メソッドを呼び出す際に RESPONSE_FAIL または CANCELED エラーが市場の問題により送信された場合、購入プロセスにエラーが発生したことをユーザーに通知します。
• 市場の問題により購入の問題がユーザーに通知された場合、restore() メソッドを呼び出して購入を復元します。
• purchase() メソッドを呼び出す際に NEED_RESTORE エラーが送信された場合、購入はキャンセルされます。購入を復元するには、restore() メソッドを呼び出します。
• 請求システムがオフラインで支払おうとした場合や、子供が親に代わって支払うように頼んだ場合に purchase() メソッドを呼び出すと、ITEM_PENDING エラーが送信され、アイテムは保留状態になります。親の代理購入は、Google Play ストア、Amazon および Apple App Store 市場でサポートされています。
• オフライン支払いに成功した場合や、親が子供の代わりに支払いを行った場合、IAP_UPDATED イベントが UserEngagement を通じて送信されます。 UserEngagement イベントの end コールバックを介してパラメータが返された場合、type が "subscription" の場合は restoreSubscription() を呼び出し、type が空の場合は restore() を呼び出します。これらのメソッドを呼び出すことで、完了したレシートを確認できます。
• 利用できない購入を通知する NOT_SUPPORTED エラーのトラブルシューティングを行うには、アプリ内購入を制限するためのフレーズガイドを参照してください。
• デスクトップ環境で HIVESTORE を通じて購入する際、支払いリクエスト画面が新しいウィンドウに表示されます。

hive.IAPV4.purchase(marketPid, null, onIAPV4PurchaseCB); を呼び出すと、ErrorCode:IAPSUCCESS=90 と Code:IAPV4HiveStoreSuccess=-6110000 のレスポンスが即座に返され、領収書情報は含まれません。これは onIAPV4PurchaseCB を通じて行われます。ErrorCode（またはCode）に基づいて、アイテム配布資格の状態に関するガイダンスメッセージを表示することが可能です。

• Google PlayのWindowsアプリ（Hive SDK v4 Unity Windows 23.0.0以上）でGOOGLE\_PLAYSTOREマーケットを使用している場合、支払いに使用されたGoogleアカウントの認証情報が期限切れになると、Hive SDKは自動的に再認証プロセスを実行します。
• Google PlayのWindowsアプリ（Hive SDK v4 Unity Windows 23.0.0以上）でGOOGLE\_PLAYSTOREマーケットを使用している場合、ユーザーがアプリに表示された支払い待機ポップアップで確認ボタンを押し、支払いの完了が確認されていない場合、onIAPV4PurchaseCBを介してErrorCode:IAPSUCCESS=90およびCode:IAPV4PendingPurchase=-6100013のレスポンスが返されます。このレスポンスは支払いが失敗したことを示すものではなく、内部エラーのために支払いの完了が確認できなかったか、ユーザーが支払いを行わなかったことを示しています。この場合、領収書は返されず、ユーザーが支払いブラウザウィンドウで支払いを完了している場合、IAPV4.restoreを通じて領収書を取得できます。

購入エラーコード¶

アプリ内購入を制限するフレーズ¶

購入キャンセルポリシーを通知するフレーズ¶

コンテンツ産業振興法に従い、ゲームストアに購入の撤回に関する通知と購入撤回ポリシーへのリンクを表示してください。iOSの場合、Appleのアプリ審査プロセス中に購入撤回に関する通知が表示されていた場合、それがゲームの審査拒否の理由となる可能性があります。