教你接入Google谷歌支付V3版本，图文讲解（Android、Unity）

一、前言

点关注不迷路，持续输出Unity干货文章。
嗨，大家好，我是新发。最近实在太忙了，博客停了好几天没更新。
项目要出海，需要接入Google支付，今天就来说说如何接入Google支付吧。

要接入Google支付，需要先在Google Console上注册一个账号并申请一个应用，
Google Console网址：https://developer.android.com/distribute/console
账号注册和应用申请不是本文重点，这里就不展开讲了，另：需要科学上网才能访问Google Console。

二、Google支付官方文档

Google支付官方文档：https://developer.android.com/google/play/billing/integrate#java

三、Google支付Github Demo工程

Github工程地址：https://github.com/android/play-billing-samples

Demo下载下来后，使用Android Studio打开ClassyTaxiJava工程即可。

其中，BillingClientLifecycle.java就是最主要的演示脚本。

四、Google支付流程图

Google支付的流程略微有点复杂，为了方便大家理解，我把Google支付的流程图画一下，图片可以放大看。

容易漏掉的就是补单。
国内硬核渠道的SDK（比如应用宝、OPPO、VIVO、小米、华为等），一般支付完成，是SDK服务端通过callback_url（一般是一个https请求）的方式回调给游戏服务端，游戏服务端进行发货。
Google支付不一样，它没有callback_url，那游戏服务端怎么知道用户支付完成了呢？
需要游戏客户端在支付完成后主动动通知服务端发货，确认发货后客户端再关闭订单。
正因为是由客户端来通知服务端发货的，所以就有可能会掉单，比如客户端支付成功后，还没来得及通知服务端发货，客户端就异常退出了。
这个时候，就需要补单了。游戏客户端在完成登录游戏服务端后，需要主动调用Google的订单查询接口，把漏掉的单子补发货，发完货后，客户端关闭订单。

五、Google支付接口讲解

1、初始化（监听支付事件）

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

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

支付事件在PurchasesUpdatedListener中监听，比如支付完成：

  @Override
    public void onPurchasesUpdated(BillingResult billingResult, List<Purchase> purchases) {
        int responseCode = billingResult.getResponseCode();
        String debugMsg = billingResult.getDebugMessage();
        Log.d("GooglePay", "responseCode: $responseCode, debugMsg: $debugMsg");
        if(null != purchases) {
			for(Purchase purchase : purchases) {
				if(BillingResponseCode.OK == responseCode) {
					// TODO 通知服务端发货，发货成功后，把订单关闭
					// handlePurchase(purchase);   // 注意，必须确保服务器发货成功后再执行handlePurchase
				}
			}
		}
    }

2、连接Google服务器（必须）

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.
    }
});

判断是否已连接

if(billingClient.isReady())
{
}

3、查询商品信息（通过sku_id查询）

List<String> skuList = new ArrayList<> ();
skuList.add("sku_id");
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.
        }
    });

建议把查询结果做缓存，查过的商品，下次直接从缓存中获取即可，例：

private Map<String, SkuDetails> skuDetailsMap = new HashMap();

// ...
if(skuDetailsMap.containsKey("sku_id"))
{
	// skuDetailsMap.get("sku_id");
	return;
}

List<String> skuList = new ArrayList<> ();
skuList.add("sku_id");
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.
			int resultCode = billingResult.getResponseCode();
			if(BillingResponseCode.Ok == resultCode) {
				for(SkuDetails skuDetails : skuDetailsList) {
					// 缓存
					if(!skuDetailsMap.containsKey(skuDetails.getSku())) {
						skuDetailsMap.put(skuDetails.getSku(), skuDetails);
					}
				}
				
			}
        }
    });

4、拉起支付页（需要传sku和订单号）

// 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)
        .setObfuscatedAccountId(orderId)   // 塞入订单号
        .build();
int responseCode = billingClient.launchBillingFlow(activity, billingFlowParams).getResponseCode();

// Handle the result.

5、关闭订单（发货完后执行）

支付成功，服务端发货完成后，需要客户端将订单关闭。

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);
}

6、查询订单（补单用）

用户登录进游戏服务端后，需要执行一下查询订单，发现有掉单，需要通知服务端补发货，发货完成后，客户端关闭订单。

Purchase.PurchasesResult result = billingClient.queryPurchases(SkuType.INAPP);
if(BillingResponseCode.OK == result.getResponseCode()) {
	for(Purchase purchase : result.getPurchasesList()) {
		if(Purchase.PurchaseState.PURCHASED == purchase.getPurchaseState()) {
			// TODO 通知服务端补发货，发货完成后，客户端关闭订单。
		}
	}
}

六、Unity如何拿到billing sdk的jar文件

如果你是Android Studio做的原生应用，那么直接在build.gradle中配置一下即可。

dependencies {
	// ...
	
    // Google Play Billing Library.
    implementation 'com.android.billingclient:billing:3.0.0'
    
	// ...
}

如下：

如果是Unity项目，则需要把依赖的jar文件拷贝到Assets/Plugins/Android/libs文件夹中。
我们可以通过Android Studio来定位这个jar文件，把鼠标移动到BillingClient类上，按住Ctrl键不放，点击，即可跳转到.class文件里，即可通过.class文件定位到.jar文件所在的目录。

如下：

我们把classes.jar文件重名名为google_billing_3.0.0.jar，然后再丢进Unity工程中，
google的billing其实是aar，是包含一些资源文件的，所以我们只拷贝jar还不够，jar文件外层的这些文件也需要。

不过这里建议使用下面这种方式一步到位下载aar文件。
进入google的maven网站：https://mvnrepository.com/

直接搜索你要下载的库即可。
比如搜索com.android.billingclient:billing。

直接下载aar文件。

七、补充

1、添加BILLING权限

提审Google Play，需要添加BILLING权限。
在AndroidManifest.xml中添加这个：

<uses-permission android:name="com.android.vending.BILLING" />

2、billing v2版与v3版的区别

参见Google官方文档，这里：https://developer.android.com/google/play/billing/migrate

八、结束语

完毕。
喜欢Unity的同学，不要忘记点击关注，如果有什么Unity相关的技术难题，也欢迎留言或私信~