Android开发-将Google Play结算服务集成到Android的应用中

前 言

本博客主要介绍如何将 Google Play 结算服务集成到您的应用中以开始销售商品。

接入前的准备工作

在 Google Play 控制台选择自己已经上线的应用，然后选择“商品”栏目，选择“应用内商品”或者“订阅”。如下图所示：

然后接着创建商品，并开启激活商品。如下图所示：

添加 Google Play 结算库的相关依赖

将 Google Play 结算库依赖项添加到应用的 build.gradle 文件中。如下所示：

dependencies {
    ...
    // Google Play 结算服务
    implementation 'com.android.billingclient:billing:3.0.1'
    ...
}

初始化 BillingClient

添加对 Google Play 结算库的依赖关系后，您需要初始化 BillingClient 实例。BillingClient 是 Google Play 结算库与应用的其余部分之间进行通信的主接口。BillingClient 为许多常见的结算操作提供了方便的方法，既有同步方法，又有异步方法。

如需创建 BillingClient，请使用 newBuilder()。为了接收有关购买交易的更新，您还必须调用 setListener()，并传递对 PurchasesUpdatedListener 的引用。此监听器可接收应用中所有购买交易的更新。

private PurchasesUpdatedListener purchasesUpdatedListener = new PurchasesUpdatedListener() {
    @Override
    void onPurchasesUpdated(BillingResult billingResult, List<Purchase> purchases) {
        // To be implemented in a later section.
    }
};

private BillingClient billingClient = BillingClient.newBuilder(activity)
    .setListener(purchasesUpdatedListener)
    .enablePendingPurchases()
    .build();

与 Google Play 建立连接

创建 BillingClient 后，您需要与 Google Play 建立连接。

如需连接到 Google Play，请调用 startConnection()。连接过程是异步进行的，因此您必须实现 BillingClientStateListener，以便在客户端的设置完成后且它准备好发出进一步的请求时接收回调。

此外，您还必须实现重试逻辑，以处理与 Google Play 失去连接的问题。如需实现重试逻辑，请替换 onBillingServiceDisconnected() 回调方法，并确保 BillingClient 先调用 startConnection() 方法以重新连接到 Google Play，然后再发出进一步的请求。

billingClient.startConnection(new BillingClientStateListener() {
    @Override
    public void onBillingSetupFinished(BillingResult billingResult) {
        if (billingResult.getResponseCode() ==  BillingResponseCode.OK) {
            // The BillingClient is ready. You can query purchases here.
        }
    }
    @Override
    public void onBillingServiceDisconnected() {
        // Try to restart the connection on the next request to
        // Google Play by calling the startConnection() method.
    }
});

• 注意：强烈建议您实现自己的连接重试逻辑并替换 onBillingServiceDisconnected() 方法。请确保在执行任何方法时都与 BillingClient 保持连接。

展示可供购买的商品

与 Google Play 建立连接后，您就可以查询可售的商品并将其展示给用户了。如需向 Google Play 查询应用内商品详情，请调用 querySkuDetailsAsync()。在将商品展示给用户之前，查询 SKU 详情是非常重要的一步，因为查询会返回本地化的商品信息。对于订阅，请确保您的商品展示符合所有 Play 政策。

调用 querySkuDetailsAsync() 时，应传递 SkuDetailsParams 的实例，用于指定在 Google Play 管理中心创建的商品 ID 字符串的列表以及 SkuType。SkuType 可以是 SkuType.INAPP（针对一次性商品），也可以是 SkuType.SUBS（针对订阅）。

为了处理该异步操作的结果，您还必须指定实现 SkuDetailsResponseListener 接口的监听器。然后，您可以替换 onSkuDetailsResponse()，该方法会在查询完成时通知监听器，如以下示例所示：

List<String> skuList = new ArrayList<> ();
skuList.add("premium_upgrade");
skuList.add("gas");
SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList).setType(SkuType.INAPP);
billingClient.querySkuDetailsAsync(params.build(),
    new SkuDetailsResponseListener() {
        @Override
        public void onSkuDetailsResponse(BillingResult billingResult,
                List<SkuDetails> skuDetailsList) {
            // Process the result.
        }
    });

Google Play 结算库会将查询结果存储在 SkuDetails 对象的 List 中。您随后可以对该列表中的每个 SkuDetails 对象调用各种方法，以查看应用内商品的相关信息，如其价格或说明。如需查看可用的商品详情，请参阅 SkuDetails 类中的方法列表。

在提供待售商品之前，检查用户是否尚未拥有该商品。如果用户的消耗型商品仍在他们的商品库中，他们必须先消耗掉该商品，然后才能再次购买。

在提供订阅之前，验证用户是否尚未订阅。

• 注意：有些 Android 设备安装的可能是旧版 Google Play 商店应用，不支持订阅等某些商品类型。在您的应用进入结算流程之前，您可以调用 isFeatureSupported() 以确定设备是否支持您要销售的商品。如需查看可支持的商品类型的列表，请参阅 BillingClient.FeatureType。

启动购买流程

如需从应用发起购买请求，请从应用的主线程调用 launchBillingFlow() 方法。此方法接受对 BillingFlowParams 对象的引用，该对象包含通过调用 querySkuDetailsAsync() 获取的相关 SkuDetails 对象。如需创建 BillingFlowParams 对象，请使用 BillingFlowParams.Builder 类。

// An activity reference from which the billing flow will be launched.
Activity activity = ...;

// Retrieve a value for "skuDetails" by calling querySkuDetailsAsync().
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
        .setSkuDetails(skuDetails)
        .build();
int responseCode = billingClient.launchBillingFlow(activity, billingFlowParams).getResponseCode();

// Handle the result.

launchBillingFlow() 方法会返回 BillingClient.BillingResponseCode 中列出的几个响应代码之一。请务必检查此结果，以确保在启动购买流程时没有错误。BillingResponseCode 为 OK 表示成功启动。

成功调用 launchBillingFlow() 时，系统会显示 Google Play 购买屏幕。如下图所示显示了一次性商品的购买屏幕：

Google Play 会调用 onPurchasesUpdated()，以将购买操作的结果传送给实现 PurchasesUpdatedListener 接口的监听器。您可以在初始化客户端时使用 setListener() 方法指定监听器。

您必须实现 onPurchasesUpdated() 来处理可能的响应代码。以下示例展示了如何替换 onPurchasesUpdated()：

@Override
void onPurchasesUpdated(BillingResult billingResult, List<Purchase> purchases) {
    if (billingResult.getResponseCode() == BillingResponseCode.OK
        && purchases != null) {
        for (Purchase purchase : purchases) {
            handlePurchase(purchase);
        }
    } else if (billingResult.getResponseCode() == BillingResponseCode.USER_CANCELED) {
        // Handle an error caused by a user cancelling the purchase flow.
    } else {
        // Handle any other error codes.
    }
}

如果成功购买商品，系统还会生成购买令牌，它是一个唯一标识符，表示用户及其所购应用内商品的商品 ID。您的应用可以在本地存储购买令牌，不过我们建议您将令牌传递到安全的后端服务器，您随后可以在该服务器上验证购买交易及防范欺诈行为。下一部分对此过程进行了详细说明。

用户还会收到包含交易收据的电子邮件，其中包含订单 ID 或交易的唯一 ID。用户每次购买一次性商品时，都会收到包含唯一订单 ID 的电子邮件。此外，用户最初购买订阅时以及后续定期自动续订时，也会收到这样的电子邮件。您可以在 Google Play 管理中心内使用订单 ID 来管理退款。

处理购买交易

用户完成购买交易后，您的应用需要处理该购买交易。在大多数情况下，您的应用会通过 PurchasesUpdatedListener 收到购买交易的通知。但在某些情况下，您的应用通过调用 BillingClient.queryPurchases() 得知购买交易，如提取购买交易中所述。

您的应用应按以下方式处理购买交易：

• 验证购买交易。
• 向用户提供内容，并确认内容已传送给用户。还可以选择性地将商品标记为已消费，以便用户可以再次购买商品。

如需验证购买交易，请先检查购买交易的状态是否为 PURCHASED。如果购买交易的状态为 PENDING，则您应按照处理待处理的交易中的说明处理购买交易。对于通过 onPurchaseUpdated() 或 queryPurchases 接收的购买交易，您应在应用授予权利之前进一步验证购买交易以确保其合法性。如需了解如何正确验证购买交易，请参阅在授予权利前验证购买交易。

一旦您验证了购买交易，您的应用就可以向用户授予权利了。授予权利后，您的应用必须确认购买交易。此确认会告知 Google Play 您已授予购买权。

• 注意：如果您在三天内未确认购买交易，用户会自动收到退款，并且 Google Play 会撤消该购买交易。

授予权利并确认购买交易的流程取决于购买的是非消耗型商品、消耗型商品，还是订阅。

对于消耗型商品，consumeAsync() 方法满足确认要求，并且表明您的应用已授予用户权利。此外，通过此方法，您的应用可让一次性商品可供再次购买。

如需表明某件一次性商品已被消耗，请调用 consumeAsync() 并添加 Google Play 应在用户重新购买时提供的购买令牌。您还必须传递一个实现 ConsumeResponseListener 接口的对象。该对象用于处理消耗操作的结果。您可以替换 onConsumeResponse() 方法，Google Play 结算库会在消耗操作完成时调用该方法。

以下示例展示了如何使用关联的购买令牌来消耗商品：

void handlePurchase(Purchase purchase) {
    // Purchase retrieved from BillingClient#queryPurchases or your PurchasesUpdatedListener.
    Purchase purchase = ...;

    // Verify the purchase.
    // Ensure entitlement was not already granted for this purchaseToken.
    // Grant entitlement to the user.

    ConsumeParams consumeParams =
        ConsumeParams.newBuilder()
            .setPurchaseToken(purchase.getPurchaseToken())
            .build();

    ConsumeResponseListener listener = new ConsumeResponseListener() {
        @Override
        public void onConsumeResponse(BillingResult billingResult, String purchaseToken) {
            if (billingResult.getResponseCode() == BillingResponseCode.OK) {
                // Handle the success of the consume operation.
            }
        }
    };

    billingClient.consumeAsync(consumeParams, listener);
}

• 注意：由于消耗请求偶尔会失败，因此您必须检查安全的后端服务器，确保所有购买令牌都未被使用过，这样您的应用就不会针对同一购买交易多次授予权利。或者，您的应用也可以等到您收到 Google Play 发来的成功消耗响应后再授予权利。如果您选择在 Google Play 发来成功消耗响应之前不让用户消耗所购商品，那么您必须非常小心，在消耗请求发出后时刻跟踪相应商品。

如需确认非消耗型商品的购买交易，请使用结算库中的 BillingClient.acknowledgePurchase() 或 Google Play Developer API 中的 Product.Purchases.Acknowledge。在确认购买交易之前，您的应用应使用 Google Play 结算库中的 isAcknowledged() 方法或 Google Play Developer API 中的 acknowledgementState 字段检查该购买交易是否已经过确认。

以下示例展示了如何使用 Google Play 结算库来确认购买交易：

BillingClient client = ...
AcknowledgePurchaseResponseListener acknowledgePurchaseResponseListener = ...

void handlePurchase(Purchase purchase) {
    if (purchase.getPurchaseState() == PurchaseState.PURCHASED) {
        if (!purchase.isAcknowledged()) {
            AcknowledgePurchaseParams acknowledgePurchaseParams =
                AcknowledgePurchaseParams.newBuilder()
                    .setPurchaseToken(purchase.getPurchaseToken())
                    .build();
            client.acknowledgePurchase(acknowledgePurchaseParams, acknowledgePurchaseResponseListener);
        }
    }
}

订阅的处理方式与非消耗型商品类似。您可以使用 Google Play 结算库中的 BillingClient.acknowledgePurchase() 或 Google Play Developer API 中的 Purchases.Subscriptions.Acknowledge 确认订阅。所有初始订阅购买交易都需要确认。

查看用户购买的订单

在 Google Play 控制台中心点击“订单管理”，如下图所示：

下图所示是用户购买的订单：

———————— The end ————————

码字不易，如果您觉得这篇博客写的比较好的话，可以赞赏一杯咖啡吧~~

---