应用内付费开发者指南－能力开放平台版-CSTO.doc

中国移动互联网基地计费能力 开发指南 强联网 版本 V2.4-SDK指南整合版 2014年6月 目录 1 发应用内计费 3 1.1 开发应用 3 1.1.1 准备开发环境 3 1.1.2 导入SDK 3 1.2 开发者开发应用注意事项 5 2 应用内计费SDK使用手册 5 2.1 SDK组成和接口说明 5 2.1.1 Purchase API说明 6 2.1.2 OnPurchaseListener 8 2.1.3 OnPurchaseListener中返回数据说明 8 2.1.4 AndroidManifest 设置（开发者必须要注意的地方） 9 2.2 业务流程及要点说明 12 2.2.1 主要流程 12 2.2.2 版权文件 13 2.2.3 用户身份数字证书/数字证书 13 2.2.4 授权文件 13 2.3 SDK调用时序 14 2.3.1 构造及初始化 14 2.3.2 查询 15 2.3.3 订购 15 2.4 示例代码 16 2.4.1 SDK初始化 18 2.4.2 SDK订购，查询,退订接口的调用 20 2.4.3 获取渠道ID 21 2.5 应用混淆 23 3 返回码说明表（强联网） 25 发应用内计费 准备开发环境 应用内计费 Eclipse: /downloads/ JDK: /technetwork/java/javase/downloads/index.html Android SDK: /SDK/index.html 导入SDK SDK以jar文件的形式提供给开发者在程序中使用，同时提供HTML格式的API文档供查阅相关类、方法、常量等说明。 以下内容将说明如何在Eclipse中，将jar文件加入到应用工程中去。 将mmbilling.2.4.0.jar文件拷贝到应用工程的libs目录下，如没有该目录，可新建； 在Project Explorer中右击鼠标，从弹出的菜单中，选中“Properties”; 在Properties窗口的左侧菜单项中，点击“Java Build Path”，并在右侧选中“Libraries”; 点击“Add JARs…”按钮，在弹出窗口中，选中jar文件，如下图1所示。 图表 1 添加jar文件 最后，检查Referenced Libraries中是否可以看到jar文件，如下图2所示。如果可以，则表示配置成功，否则，请检查上述步骤是否执行成功。 图表 2 检查 ＊将libidentifyApp.so和libcasdkjni.so复制到libs\armeabi目录下 开发者开发应用注意事项 为保证自身敏感数据(APPID、APPKEY、PAYCODE)的安全性，请尽量采用加密等手段保存，避免以常量字符串形式出现于源码。 为保护自身数据和付费点，开发完成后，建议对APK做混淆处理。 应用中不能同时发起两起或者以上的订购操作，比如不能同时启动两个查询订单的线程。 包月和单次计费的业务，可以缓存授权结果在本地，以避免过多网络的交互。但缓存的授权可能会有不同步的情况，应用可根据实际业务情况决定是否启用本地缓存授权。也可以在运行过程中，清除缓存授权(clearCache())。 可批量购买的计费点，在两次订购之间，目前有时间限制(目前定义15秒钟) 可批量购买的计费点，一次订购数量不能超过10个。 中国移动部分省份已经开始销售147号段的SIM卡，该号段同样可以使用IAP进行计费。请应用开发者注意判断此号段的SIM卡，以免造成不必要的麻烦。 应用内计费 SDK组成和接口说明 SDK公开的接口包括： Purchase API说明 Purchase对象是SDK提供给开发者发起订购，查询的接口。 开发者在实例化该对象后，调用其中的函数可以处理相应的业务。 构造实例： Purchase对象的创建使用了单例模式，不需要重复创建： purchase = Purchase.getInstance(); 各参数设置： purchase.setAppInfo(appid, appkey); // 设置计费应用ID和Key (必须) purchase.setTimeout(10000, 10000); // 设置超时时间(可选)，可不设置，缺省都是10s 初始化： Init()，初始化函数。此函数主要实现用户身份数字证书申请。开发者须在APP初始化中调用，这样可减少用户在订购，查询业务中的等待时间。 purchase.init(context, listener); //初始化，传入监听器 调用后，请等待onInitFinish()完成后，再发起其他业务