前言
之前阅读过一篇 通过AIDL方式集成Google支付的文档，想看的，可以去阅读一下。但是呢？这个文档只能适用于API3.0以前的版本，不适用于新版的API，所以还是不推荐去阅读。新的API已经不再支持AIDL的方式。所以现在来说说现在新的集成方式，准备工作这边就不做介绍，有需要的可以参考一下官方Google支付文档，该文档主要讲解的是Google 支付的订阅功能。
准备工作
1.准备Google Console 官方开发者账号
2.准备支持Google 服务，带Google Play商店的手机
首先
准备工作完成后，这时候需要在Google Play Console 官方配置一下商品信息，同时在Google Play console页面添加一下沙盒测试，推荐先使用沙盒测试，然后再通过真实环境测试。
注：
* 商品信息配置的时候，一旦商品生效后，将无法被删除，但是可以修改
* 从未上传Google 的App，上传内部测试时间几乎和上正式版的时间差不多
* 添加测试，在应用外，"许可测试"里需要添加人员和在内部测试里添加测试人员
支付流程
引入Google Play支付的包
implementation "com.android.billingclient:billing-ktx:3.0.1"
1.初始化 BillingClient
初始化一下支付方法，在初始化里添加一个监听，主要是用于接收应用中所有交易的更新以及当用户支付完成后，刷新一个购买信息状态
private fun initBillingClient() {
Log.d(TAG, "startDataSourceConnections")
if (billingClient == null) {
billingClient = BillingClient.newBuilder(context)
.enablePendingPurchases()
.setListener { billingResult, purchases ->
onPurchasesUpdated(billingResult, purchases)
}
.build()
}
connectToPlayBillingService()
}
2.与 Google Play 建立连接
连接到 Google Play 的过程是异步操作，所以是需要使用BillingClientStateListener监听，确保能够成功的连接到Google Play
private fun connectToPlayBillingService(): Boolean {
Log.d(TAG, "connectToPlayBillingService")
if (billingClient?.isReady != true) {
billingClient?.startConnection(object : BillingClientStateListener {
override fun onBillingServiceDisconnected() {
Log.d(TAG, "onBillingServiceDisconnected")
connectToPlayBillingService()
}
override fun onBillingSetupFinished(billingResult: BillingResult) {
billingSetup(billingResult)
}
})
return true
}
return false
}
3.与Google Play连接结束
连接结束后，Google Play将会返回BillingResponseCode 官方文档。连接成功后，展示当前可以购买的商品(即商品信息)，消耗掉上一次购买操作未消耗的商品(也叫确认交易)。
注：连接成功后，必须要核销一下商品，否则会导致商品购买不成功
fun billingSetup(billingResult: BillingResult) {
when (billingResult.responseCode) {
BillingClient.BillingResponseCode.OK -> {
Log.d(TAG, "onBillingSetupFinished successfully")
querySkuDetailsAsync(BillingClient.SkuType.SUBS, skuS)
queryPurchasesHistory()
}
BillingClient.BillingResponseCode.BILLING_UNAVAILABLE -> {
Log.d(TAG, billingResult.debugMessage)
}
else -> {
Log.d(TAG, billingResult.debugMessage)
}
}
}
4.展示可供购买的商品
根据SkuType 官方文档类型来查询对应的商品详情，查询的结果将会返回本地化商品信息(即将查询的信息赋值到本地的List)。
请求成功后，调用一下invoke方法，它是kotlin的中一个函数，可能换个写法，这个函数可能看起来比较懵，那就换个写法，它就相当于onSkuDetails(skuDetailsList)
注:在配置应用内商品时创建的唯一商品 ID 将用于向 Google Play 异步查询应用内商品详情
private fun querySkuDetailsAsync(
@BillingClient.SkuType skuType: String,
skuList: List<String>
) {
val params = SkuDetailsParams.newBuilder()
.setSkusList(skuList)
.setType(skuType)
.build()
Log.d(TAG, "querySkuDetailsAsync for $skuType")
billingClient?.querySkuDetailsAsync(params) { billingResult, skuDetailsList ->
when (billingResult.responseCode) {
BillingClient.BillingResponseCode.OK -> {
if (skuDetailsList.orEmpty().isNotEmpty()) {
if (skuDetailsList != null) {
onSkuDetails?.invoke(skuDetailsList)
}
}
}
else -> {
Log.d(TAG, billingResult.debugMessage)
}
}
}
}
5.启动购买流程
从支付按钮发起请求，调用成功后，页面将会显示Google Play支付页面，即如图G1:
无法调起以下页面原因：
1.该手机不支持Google服务
2.该手机未安装Google服务三件套
3.Google Play商店“后台弹出界面”的权限被关闭
4.Google Play商店获取手机信息权限被关闭了
区别：
这里和旧的API是不一样的，旧的API，在这里是使用AIDL的方法，将userId绑定到商品信息里。
新API是可以直接通过setObfuscatedAccountId(String)的方法，将userId绑定到对应的商品信息内。
fun launchBillingFlow(activity: Activity, skuDetails: SkuDetails, userId: String) {
val purchaseParams = BillingFlowParams
.newBuilder()
.setObfuscatedAccountId(userId)
//skuDetails对应的商品
.setSkuDetails(skuDetails)
.build()
Log.d(TAG, "launchBillingFlow ${skuDetails.originalJson}")
billingClient?.launchBillingFlow(activity, purchaseParams)
}
6.确认购买,支付
Google Play在支付完成后会再调用onPurchasesUpdated()，然后会将结果通过接口返回，用户支付成功后，Google Play将会生成购买令牌(唯一标识)，同时用户将会收到对应订单的邮件，订单ID(退款需要)，以及扣款通知，同时也可以在Google Play商店看到对应的订单。BillingResponseCode 官方文档
private fun onPurchasesUpdated(
billingResult: BillingResult,
purchases: MutableList<Purchase>?
) {
Log.d(TAG, "onPurchasesUpdated ${billingResult.responseCode} ${billingResult.debugMessage}")
when (billingResult.responseCode) {
BillingClient.BillingResponseCode.OK -> {
purchases?.apply {
for (purchase in purchases) {
handlePurchase(purchase)
}
}
}
BillingClient.BillingResponseCode.ITEM_ALREADY_OWNED -> {
//购买失败，因为该物品已被拥有，该商品需要被消耗
Log.d(TAG, billingResult.debugMessage)
queryPurchasesHistory()
}
BillingClient.BillingResponseCode.SERVICE_DISCONNECTED -> {
//购买失败，Google服务断开，可能网络原因
connectToPlayBillingService()
}
else -> {
Log.d(TAG, billingResult.debugMessage)
}
}
}
做到这一步，你是不是感觉已经流程已经结束了，这边可以准确告诉你，它还没有结束，它还需要调用一个消耗交易操作(即确认交易)，如果没有这一步，正常用户会在3天内退款，并且取消这一笔订单，测试用户会在5分钟内取消订单。
7.处理购买交易(消耗，确认交易)
在确认交易之前要判断一下PurchaseState 官方文档，当购买交易只有处于PURCHASED的状态下，才可以确认交易，不在此状态下的交易，是没有办法进行确认操作的
处理交易方式：
1.验证当前购买交易
2.提供内容给用户,并且将"确认内容"传送给用户，并且标志成已消费
注：如果您在三天内未确认购买交易，用户会自动收到退款，并且 Google Play 会撤消该购买交易
Api2.0以后都是需要确认交易，2.0以前是不需要消耗的
private fun handlePurchase(purchase: Purchase) {
Log.d(TAG, "handlePurchase ${purchase} isAcknowledged: ${purchase.isAcknowledged}")
if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED) {
GlobalScope.launch(Dispatchers.Main) {
if (!purchase.isAcknowledged) {
val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()
.setPurchaseToken(purchase.purchaseToken)
withContext(Dispatchers.IO) {
billingClient?.acknowledgePurchase(acknowledgePurchaseParams.build()) {}
}
}
}
}
}
8.提取购买交易(查询购买交易，也可以叫恢复购买)
当用户进入App的时候，建议在在onResume()和onCreate()调用此方法，主要用于处理用户在App以外购买成功，为什么这么说？因为订阅用户是可以在Google Play商店里，进行续订，购买等操作的，但是购买成功后，同事也会提示用户需要重新回到App，进行确认交易的操作步骤。
存在漏单多种原因:
1.在购买过程中出现网络问题,收到购买交易的通知之前失去了网络连接
2.多台设备：用户在一台设备上购买了一件商品，然后在切换设备时看到该商品
3.处理在您的应用外进行的购买交易(在App外交易)
private fun queryPurchasesHistory() {
val result = billingClient?.queryPurchases(BillingClient.SkuType.SUBS)
result?.purchasesList?.apply {
forEach {
handlePurchaseHistory(it)
}
}
Log.d(TAG,"queryPurchasesHistory results:${result?.purchasesList} size: ${result?.purchasesList?.size} "
)
}
9.调用消耗方法
调用方法之前，先判断一下该订单是否处于可被消耗的状态，在该订单消耗之前，将purchaseToken发送给后端。
private fun handlePurchaseHistory(purchase: Purchase) {
Log.d(
TAG,
"handlePurchaseHistory $purchase handlePurchase.purchaseState: ${purchase.purchaseState} isAcknowledged: ${purchase.isAcknowledged}"
)
if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED) {
GlobalScope.launch(Dispatchers.Main) {
if (!purchase.isAcknowledged) {
// 向后端发送purchaseToken
·····
withContext(Dispatchers.IO) {
val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()
.setPurchaseToken(purchase.purchaseToken)
billingClient?.acknowledgePurchase(acknowledgePurchaseParams.build()) {}
}
}
}
}
}
总结
Google 支付看似流程简单，但是实际上细节方面比较稍微有一点难处理，但是如果一点点捋下来的话s ，发现逻辑其实也不是很复杂，但是比较折磨人。
