查看产品列表和购买

搜尋產品列表¶

當用戶進入應用內商店時，調用產品列表搜索 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對您的應用進行檢查過程中公佈了有關購買撤回的通知，這可能會成為拒絕審核您遊戲的原因。