[MMSDK3.1.0开发文档.doc

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