查询商品列表及本地化价格显示

业务场景

用于商品界面的价格需要在不同地区对应显示该地区的货币和金额。

注意事项

  • 为提高用户体验, 此接口应今早调用(建议在 SDK 初始化成功后即调用), 以便让用户在点击商品时就能看到正确的本地化价格

流程图

接口介绍

/**
 * 查询商品列表及本地化价格显示
 * 支持平台:部分平台
 * 【Android】海外
 * 【iOS】海外
 */
 public void GetProductList(List<string> productIdList)

调用示例

List<string> productList = new List<string>();
SDKManager.GetInstance().GetProductList(productList);

//重写监听方法
public override void OnQuerySuccess(List<ProductInfo> list)
{
    string content = "";
    //追历列表
    foreach (var product in list)
    {
        string productId = product.productId;
        string price = product.price;
        string currency = product.currency;
        string displayPrice = product.displayPrice;
        string localPrice = product.localPrice;
        string localCurrency = product.localCurrency;
        string goodsDescription = product.goodsDescription;
        content += productId + "," + price + "," + currency + "," + displayPrice + "," + localPrice + "," + localCurrency + "," + goodsDescription + ";";
    }
}

// 查询商品列表及本地化价格显示失败
public override void OnQueryFailed(ErrorInfo errorInfo)
{
    int errorCode = errorInfo.errorCode;  // 错误码
    string errorMsg = errorInfo.errorMsg; // 错误信息
}

参数说明

出参

参数名称类型说明
listList商品列表
参数名称类型说明
productIdstring游戏方商品 Id
pricestring默认价格,与 SDK 交互时使用此价格,默认固定为美元,如:0.99
currencystringprice 对应的货币代号, 默认固定为 USD
displayPricestring显示价格,包含货币符号,如:NZD$1.42,所显示的价格为用户本地的价格和货币,与用户在 Google 支付界面实际支付金额一致,兑率由 Google 控制
localPricestring用户本地化价格,与 displayPrice 一致但不包含货币前缀,如:1.42
localCurrencystring用户本地化货币代号,与 localPrice 对应,如:NZD
goodsDescriptionstring商品描述

错误码

FAQ

Q:为什么要查询商品列表及本地化价格显示?

A:游戏方需要展示商品列表及本地化价格显示,需要通过接口查询商品列表及本地化价格显示数据。

Q:商品列表及本地化价格显示数据有什么用?

A:商品列表及本地化价格显示数据主要用于展示商品列表及本地化价格显示,包括商品 Id、默认价格、货币、显示价格、本地化价格、本地化货币、商品描述等信息。