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

业务场景

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

注意事项

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

流程图

无

接口介绍

/**
 * 查询商品列表及本地化价格显示
 * 支持平台：部分平台
 * 【Android】海外
 * 【iOS】海外
 */
void getProductList(Activity activity, List<String> productIdList, QueryProductCallback callback);

调用示例

// FIXME IyaGame_Doc: 查询商品信息列表, 必接, 游戏方在收到商品信息列表后, 应使用信息中的DisplayPrice来显示本地化价格; 如返回的列表为空, 则使用默认配置的商品信息(默认商品信息列表请咨询我方运营)
// FIXME IyaGame_Doc: 为提高用户体验, 此接口应今早调用(建议在SDK初始化成功后即调用), 以便让用户在点击商品时就能看到正确的本地化价格
SDKManager.getInstance().getProductList(this, productIdList, new QueryProductCallback() {
   @Override
   public void onQuerySuccess(List<ProductInfo> list) {
     // 查询成功
     if (list != null && !list.isEmpty()) {
     // 查询到商品
     } else {
     // 没有查到商品
     }
   }

   @Override
   public void onQueryFailed(ErrorInfo errorInfo) {
    // 查询失败, 失败信息: errorInfo.getErrorMsg();
   }
});

参数说明

出参

ProductInfo：

字段名类型说明备注
productIdString游戏方商品Id
priceString默认价格，与SDK交互时使用此价格，如：0.99支付时传入此价格
currencyStringprice对应的货币代号， 默认为USD支付时传入此货币
displayPriceString显示价格，包含货币符号前缀，如：NZD$1.42所显示的价格为用户本地的价格和货币，与用户在Google支付界面实际支付金额一致，兑率由Google控制游戏展示商品价格（用户所在地货币）时使用此字段
localPriceString用户本地化价格，与displayPrice一致但不包含货币前缀，如：1.42
localCurrencyString用户本地化货币代号，与localPrice对应，如：**NZD

错误码

无

FAQ

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

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

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

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