查看产品列表和购买

搜尋產品列表¶

當用戶進入應用內商店時，調用產品列表搜索API。如果用戶請求產品列表，則返回包含產品信息的IAPV4Product類。

產品列表和詳細資訊¶

displayPrice¶

• 在訂單中發送顯示價格，結合貨幣符號和價格（例如 $0.99）。由於 Android 或 iOS 有其自己的顯示類型，貨幣符號和價格的順序可能會根據操作系統在不同國家顯示不同。
• 確保每個國家的貨幣符號與其表格相同。請參考識別政策以確認貨幣符號的表格。
• 如果需要添加或更改增值稅的其他國家，伺服器會計算所有貨幣的增值稅並添加到顯示價格、價格、顯示原始價格和原始價格中。因此，您不需要再處理與增值稅相關的工作。

要搜索产品列表，请在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    
         }    
}];

產品購買¶

在IAPV4類別中調用purchase()方法，使用市場PID，這是一個在Apple App Store和Google Play Store上註冊的參數，以請求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: Request verification of receipt with received receipt    
         }    
});

#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: Request verification of receipt with received receipt
        }
}));

#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: Request verification of receipt with received receipt    
         }    
});

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: Request verification of receipt with received receipt    
         }    
}

#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 商店允許用戶在單一交易中通過在購物車中指定數量來購買兩個或更多相同的應用內產品。如果您的 Google Play 控制台產品設置允許多數量購買，您的應用應該處理多數量購買並根據指定的購買數量交付商品。然而，多數量購買僅適用於可消耗的應用內產品，這些產品在消耗後可以再次購買。請勿為無法重複購買的產品啟用此功能。

呼叫 purchase() 方法前的注意事項¶

• 如果在因市場問題而調用 purchase() 方法時發送 RESPONSE_FAIL 或 CANCELED 錯誤，請通知用戶購買過程中發生錯誤。
• 如果因市場問題而通知用戶購買問題，請調用 restore() 方法以恢復購買。
• 如果在調用 purchase() 方法時發送 NEED_RESTORE 錯誤，則購買被取消。要恢復購買，請調用 restore() 方法。
• 如果計費系統嘗試離線支付或孩子要求父母代為支付時調用 purchase() 方法，則會發送 ITEM_PENDING 錯誤，該項目將進入待處理狀態。父母的代理購買在 Google Play 商店、亞馬遜和 Apple App Store 市場上受到支持。
• 如果成功進行離線支付或父母代替孩子進行支付，則通過 UserEngagement 發送 IAP_UPDATED 事件。 當通過 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對您的應用進行檢查過程中公開了購買撤回的通知，這可能會成為拒絕審核您遊戲的原因。