简单3步配置Google Play Billing | 系列分享

小提示：您能找到这篇{简单3步配置Google Play Billing | 系列分享}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的简单3步配置Google Play Billing | 系列分享内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

作者/Caren Chang,Android Engineer

Google Play Billing系列内容是专门为中文开发者开辟的系列分享，着重讲解中国开发者对Play Billing最容易感到疑惑的地方。

< ">销售数字内容是许多Android应用的主要营收渠道。具体形式包括销售应用内的特定商品(如游戏金币)以及订阅计划(比如允许用户在限定时间内访问高级功能)。Google Play Billing作为一个数字内容销售的工具和服务的集合，可以帮助开发者在Android应用中销售线上商品。

< ">本文将从基础知识开始，带大家逐步深入，详细了解Google Play Billing 3，及其用例和最佳实践。

< ">首先，我们来熟悉一下Google Play Billing的一些关键组件。

< ">< color: rgb(79, 129, 189);">Google Play管理中心(Google Play Console)-Google Play管理中心既是Android应用发布平台，也可以用于设置应用中销售的各种内容。在Play管理中心可以配置待出售的商品，包括价格点，以及针对每个产品进行高级配置，如提供订阅的免费试用期；

< ">< color: rgb(79, 129, 189);">Google Play Billing Library-这是您集成到Android应用中的开发库。使用此库连接Google Play就可以执行各种与销售相关的任务，例如在用户购买商品时处理购买流程；

< ">< color: rgb(79, 129, 189);">Google Play Developer API-一组REST API，可用于与Google Play通信。使用这些API可以查询和管理应用销售的商品。这些API还可以验证用户的购买中是否存在欺诈行为，或者检查订阅是否仍处于有效状态。

-Google Play管理中心

https://developer.android.google.cn/distribute/console

-< font-size: 14px; color: rgb(79, 129, 189);">Google Play Billing Library

https://developer.android.google.cn/google/play/billing/billing_library_overview

-< font-size: 14px; color: rgb(79, 129, 189);">Google Play Developer API

https://developers.google.cn/android-publisher

< ">了解了Google Play Billing的关键组件之后，我们将从头介绍如何设置环境并开始在Android应用中销售商品。

1.设置Android应用以使用Google Play Billing开发库

< ">第一步，也是最重要的一步，是设置Android应用以使用Google Play Billing开发库。

< ">向< background-color: rgb(242, 242, 242);">app/build.gradle文件中添加以下依赖关系，在应用中实现Google Play Billing:

implementation‘com.android.billingclient:billing:3.0.0’

< ">添加库依赖关系后，为应用构建一个发布版APK，并将其上传到Google Play管理中心。

2.添加应用内产品

< ">上传APK后，可以使用Google Play管理中心开始添加要在应用中销售的应用内产品。在"商店发布(Store Presence)"下，有一个设置应用内产品的部分。在这里可以设置两种类型的商品:

< ">托管产品(或一次性购买)

< ">订阅

< ">创建新的托管产品和订阅时，需要输入商品的产品ID(Product ID)或SKU。这个产品ID后续将在应用代码中使用，我们稍后会讲到。在创建托管产品之前，应慎重规划产品ID。产品ID在应用中必须唯一，并且在创建后无法更改或重复使用。

< ">为了使测试更快、更简单，您可以< color: rgb(79, 129, 189);">将您的Google帐号添加到Google Play开发者帐号的"许可测试(License Testing)"中。这样，只要软件包名称与Play Store中的APK匹配，就可以使用调试版本和调试签名进行测试。

将Google帐号添加到Google Play开发者帐号的"许可测试(License Testing)"中

https://developer.android.google.cn/google/play/billing/billing_testing#testing-purchases

3.检查设置是否成功

< ">在Play管理中心中设置好产品后，您可以在应用中查询产品的详细信息来检查设置是否成功。

lateinit private var billingClient: BillingClient

override fun onCreate(savedInstanceState: Bundle?) {

   super.onCreate(savedInstanceState)

   // Set up the billing client

   billingClient = BillingClient

      .newBuilder(this)

      .enablePendingPurchases()

      .setListener(this)

      .build()

   billingClient.startConnection(object : BillingClientStateListener {

      override fun onBillingSetupFinished(billingResult: BillingResult) {

         if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {

            Log.i(TAG, "Billing client successfully set up")

            queryOneTimeProducts()

         }

      }

      override fun onBillingServiceDisconnected() {

         Log.i(TAG, "Billing service disconnected")

      }

   })

}

private fun queryOneTimeProducts() {

   val skuListToQuery = ArrayList<String>()

   sk梅州小程序uListToQuery.add("coins_5")

   // ‘coins_5’ is the product ID that was set in the Play Console.

   // Here is where we can add more product IDs to query for based on

   // what was set up in the Play Console.

   val params = SkuDetailsParams.newBuilder()

   params

      .setSkusList(skuListToQuery)

      .setType(BillingClient.SkuType.INAPP)

   // SkuType.INAPP refers to 'managed products' or one time purchases.

   // To query for subscription products, you would use SkuType.SUBS.

   billingClient.querySkuDetailsAsync(

      params.build(),

      object : SkuDetailsResponseListener {

         override fun onSkuDetailsResponse(

            result: BillingResult?,

            skuDetails: MutableList<SkuDetails>?

         ) {

            Log.i(TAG, "onSkuDetailsResponse ${result?.responseCode}")

            if (skuDetails != null) {

               for (skuDetail in skuDetails) {

                  Log.i(TAG, skuDetail.toString())

               }

            } else {

               Log.i(TAG, "No skus found from query")

            }

         }

      })

}

< ">如果一切顺利，您将会看到刚刚添加进Play管理中心的产品的详细信息！

4.接入Google Play Billing开发库

< ">下一步，便是如何在您的Android应用中接入Google Play Billing开发库。

< ">本文将以一次性购买的生命周期为例，即在应用中销售数字商品及授予用户的过程。

< ">一次性产品可以是消耗品，也可以是非消耗品。消耗品意味着用户可以再次购买。例如，如果您的游戏允许用户购买金币，您可以将金币做成消耗品，让用户可以多次购买。非消耗品意味着用户只能购买一次，典型示例是包含额外应用内功能的升级包。

< ">在Google Play管理中心配置应用内产品后，其销售过程如下:

< ">让我们逐步分析这一过程。

< ">1.设置BillingClient-< background-color: rgb(242, 242, 242);">BillingClient类让您的应用可以与Play Billing Library进行通信。您的应用需要做的第一件事是调用< color: rgb(79, 129, 189);">startConnection()与Google Play建立连接。

startConnection()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient#startconnection

< ">在实际环境中连接是有可能中断的，所以您的应用还必须重写< color: rgb(79, 129, 189);">onBillingServiceDisconnected()回调来处理重新连接，确保应用在发出任何进一步请求之前已与Google Play连接。

// Set up the billing client

val billingClient = BillingClient

    .newBuilder(this)

    .enablePendingPurchases()

    .setListener(this)

    .build()

billingClient.startConnection(object : BillingClientStateListener {

    override fun onBillingSetupFinished(billingResult: BillingResult) {

        if (billingResult.responseCode == OK) {

            Log.i(TAG, "Billing client successfully set up!")

            // Query for existing user purchases

            // Query for products for sale

        }

    }

    override fun onBillingServiceDisconnected() {

        Log.i(TAG, "Billing service disconnected")

        // Restart the connection with startConnection() so future requests don't fail.

    }

})

< font-size: 14px; color: rgb(79, 129, 189);">onBillingServiceDisconnected()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClientStateListener#onBillingServiceDisconnected()

< ">2.获取用户的既有购买记录-成功设置BillingClient后，您的应用现在可以调用queryPurchases()来查询用户先前的购买记录。

/**

 * Query Google Play Billing for existing purchases.

 *

 * New purchases will be provided to PurchasesUpdatedListener.

 */

fun queryPurchases() {

    if (!billingClient.isReady) {

        Log.e(TAG, "queryPurchases: BillingClient is not ready")

    }

    // Query for existing in app products that have been purchased. This does NOT include subscriptions.

    val result = billingClient.queryPurchases(BillingClient.SkuType.INAPP)

    if (result.purchasesList == null) {

        Log.i(TAG, "No existing in app purchases found.")

    } else {

        Log.i(TAG, "Existing purchases: ${result.purchasesList}")

    }

}

queryPurchases()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient#querypurchases

< ">3.呈现待售产品-在本文的前半部分我们谈到了如何在Google Play管理中心中设置产品以及如何在应用中查询这些产品。在调用< color: rgb(79, 129, 189);">querySkuDetailsAsync()获取每个产品的< color: rgb(79, 129, 189);">SkuDetails后，即可使用这些信息设置对应的界面。

private fun queryOneTimeProducts() {

    val skuListToQuery = ArrayList<String>()

    // sku refers to the product ID that was set in the Play Console

    skuListToQuery.add("small_pineapple_seed")

    val params = SkuDetailsParams.newBuilder()

    params

        .setSkusList(skuListToQuery)

        .setType(BillingClient.SkuType.INAPP)

    // SkuType.INAPP refers to 'managed products' or one time purchases

    // To query for subscription products, you would use SkuType.SUBS

    billingClient.querySkuDetailsAsync(

        params.build(),

        object : SkuDetailsResponseListener {

            override fun onSkuDetailsResponse(

                result: BillingResult,

                skuDetails: MutableList<SkuDetails>?

            ) {

                if (skuDetails != null) {

                    // Store sku and skuDetail to be used later

                } else {

                    Log.i(TAG, "No sku found from query")

                }

            }

        })

}

querySkuDetailsAsync()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient#queryskudetailsasync

< font-size: 14px; color: rgb(79, 129, 189);">SkuDetails

https://developer.android.google.cn/reference/com/android/billingclient/api/SkuDetails

< ">4.启动购买流程-当用户点击产品进行购买时，您的应用需要带上产品< background-color: rgb(242, 242, 242);">SkuDetails来调用< color: rgb(79, 129, 189);">launchBillingFlow()，从而向用户展示Google Play购买界面(如下图所示)。

fun launchPurchaseFlow(skuDetails: SkuDetails) {

    val flowParams = BillingFlowParams.newBuilder()

        .setSkuDetails(skuDetails)

        .build()

    val responseCode = billingClient.launchBillingFlow(this, flowParams)

    Log.i(TAG, "launchPurchaseFlow result ${responseCode}")

}

launchBillingFlow()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient#launchbillingflow

< ">5.处理购买结果-在用户退出Google Play购买界面时(点击"购买"按钮完成购买，或者点击"返回"按钮取消购买)，< color: rgb(79, 129, 189);">onPurchaseUpdated()回调会将购买流程的结果发送回您的应用。然后，根据< color: rgb(79, 129, 189);">BillingResult.responseCode即可确定用户是否成功购买产品。如果< background-color: rgb(242, 242, 242);">responseCode==OK，则表示购买已成功完成。

onPurchaseUpdated()

https://developer.android.google.cn/reference/com/android/billingclient/api/PurchasesUpdatedListener#onPurchasesUpdated(com.android.billingclient.api.BillingResult,%20java.util.List%3Ccom.android.billingclient.api.Purchase%3E)

< font-size: 14px; color: rgb(79, 129, 189);">BillingResult.responseCode

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient.BillingResponseCode

< ">< background-color: rgb(242, 242, 242);">onPurchaseUpdated()会传回一个< color: rgb(79, 129, 189);">Purchase对象列表，其中包括用户通过应用进行的所有购买。每个Purchase对象都包含< background-color: rgb(242, 242, 242);">sku、purchaseToken和isAcknowledged以及其他很多字段。使用这些字段，您可以确定每个Purchase对象是需要处理的新购买还是不需要进一步处理的既有购买。

// Google Play calls this method to propogate the result of the purchase flow

override fun onPurchasesUpdated(billingResult: BillingResult, purchases: List<Purchase?>?) {

    if (billingResult.responseCode == OK && purchases != null) {

        for (purchase in purchases) {

            handlePurchase(purchase)

        }

    } else if (billingResult.responseCode == USER_CANCELED) {

        Log.i(TAG, "User cancelled purchase flow.")

    } else {

        Log.i(TAG, "onPurchaseUpdated error: ${billingResult?.responseCode}")

    }

}

< font-size: 14px; color: rgb(79, 129, 189);">Purchase

https://developer.android.google.cn/reference/com/android/billingclient/api/Purchase

< ">6.验证和确认购买-使用Play Billing Library 3.0时，您的应用需要确认购买成功才能完成购买流程。如果您的应用未在72小时内确认购买，则用户会自动收到退款，并且Google Play会撤消该购买交易。

< ">如果您的应用包含验证服务器组件，您应在验证成功后再确认购买。我们强烈推荐开发者对所有的应用内购买进行验证。请查看本< color: rgb(79, 129, 189);">指南了解有关打击欺诈性购买的更多信如何做好网络危机公关息。

指南:打击欺诈和滥用行为

https://developer.android.google.cn/google/play/billing/security#verify

< ">在对购买进行验证之后，您还需要对其进行确认。

< ">非消耗品必须通过调用< color: rgb(79, 129, 189);">acknowledgePurchase()进行确认；

< ">消耗品必须通过调用< color: rgb(79, 129, 189);">consumeAsync()来标记为"已消耗(consumed)"，使得用户可以再次购买。调用< background-color: rgb(242, 242, 242);">consumeAsync()还会将购买设置为已确认，因此只要调用了< background-color: rgb(242, 242, 242);">consumeAsync()，就无需再对消耗品调用< background-color: rgb(242, 242, 242);">acknowledgePurchase()。

fun handlePurchase(purchase: Purchase) {

    // If your app has a server component, first verify the purchase by checking that the

    // purchaseToken hasn't already been used.

    // If purchase was a consumable product (a product you want the user to be able to buy again)

    handleConsumableProduct(purchase)

    // If purchase was non-consumable product

    handleNonConsumableProduct(purchase)

}

fun handleConsumableProduct(purchase: Purchase) {

    val consumeParams =

        ConsumeParams.newBuilder()

            .setPurchaseToken(purchase.getPurchaseToken())

            .build()

    billingClient.consumeAsync(consumeParams, { billingResult, purchaseToken ->

        if (billingResult.responseCode == BillingResponse.OK软文推广的市场特点) {

            // Handle the success of the consume operation.

        }

    })

}

fun handleNonConsumableProduct(purchase: Purchase) {

    if (purchase.purchaseState == PURCHASED) {

        if (!purchase.isAcknowledged) {

            val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()

                .setPurchaseToken(purchase.purchaseToken)

            billingClient.acknowledgePurchase(acknowledgePurchaseParams.build())

        }

    }

}

acknowledgePurchase()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient#acknowledgepurchase

< font-size: 14px; color: rgb(79, 129, 189);">consumeAsync()

https://developer.android.google.cn/reference/com/android/billingclient/api/BillingClient#consumeasync

< ">7.授予用户产品-完成上述步骤后，您的应用就可以向用户授予他们购买的应用内产品了！

< ">如果您想查看Google Play Billing开发库的资源，可以在此处访问< color: rgb(79, 129, 189);">官方文档。我们还提供了一些< color: rgb(79, 129, 189);">示例，演示了实现Billing库的最佳实践。本文中的代码示例可以在< color: rgb(79, 129, 189);">GitHub上获取。

官方文档:Google Play Billing服务概览

https://developer.android.google.cn/google/play/billing/billing_overview

< font-size: 14px; color: rgb(79, 129, 189);">Play Billing开发库示例

https://github.com/android/play-billing-samples

< font-size: 14px; color: rgb(79, 129, 189);">本文中的代码示例

http://github.com/calren

< ">如果您的应用目前尚未使用Play Billing Library 3，务必查看我们的迁移指南，将您的应用迁移到最新的Play Billing Library。

从AIDL迁移到Google Play Billing开发库的迁移指南

https://developer.android.google.cn/google/play/billing/migrate