商品リストの表示と購入

商品リストを検索¶

ユーザーがアプリ内ストアに入るときに、製品リスト検索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) {    
                 // call successful    
             }    
         }    
})

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つ以上一度の取引で購入することができます。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のeventEndコールバックを介してパラメータが返されると、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のアプリ審査プロセス中に購入撤回に関する通知が公開されていた場合、それがゲームの審査拒否の理由となる可能性があります。