1、DianCai Android_Wall_SDK_V9.3 使用说明1DianCai Android Wall SDK 使用说明日 期： 2017-01-24版 本： V9.3 DianCai Android_Wall_SDK_V9.3 使用说明2目录目录 .1一、点财积分墙 .21. 简介 .22. 适用范围 .23. 名词解释： .2二、开发手册 .31. 注册及申请 APP_ID.32. SDK 嵌入 .43. 接口说明 .74. 非托管货币功能 .105. 市场渠道编号 .14附录 I：其他注意事项 .14技术支持 .15DianCai Android_Wall_SDK_V9.3 使用
2、说明3一、点财积分墙1. 简介点财 Android_SDK 方便开发者在 Android 应用中更好的集成积分墙提供的各项功能，同时也为开发者提供了一套现成的 Demo 源代码。开发者可以在自己的应用中设置“虚拟货币“ ，当用户或玩家通过积分墙下载点财推荐的优质 Android 应用后，即可立即获得相应的“ 虚拟货币“。2. 适用范围点财 Android 版 SDK 提供了一套现成的开发包及 Demo 源代码，便于开发者在Android 应用中方便的集成各项功能。本文档描述了标准版 SDK 的用途与用法，并提供了示例代码。您仅需要在现有的应用中加入少量新代码，就可以实现平台的各项功能，轻松获得
3、用户量和收入的倍增。3. 名词解释：使用者：手机使用者。在使用过程中，他们会通过点财积分墙下载安装使用点财推荐的应用获得系统奖励的“虚拟币” ，并使用“虚拟币”消费。开发者：将 SDK 嵌入自己开发的游戏中，通过使用者获取收益的群体。SDK：积分墙开发包，当中提供了“虚拟币”体系和各种使用接口。APP_ID: 注册应用时获得的 5 位字符串，用于绑定开发者和应用。APP_SECRET: 注册应用时获得的 32 位字符串，用于绑定开发者和应用。DianCai Android_Wall_SDK_V9.3 使用说明4二、开发手册1. 注册及申请APP_ID1.1 登陆点财移动广告平台官网( http
4、:/)进行注册1.2 创建自己的应用名称 填写包名称，然后提交。提交后，得到系统为您生成APP_ID 和 APP_SECRET。1.3 下载标准版 SDK 开发包。1.4 查看已提交的应用，处于审核通过或未审核状态。工作人员会在您提交应用后，最短时间内完成审核工作。1.5 在全部应用选单中，可通过右侧第二个按钮“修改”来设定应用的虚拟货币兑换比例等参数。1.6 在数据报表选单中，可以查看应用给您带来的收入2. SDK嵌入注意：关于工程里如何使用 DianCai SDK 部分 ，以例子工程为准，文档只做参考2.1 将 diancai_android_wall_v9.3.jar 拷贝到 libs
5、下，加入到您的 Build Path。2.2 修改 AndroidManifest.xml。2.2.1 在 AndroidManifest.xml 注册 Activity2.2.2 在 AndroidManifest.xml 注册 Service2.2.3 增加权限 ：2.3 初始化/ 在应用的入口处设置context/ 如果是Activity,在第一个启动的Acitivty里面的onCreate的开始写上下面的代码；/ 设置appId，appSecret，即是你的应用在点财后台注册获得的应用 Id和应用密码DianCai.initApp(this, appId, appSecret);或者初
6、始化的时候，声明渠道号(channelId) 代表应用将要上传的市场渠道，市场渠道代码请详见。DianCai Android_Wall_SDK_V9.3 使用说明6DianCai. initApp(this, appId, appSecret, channeId);2.4 展示有虚拟金币的广告墙2.4.1调用 DianCai.showOfferWall()接口，即可展示广告墙。（有积分，有奖励的）2.5 展示无虚拟金币的推荐墙2.5.1调用 DianCai.showGoodApps()接口，即可展示广告墙。（没有积分的，纯推荐性质的）2.6 特殊说明2.6.1 需要混淆代码的情形如果是需要混淆
7、代码的，需要在 proguard.cfg 文件的最底部加上：-keep class com.dc.wall.* *; 2.6.2 关于 AndroidMenifest 设置渠道号（适用于批量分渠道号）：如果是需要将渠道号设置在 AndroidMenifest.xml 里，需要这样设置：DianCai Android_Wall_SDK_V9.3 使用说明7其中 0 是点财默认的渠道号，市场渠道号请详见，如果渠道为 安卓市场 需更改为如果渠道为 腾讯应用宝 市场 需更改为注意：1.如果同时使用了上面的 AndroidMenifest 方法和 DianCai. initApp(this, APP_I
8、D, APP_Secret, MarketId)设置 MarketId，sdk 会以 AndroidMenifest为准。3. 接口说明3.1 显示 积分 墙免费获取“虚拟币”DianCai.showOfferWall();3.2 显示精品推荐广告列表DianCai.showGoodApps();DianCai Android_Wall_SDK_V9.3 使用说明83.3 获取虚拟货币的总额DianCai.QueryMoney(IQueryMoneyNotifier queryMoneyNotifier);实现 IQueryMoneyNotifier 接口，实现下面的两个方法用来接收来自服务器
9、的响应:/* Description: 获取总虚拟币的接口。扣除成功则返回虚拟币的名称，余额，失败时返回失败的代码*/public interface IQueryMoneyNotifier /* Description: 查询成功时返回虚拟币的名称，余额*/public void querySuccess(int totalMoney, String currencyUnit)/* Description: 查询失败时返回失败的代码*/public void queryFailed(int errorCode)3.4 扣除玩家“虚拟币”扣除成功则返回余额，失败时返回失败的信息DianCai.
10、reduceMoney(int money,IReduceMoneyNotifier reduceMoneyNotifier）;实现 IReduceMoneyNotifier 接口，实现下面的两个方法用来接收来自服务器的响应:/* Description: 扣除虚拟币的接口。扣除成功则返回余额，失败时返回失败代码*/public interface IReduceMoneyNotifier /*DianCai Android_Wall_SDK_V9.3 使用说明9* Description: 扣除成功则返回虚拟币的余额，虚拟币的名称*/public void reduceSuccess (in
11、t totalMoney, String currencyUnit);/* Description: 失败时返回失败的代码*/public void reduceFailed(int errorCode);3.5 奖励用户“虚拟币”DianCai.addMoney(int money, IAddMoneyNotifier addMoneyNotifier）;实现 IAddMoneyNotifier 接口，实现下面的两个方法用来接收来自服务器的响应:/* Description:赠送 虚拟币的接口，赠送成功则返回用户的余额,失败则返回失败信息代码。*/public interface IAddM
12、oneyNotifier /* Description: 返回用户的余额* param totalMoney用户的余额*/public void addSuccess(int totalMoney);/* param errorCode失败信息代码* Description: 失败则返回失败信息代码*/public void addFailed (int errorCode);注意：扣除和赠送虚拟币范围（02147483647）DianCai Android_Wall_SDK_V9.3 使用说明10用户拥有虚拟币范围（02147483647）3.6 广告首次安装激活( 签到)后的通知（即客户端
13、回调接口）备注：若已经使用服务器端回调则可不使用该接口；DianCai.setEarnMoneyNotifier(IEarnMoneyNotifier earnMoneyNotifier);实现 IEarnMoneyNotifier 接口，实现下面的两个方法用来接收广告首次安装激活后产生的回调:/* Description:赠送 虚拟币的客户端回调接口，激活成功则返回赠送的虚拟币数量,失败则返回失败信息代码。*/public interface IEarnMoneyNotifier /* Description: 广告激活成功* param tradeType 0安装性质的， 大于或等于1 签到(1代表第一次签到， * 2代表第二次签到 依次类推)* param money 赠送的虚拟币* param packageName广告的包名称*/Public void earnSuccess(int tradeType, int money,String packageName)public void earnFailed(int tradeType, int errorCode, String errorMessage);3.7 设置用户自定义参数DianCai.setUserId(String userId)
