Google支付(In-app Billing)接入

该文档基于第3版。

应用内结算简介

一、概述

使用应用内结算(In-app Billing)时,我们的应用通过相应的API来访问In-app Billing服务。应用不直接与Google Play服务器通信,而是通过进程间通信(IPC)向Google Play发送结算请求并接收Google Play返回的响应。

In-app Billing在使用之前需要注意以下几点:

  • 只能用来销售数字内容,不能销售实体商品
  • 应用一旦被购买,无法进行退款服务 Google
  • Play不提供内容交付,开发者需要自行交付在应用内购买的数字内容
  • 一个应用不能购买另一个应用发布的商品

目前使用的In-app Billing是第3版,需要运行在Android2.2或更高版本,而且要求设备安装了最新版本的Google Play商店。第三版支持两种商品:托管的应用内商品(Managed product)和订阅(Subscription)。

托管的应用商品:由Google Play跟踪和管理其所有权信息的商品,托管的商品在被购买后,必须先向Google Play发送消耗请求进行消耗,然后才能供用户再次购买。
订阅:允许开发者通过按月或按年结算的方式在应用内向用户销售内容、服务或功能,订阅无法消耗。

二、Google Play购买流程

购买开始时,应用需要针对相应的应用内商品发送结算请求。然后,Google Play 会处理此次交易的所有结帐详情,包括请求和验证付款方式以及处理财务交易。
当结帐流程完成后,Google Play 会向应用发送购买详情,例如订单号、订单日期和时间以及所付价格。应用不需要处理任何财务交易,这些事宜完全Google Play负责。

具体流程如下所示:
Google支付(In-app Billing)接入_第1张图片

  1. 应用向Google Play发送isBillingSupported 请求,确定当前使用的应用内结算 API 目标版本是否受支持;
  2. 启动或用户登录时,向Google Play进行查询,确定用户拥有哪些商品,发送getPurchases 请求;
  3. 通知用户商品是否可供购买,发送getSkuDetails 请求;
  4. 提示用户购买,发送getBuyIntent 请求。

三、消耗托管的应用内商品

应用内商品一经售出,就会被视为“被拥有”。处于“被拥有”状态的应用内商品无法再通过 Google Play 购买。必须对“被拥有”的应用内商品发送消耗请求,然后 Google Play 才能再次将其设成可购买状态。消耗应用内商品会将商品切换回“未被拥有”状态并删除之前的购买数据。
通过发送consumePurchase 提出消耗请求。

接入之前的准备

一、在 Google Play Developer Console 创建应用

  1. 注册一个开发者账号,按提示绑定信用卡并支付25美金;
  2. 创建一个新的app,填写应用名称;
    这里写图片描述
  3. 点击上图中的Prepare Store Listing,按照提示填写app的基本信息,信息一定要填写完整,否则无法正常发布应用;
  4. 在Services & APIs中,找到license key记录下来。

二、添加In-app Billing库文件(以Android Studio为例)

  1. 在yourSDKpath/extras/google/market_billing/中找到文件IInAppBillingService.aidl,在src/main中创建文件夹aidl,然后创建package‘com.android.vending.billing’ 如图所示
    这里写图片描述
  2. 点击执行rebuild,在下图所示位置看到IInAppBillingService.java文件,即为导入成功
    这里写图片描述
  3. 将market_billing/samples/TrivialDrive 中util包整个复制到项目中。

三、声明权限

在AndroidManifest.xml中声明权限:

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

四、初始化与Google Play的连接

1、初始化IabHelper

IabHelper mHelper;

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    String base64EncodedPublicKey;

    // compute your public key and store it in base64EncodedPublicKey
    mHelper = new IabHelper(this, base64EncodedPublicKey);
}

2、调用startSetup方法

mHelper.startSetup(new IabHelper.OnIabSetupFinishedListener() {
@Override
public void onIabSetupFinished(IabResult result) {
    if (!result.isSuccess()) {
        Log.e(TAG, "Problem setting up In-app Billing: " + result);
    }

    if (mHelper == null) {
        return;
    }
}
});

3、在Activity的onDestory()中解绑

@Override
protected void onDestroy() {
    super.onDestroy();
    if (mHelper != null) {
        mHelper.dispose();
    }
    mHelper = null;
}

创建应用内购买的商品

一、上传APK并发布

进入APK面板,上传一个带有签名的APK文件,文件可以上传到PRODUCTION、BETA TESTING、ALPHA TESTING中任意一个中,三者区别见附录1。下面的流程以BETA测试为例。

  1. 进入BETA TESTING页面,上传带有签名的APK文件;
  2. 进入Content Rating页面,填写内容分级调查问卷,填完进行评估,根据结果接受评估或者重新填写;
  3. 进入Pricing&Distribution页面,选择应用是付费还是免费,之后选择产品要发布的国家和地区;
  4. 确保如图所示四个内容都显示为绿色对勾,即可发布应用;
    这里写图片描述
  5. 点击Publish app发布,如果按钮显示为灰色,可以点击按钮上方的Why can’t I publish?查看还需要添加的内容,应用发布之后需要等候几个小时。在任一页面可以查看App的发布状态,如左图所示为正在发布,右图显示已经发布成功。
    这里写图片描述 这里写图片描述

二、选择测试方法(BETA测试为例)

待APP发布完成之后,选择一个测试方法,测试方法有三种(详见附录),此处以封闭式Beta测试为例。

  1. 登录Google Play开发者控制台
  2. 选择相应应用,点击左侧菜单中的APK
  3. 选择Beta测试,进入“封闭式测试“
  4. 创建列表或选择已有列表
  5. 将Opt-in URL中链接发送给测试人员
  6. 测试人员需要点击测试连接并选择加入测试

注意:测试时可以选择测试账号是否需要真实支付。比如应用在进行大范围测试时,需要用户可以进行真实的付款操作,而内部测试人员可以进行支付测试,但无需真实付款。可以将内部测试的账号配置到Google Play后台。
配置如下:

这里写图片描述

将账号填入下图

这里写图片描述

三、创建商品

  1. 点击左侧菜单中“In-app Products”,选择”Add new Product“
  2. In-app Billing第3版支持类型为’Managed product’和’Subscription’的商品
  3. 配置product ID时要保证product ID是唯一的,product ID也叫做SKU,product ID在查询商品和购买商品时需要用到
  4. 带商品信息填写完成,将其状态置为active

客户端相关内容实现

客户端实现具体内容详见官方Demo,此处只简单举例说明(示例代码不全,参照Demo)。

一、查询商品详情

通过创建商品时添加的product ID,可以在客户端查询商品的详情,调用queryInventoryAsync(boolean, List, QueryInventoryFinishedListener)

  • boolean:是否返回商品详情(此处应设置为true)
  • List:要查询的product IDs(SKUs)
  • QueryInventoryFinishedListener:监听查询结果

如果查询成功,返回结果封装在Inventory 对象中。

代码示例:

List productNameList = new ArrayList<>();
productNameList.add(PRODUCT_ONE);
productNameList.add(PRODUCT_TWO);
mHelper.queryInventoryAsync(true, productNameList, new IabHelper.QueryInventoryFinishedListener() {
    @Override
    public void onQueryInventoryFinished(IabResult result, Inventory inventory) {
        String price = inventory.getSkuDetails(PRODUCT_ONE).getPrice();
    }
});

二、购买托管的商品

购买商品时也需要product ID,调用launchPurchaseFlow(Activity, String, int, OnIabPurchaseFinishedListener, String)

  • Activity:调用launchPurchaseFlow的activity
  • String:product ID,确保是ID而不是商品名称
  • Int:request code值,可以是任何正整数,Google Play会将该值随购买的回复一起返回给Activity的onActivityResult
  • OnIabPurchaseFinishedListener:购买请求完成的监听器
  • String:字符串标记,惟一的标示购买请求,可以为空。如果你指定一个字符串值,谷歌将返回此字符串以及购买响应。在实际项目中最好由服务器随机生成一个字符串使用

如果购买成功,返回结果封装在Purchase 对象里。
类型为‘Managed product’的商品可以重复购买,但再次购买之前一定要先向Google Play发送商品消耗的请求,否则无法购买。

代码示例:

mHelper.launchPurchaseFlow(this, productId, REQUEST_CODE, new IabHelper.OnIabPurchaseFinishedListener() {
            @Override
            public void onIabPurchaseFinished(IabResult result, Purchase info) {

            }
        }, "XXXXXXX");

三、购买订阅内容

在购买订阅内容时,调用的方法与购买托管的商品不一样,强行调用同一个方法,会在确认购买时接收到Google Play返回的错误信息。
调用launchSubscriptionPurchaseFlow(Activity, String, int,OnIabPurchaseFinishedListener, String), 参数解释参照2中内容。

代码示例:

mHelper.launchSubscriptionPurchaseFlow(this, productId, REQUEST_CODE, new IabHelper.OnIabPurchaseFinishedListener() {
    @Override
    public void onIabPurchaseFinished(IabResult result, Purchase info) {

}
}, "purchase subscription");

四、查询已购买商品

查询用户已经购买的商品,调用queryInventoryAsync(QueryInventoryFinishedListener)
注意:查询已购买商品时,查询到的是当前登录到Google Play上的用户已购买到的商品。

代码实例:

mHelper.queryInventoryAsync(new IabHelper.QueryInventoryFinishedListener() {
    @Override
    public void onQueryInventoryFinished(IabResult result, Inventory inv) {

    }
});

五、消耗托管的商品

一旦一个商品被购买,它将被认为是“被拥有”状态,处于该状态下的商品无法被同一用户再次购买。因此需要发送根据需求向Google Play发送消耗请求,调用consumeAsync(Purchase, OnConsumeFinishedListener)

  • Purchase:要消耗的商品
  • OnConsumeFinishedListener:消耗完成之后的监听

代码示例:

mHelper.consumeAsync(purchase, new IabHelper.OnConsumeFinishedListener() {
        @Override
        public void onConsumeFinished(Purchase purchase, IabResult result) {

        }
    });

测试注意事项

由于配置比较复杂,在项目测试的时候,如果遇到“应用无法购买”的问题,请检查以下几点是否完成:

  • 确保上传了带有签名的APK文件;
  • 确保设备上安装了带有签名的APK,而不是调试版;
  • 确保在测试中添加了测试人员;
  • 确保设备登录的账号属于测试账号;
  • 确保测试账号激活了测试链接(最容易忽略);
  • 确保设备上的应用版本号和版本名称与Google开发者后台上传的APK一致;
  • 确保商品状态为Active。

参考文档:
http://developer.android.com/intl/zh-cn/google/play/billing/index.html
http://developer.android.com/intl/zh-cn/training/in-app-billing/index.html

附录:Alpha/Beta 版测试

Google为开发者提供了Alpha和Beta两个版本进行测试,开发者不必有正式版APK就可以发布Alpha/Beta应用。Alpha/Beta测试不会影响到线上正式发布的应用,因为只有测试组的用户才会收到Alpha/Beta版本的更新。如果没有正式版的应用,那么只有测试组的用户才可以找到并下载应用。

一、Alpha/Beta版本

使用Alpha/Beta测试时,需要保证测试版APK的版本号高于正式版APK的版本号。
注意:

  1. Alpha版APK需要具有高于Beta 版 APK的版本号才能供Alpha版测试人员使用;
  2. 如果上传的Beta版APK高于Alpha版,则Alpha版将会自动停用;
  3. 如果上传的正式版APK高于Alpha/Beta版,则Alpha/Beta版将会自动停用;
  4. Alpha用户可以测试Alpha、Beta和正式版,Beta用户可以测试Beta和正式版。

二、不同的测试方法(以Beta为例)

1、封闭式Beta版测试

使用封闭式Beta测试,可以按电子邮件创建Beta测试人员列表,测试用户必须拥有Google账号(@gmail.com)或Google Apps账户才能加入测试。
列表创建完成之后,需要将Opt-in URL中链接发送测试人员,待测试人员使用测试账号访问该链接激活测试账号,才可以正常测试。Opt-in URL只有在应用状态为“已发布”时才会显示。

2、开放式Beta版测试

无需指定电子邮件地址或创建 Google网上论坛或 Google+社群。适用于大范围测试。与封闭式测试相同,将发布之后的链接发送给测试人员,待激活之后即可开始测试。

3、使用Google网上论坛或Google+社群执行封闭式Beta版测试

通过添加Google网上论坛电子邮件地址或Google+社群网址进行链接分享。测试人员必须加入添加的Google网上论坛或Google+社群才可以加入Beta测试,测试之前也需要激活测试账号。

关于Alpha/Beta版本测试详情以及分阶段发布,可以参照Google官方文档:
https://support.google.com/googleplay/android-developer/answer/3131213?hl=zh-Hans

你可能感兴趣的:(Android经验)