Android IAB v5查询商品详情不支持问题求助

原因分析 #

IAB v5引入的ProductDetails查询API，对设备的Google Play服务版本有最低要求（需≥20.0.0）。而API19（Android 4.4）这类老旧系统的设备，由于系统版本限制，Google Play服务无法升级到满足要求的版本，因此会返回FEATURE_NOT_SUPPORTED错误，导致无法获取商品详情。

另外，IAB v5的核心流程已完全基于ProductDetails设计，不再支持IAB v1中直接用SKU发起购买的逻辑，这也是无商品详情就无法推进购买的原因。

解决办法 #

1. 特性检测+分支处理 #

在发起商品查询前，先通过isFeatureSupported判断设备是否支持ProductDetails，再分别走不同的流程：

• 支持ProductDetails的设备（如API30+）：使用IAB v5官方推荐的ProductDetails查询流程。
• 不支持的设备（如API19）：降级使用IAB v5中仍保留的旧版SkuDetails查询API（虽标记为Deprecated，但可正常工作）。

2. 代码实现示例 #

// 初始化BillingClient后，先做特性检测
val featureResult = billingClient.isFeatureSupported(BillingClient.FeatureType.PRODUCT_DETAILS)
if (featureResult.responseCode == BillingClient.BillingResponseCode.OK) {
    // 走v5标准ProductDetails查询流程
    val productParams = QueryProductDetailsParams.newBuilder()
        .setProductList(listOf(
            QueryProductDetailsParams.Product.newBuilder()
                .setProductId("premium")
                .setProductType(BillingClient.ProductType.INAPP)
                .build()
        ))
        .build()
    billingClient.queryProductDetailsAsync(productParams) { response ->
        if (response.billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
            val productDetails = response.productDetailsList?.firstOrNull()
            productDetails?.let {
                // 发起购买流程
                val flowParams = BillingFlowParams.newBuilder()
                    .setProductDetailsParamsList(listOf(
                        BillingFlowParams.ProductDetailsParams.newBuilder()
                            .setProductDetails(it)
                            .build()
                    ))
                    .build()
                billingClient.launchBillingFlow(activity, flowParams)
            }
        }
    }
} else {
    // 降级使用旧版SkuDetails查询
    val skuParams = SkuDetailsParams.newBuilder()
        .setSkusList(listOf("premium"))
        .setType(BillingClient.SkuType.INAPP)
        .build()
    billingClient.querySkuDetailsAsync(skuParams) { responseCode, skuDetailsList ->
        if (responseCode == BillingClient.BillingResponseCode.OK && !skuDetailsList.isNullOrEmpty()) {
            val skuDetails = skuDetailsList.first()
            // 用SkuDetails发起购买
            val flowParams = BillingFlowParams.newBuilder()
                .setSkuDetails(skuDetails)
                .build()
            billingClient.launchBillingFlow(activity, flowParams)
        }
    }
}

3. 额外建议 #

• 对于API19及以下的老旧设备，可在应用内添加提示，告知用户由于系统/服务版本限制，部分功能可能受影响，建议升级设备。
• 检查Google Play Console中，"premium"商品ID的配置状态，确保其为有效应用内商品，未被移除或设置为不可用。
• 可通过GoogleApiAvailability.getInstance().getApkVersion(context)获取设备上的Google Play服务版本，辅助排查问题。

内容的提问来源于stack exchange，提问作者Bram