GooglePay 谷歌支付内购接入小结

近段时间在做安卓的海外项目，项目中需要使用Google Play支付，小编把Google支付的相关代码整理下
文档地址：
1.准备文档：https://developer.android.com/google/play/billing/getting-ready
2.集成文档：https://developer.android.com/google/play/billing/integrate

一、前期准备

设置 Google Play 开发者帐号

如需在 Google Play 上发布您的应用和游戏，请使用 Google Play 管理中心。您还可以使用 Google Play 管理中心管理与结算相关的商品和设置。
如需访问 Google Play 管理中心，您需要设置 Google Play 开发者帐号。
如需在 Google Play 上销售付费应用和应用内购商品，您还必须在 Google 付款中心设置付款资料，然后将该付款资料与您的 Google Play 开发者帐号相关联。如需了解如何将您的付款资料与帐号相关联，或者了解如何检查您是否已有关联的帐号和付款资料，请参阅将 Google Play 开发者帐号与您的付款资料相关联。

创建商品

商品创建.png

添加测试账号

添加测试账号.png

二、集成

implementation 'com.android.billingclient:billing:5.0.0'

三、代码整理

GoogleBillingManager :处理支付的启动连接，关闭连接等操作
GoogleBillHelper:处理查询、购买、消耗等操作
GoogleBillingListener:自定义的监听：消耗，购买，查询的监听，（可自定义。不使用）

下面附上相关代码

GoogleBillingManager.java

import android.content.Context;
import android.util.Log;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;

import com.android.billingclient.api.BillingClient;
import com.android.billingclient.api.BillingClientStateListener;
import com.android.billingclient.api.BillingResult;
import com.android.billingclient.api.Purchase;
import com.android.billingclient.api.PurchasesUpdatedListener;

import java.util.List;

/**
 * @author by ddy
 * Date: 2022/5/23 16:19
 * Desc:Google 支付管理
 */
public class GoogleBillingManager {
    private static GoogleBillingManager instance;
    private BillingClient billingClient;
    private GoogleBillingListener billingListener;

    private GoogleBillingManager() {
    }

    public static GoogleBillingManager getInstance() {
        if (instance == null) {
            synchronized (GoogleBillingManager.class) {
                if (instance == null) {
                    instance = new GoogleBillingManager();
                }
            }
        }
        return instance;
    }

    /**
     * 创建支付客户端
     */
    public void createClient(Context context) {
        if (null == context) {
            return;
        }
        billingClient = BillingClient.newBuilder(context.getApplicationContext())
                .enablePendingPurchases()
                .setListener(new PurchasesUpdatedListener() {
                    @Override
                    public void onPurchasesUpdated(@NonNull BillingResult billingResult, @Nullable List purchases) {
                        if (null != billingListener) {
                            billingListener.onPurchasesUpdated(billingResult, purchases);
                        }
                    }
                })
                .build();
        //启动支付连接
        startConn();
    }

    public BillingClient getBillingClient() {
        return billingClient;
    }
     /**
     * 添加监听事件
     */
    public void setBillingListener(GoogleBillingListener billingListener) {
        this.billingListener = billingListener;
    }

    /**
     * 是否准备好了
     *
     * @return
     */
    public boolean isReady() {
        return !(null == billingClient || !billingClient.isReady());
    }

    /**
     * 启动连接
     */
    private void startConn() {
        if (isReady()) {
            return;
        }

        billingClient.startConnection(new BillingClientStateListener() {
            @Override
            public void onBillingSetupFinished(BillingResult billingResult) {
                if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK) {
                    Log.e("TAG", "连接成功，可以开始操作了~~~");
                }
            }

            @Override
            public void onBillingServiceDisconnected() {
                //连接失败。 可以尝试调用 startConnection 重新建立连接
                Log.e("TAG", "连接失败");
            }
        });

    }

    /**
     * 结束连接
     */
    public void endConn() {
        if (null != billingClient) {
            billingClient.endConnection();
        }
    }
}

GoogleBillHelper .java

package googleBilling;

import android.app.Activity;
import android.util.Log;

import com.android.billingclient.api.BillingClient;
import com.android.billingclient.api.BillingFlowParams;
import com.android.billingclient.api.ConsumeParams;
import com.android.billingclient.api.ConsumeResponseListener;
import com.android.billingclient.api.ProductDetails;
import com.android.billingclient.api.Purchase;
import com.android.billingclient.api.QueryProductDetailsParams;

import java.util.ArrayList;
import java.util.List;

/**
 * @author by ddy
 * Date: 2022/5/23 17:03
 * Desc:支付的具体操作
 * 1.查询
 * 2.购买
 * 3.消费
 */
public class GoogleBillHelper {
    public static final String TAG = GoogleBillHelper.class.getSimpleName();
    /**
     * 查询商品详情
     *
     * @param billingListener : 接口监听
     * @param productIds      :商品id 。对应Google 后台的
     * @param productType     :取值
     *                        BillingClient.ProductType.INAPP（一次性商品）
     *                        BillingClient.ProductType.SUBS（订阅）
     */
    public void onQuerySkuDetailsAsync(GoogleBillingListener billingListener, String productType, String... productIds) {
        if (null == productIds || productIds.length == 0
                || !GoogleBillingManager.getInstance().isReady()
        ) {
            return;
        }
        List skuList = new ArrayList<>();
        for (String productId : productIds) {
            QueryProductDetailsParams.Product product = QueryProductDetailsParams
                    .Product.newBuilder()
                    .setProductId(productId)
                    .setProductType(productType)
                    .build();
            //添加对应的 产品id 去查询详情
            skuList.add(product);
        }

        QueryProductDetailsParams params = QueryProductDetailsParams
                .newBuilder()
                .setProductList(skuList)
                .build();

        GoogleBillingManager.getInstance().getBillingClient().queryProductDetailsAsync(params, (billingResult, list) -> {
            if (BillingClient.BillingResponseCode.OK == billingResult.getResponseCode()) {
                if (null != billingListener) {
                    billingListener.onProductDetailsSus(list);
                }
            } else {
                Log.e("TAG", "code : " + billingResult.getResponseCode() + " message : " + billingResult.getDebugMessage());
            }
        });
    }

    /**
     * 打开支付面板
     *
     * @param billingListener
     * @param activity
     * @param details
     */
    public void onOpenGooglePlay(GoogleBillingListener billingListener, Activity activity, ProductDetails details) {
        if (null == details) {
            return;
        }
        List params = new ArrayList<>();
        //添加购买数据
        BillingFlowParams.ProductDetailsParams productDetailsParams = BillingFlowParams.ProductDetailsParams
                .newBuilder()
                .setProductDetails(details)
                .build();
        params.add(productDetailsParams);

        BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
                .setProductDetailsParamsList(params)
                .build();
        //响应code 码
        int responseCode = GoogleBillingManager.getInstance().getBillingClient().launchBillingFlow(activity, billingFlowParams).getResponseCode();
        //成功换起
        if (BillingClient.BillingResponseCode.OK == responseCode) {
            //添加购买监听
            GoogleBillingManager.getInstance().setBillingListener(billingListener);
        }
    }
    /**
     * 消费商品
     * 对于购买类型的商品需要手动调用一次消费方法 （目的：用户可以再次购买此商品）
     *
     * @param billingListener
     * @param purchase
     */
    public void onConsumeAsync(GoogleBillingListener billingListener, Purchase purchase) {
        if (!GoogleBillingManager.getInstance().isReady()) {
            return;
        }
        ConsumeParams consumeParams =
                ConsumeParams.newBuilder()
                        .setPurchaseToken(purchase.getPurchaseToken())
                        .build();

        ConsumeResponseListener listener = (billingResult, purchaseToken) -> {
            if (billingResult.getResponseCode() == BillingClient.BillingResponseCode.OK) {
                if (null != billingListener) {
                    billingListener.onConsumeSus(purchaseToken);
                } else {
                    Log.e(TAG, "消费失败 code : " + billingResult.getResponseCode() + " message : " + billingResult.getDebugMessage());
                }
            }
        };
        GoogleBillingManager.getInstance().getBillingClient().consumeAsync(consumeParams, listener);
    }
}

GoogleBillingListener.java

package googleBilling;

import com.android.billingclient.api.BillingResult;
import com.android.billingclient.api.ProductDetails;
import com.android.billingclient.api.Purchase;

import java.util.List;

/**
 * @author by ddy
 * Date: 2022/5/23 17:12
 * Desc:监听
 */
public interface GoogleBillingListener {
    /**
     * 购买监听
     *
     * @param result
     * @param purchases
     */
    default void onPurchasesUpdated(BillingResult result, List purchases) {

    }

    /**
     * 查询商品详情成功
     *
     * @param list
     */
    default void onProductDetailsSus(List list) {

    }

    /**
     * 商品消费成功
     *
     * @param purchaseToken
     */
    default void onConsumeSus(String purchaseToken) {

    }
}

三、支付流程步骤

1.与Google Play建立支付连接
2.查询购买商品详情数据
3.唤起支付面板
4.支付结果回调
5.消费商品（对于购买类商品在购买完，需将其消费掉）

四、Demo示例

import android.os.Bundle;
import android.util.Log;
import android.view.View;

import androidx.appcompat.app.AppCompatActivity;

import com.android.billingclient.api.BillingClient;
import com.android.billingclient.api.BillingResult;
import com.android.billingclient.api.ProductDetails;
import com.android.billingclient.api.Purchase;

import java.util.List;

import googleBilling.GoogleBillHelper;
import googleBilling.GoogleBillingListener;
import googleBilling.GoogleBillingManager;

public class MainActivity extends AppCompatActivity {
    private GoogleBillHelper billProxy = new GoogleBillHelper();
    private GoogleBillingListenerImpl billingListenerImpl = new GoogleBillingListenerImpl();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //建立连接
        GoogleBillingManager.getInstance().createClient(this);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        //结束连接
        GoogleBillingManager.getInstance().endConn();
    }

    /**
     * 点击购买
     * 换起Google 支付面前 ，需要查询是否有对应的APP商品
     * @param view
     */
    public void onClickGooglePlay(View view) {
        billProxy
            .onQuerySkuDetailsAsync(
             billingListenerImpl,
             BillingClient.ProductType.INAPP,
             "谷歌后台的商品id名字");
    }
    
    //事件监听
    private class GoogleBillingListenerImpl implements GoogleBillingListener {
        /**
         * 产品查询成功
         *
         * @param list
         */
        @Override
        public void onProductDetailsSus(List list) {
            GoogleBillingListener.super.onProductDetailsSus(list);
            if (null == list || list.size() <= 0) {
                Log.e("TAG", "没有查询到相关产品~~~~");
                return;
            }
            //查询方法中只传了一个商品，所以直接取第一个了
            //根据实际情况处理~
            billProxy.onOpenGooglePlay(this, MainActivity.this, list.get(0));
        }

        /**
         * 购买监听
         *
         * @param result
         * @param purchases
         */
        @Override
        public void onPurchasesUpdated(BillingResult result, List purchases) {
            GoogleBillingListener.super.onPurchasesUpdated(result, purchases);
            if (null == purchases || purchases.size() == 0) {
                return;
            }
          //循环调用消耗
            for (Purchase purchase : purchases) {
                billProxy.onConsumeAsync(this, purchase);
            }
        }

        /**
         * 消费监听
         * @param purchaseToken
         */
        @Override
        public void onConsumeSus(String purchaseToken) {
            GoogleBillingListener.super.onConsumeSus(purchaseToken);
            Log.e("TAG","消费结束，处理自己的业务逻辑~~~");
            //去与后台验证。处理APP的页面逻辑， 比如充值后发放金币啥的~~~
        }
    }
}

五、注意事项

1.引用库5.0.0 与 3.0.3 版本差异：

5.x在使用查询方法时，onQuerySkuDetailsAsync所传的产品id可以是Google Play >后台不一致，查询不到不会返回该商品的详情数据,而3.0.3查询是所传的产品>Google Play 必须存在

待续。。。。

五、总结

1.在Google Play 控制台创建应用、应用内商品。
2.发布应用到内测版或者正式版。
3.在Google Play 控制台添加测试账号，用这个账号来测试支付。

到此，支付的基本操作已分享。自己动手试一试吧！
如果你觉得该文章对你有用，动动你的小手指，举手之劳，赞有余香！