有米Android SDK开发者文档( 八 )


注意:这里有一个很关键的细节,您必须为配置两个,的名字分别是以"ep_"和"vp_"开头的,以您的应用的AppID结尾的字符串 。(AppID是从有米主站上申请的应用ID,16个字符,所以的总长度应该是19个字符)
附录:积分订单类定义
:
package net.youmi.android.offers;.../*** 积分订单列表* */public class EarnPointsOrderList {/*** 获取服务器上设置积分单位名称*/public String getCurrencyName();/*** 根据index获取订单详情(EarnPointsOrderInfo)*/public EarnPointsOrderInfo get(int index);/*** 判断列表是否为空*/public boolean isEmpty();/*** 获取列表项数量*/public int size(); }
:
package net.youmi.android.offers; /*** 赚取积分的订单*/public final class EarnPointsOrderInfo {/*** 获取订单号(具有唯一性)*/public String getOrderID();/*** 获取渠道号,这里指在AndroidManifest.xml上配置的有米渠道号,详见文档 */public int getChannelId();/*** 获取开发者自定义用户唯一标识,该值通过OffersManager设置*/public String getCustomUserID();/*** 获取积分订单的状态: 1.表示开发者获得了收入并且用户获得了积分 。2.表示开发者没有获得收入但用户获得了积分(未通过审核以及测试模式下结算无效等情况) 。*/public int getStatus()/*** 本次获取积分的描述语,如"成功安装《--》获取了100金币" */public String getMessage();/*** 本次获得的积分 */public int getPoints();/*** 本次获得积分的结算时间*/public long getSettlingTime();}
7.自定义积分账户(可选)
如果您不想使用上文提到的SDK积分托管,而是希望实现自己的客户端积分托管功能(即自定义积分账户),请参照监听积分赚取订单的步骤实现积分订单监听并实现自定义积分管理功能 。
8.服务器积分订单回调(可选)
如果您希望用户赚取积分的订单结算完成后,直接由有米的服务器通知您的服务器,可以使用服务器积分订单回调接口,协议传送门:有米积分墙积分订单服务器回调协议
1.实现接收订单的回调接口时,请务必按照协议说明进行 。
2.务必在有米主站开发者面板的目标应用详情页上设置您的回调地址 。
请注意,一旦您设置了积分订单回调地址,有米服务器会在用户的积分订单成功结算后第一时间通知您的服务器,但客户端将不再接收到任何积分订单记录,即上文提到的SDK积分托管、监听积分赚取订单以及自定义积分账户等功能将不可用 。
9.配置积分墙SDK的积分到账提醒(可选)
为了让用户更加清楚获知积分的赚取情况,SDK使用了悬浮提示框以及通知栏提示来提醒用户积分到账情况 。此功能是默认开启的,但您可以通过的相关接口来关闭提醒功能 。
示例代码
...import net.youmi.android.offers.PointsManager...//关闭积分到账通知栏提示功能PointsManager.getInstance(this).setEnableEarnPointsNotification(false);...//关闭积分到账悬浮框提示功能PointsManager.getInstance(this).setEnableEarnPointsToastTips(false);...