查看产品列表并购买

搜索产品列表¶

当用户进入应用内商店时调用产品列表搜索API。如果用户请求产品列表，返回包含产品信息的IAPV4Product类。

产品列表和详情¶

displayPrice¶

• 在订单中发送带有货币符号和价格的displayPrice（例如 $0.99）。由于Android或iOS有其自己的显示类型，因此货币符号和价格的顺序在不同国家可能会有所不同，具体取决于操作系统。
• 确保输出每个国家的货币符号与其表格相同。请参考标识符政策以确认货币符号的表格。
• 如果需要添加或更改增值税，服务器会计算所有货币的增值税并将其添加到displayPrice、price、displayOriginalPrice和originalPrice中。因此，您无需再处理与增值税相关的工作。

要搜索产品列表，请在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()) {    
         // 调用成功    
         }    
});

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: 请求验证收到的收据    
         }    
}

#import <HIVEService/HIVEService-Swift.h>

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

[HIVEIAPV4 购买: marketPid iapPayload: iapPayload 处理程序: ^(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 应用商店市场中得到支持。
• 如果成功进行离线支付或父母代替孩子支付，则通过 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，如果在苹果对您的应用进行检查时公开了关于购买撤回的通知，这可能是拒绝审核您游戏的原因。