猎宝SDK对接说明文档-version5.0.1.docx

江苏猎宝网络科技有限公司猎宝SDK对接说明文档Version 5.0.1人员：猎宝Android开发团队日期：2015年12月1日公司：江苏猎宝网络科技有限公司目录1.1编写目的31.2集成SDK31.2.1引进LB_Sdk_Lib31.3对接登录系统81.3.1登录接口说明81.4对接充值系统101.4.1充值接口101.5浮点功能111.6资源回收接口（游戏退出必须调用）131.7充值服务器回调接口开发141.7.1通知充值结果141.7.2签名说明151.7.3合作商相应请求161.7.4支付编码表161.1编写目的本文档提供给游戏合作商对接的同学使用，文档主要分四大部分：l 集成SDKl 对接登录系统l 对接充值系统l 充值服务器回调接口说明：游戏合作商（统称“合作商”）运营方（LB）1.2集成SDK组成l LB_Sdk_Lib的android库项目l AndroidManifest.xml清单文件1.2.1引进LB_Sdk_Lib引进LB_Sdk_Lib是基于Eclipse开发上实现的，具体流程如下：1. 将LB_Sdk_Lib项目导入Eclipse中，右键弹出如下界面，按图1.1操作图1.12. 右键项目工程，弹出的菜单中，选择最下面的Properties弹出页面如图1.2所示：图1.2点击add弹出如下图1.3：图1.3回到图1.2点击Apply之后点击OK，添加库项目成功。3. 把AndroidManifest.xml清单文件中的必要xml配置剪切到目标项目，具体内容如下：l 权限信息l 默认的参数配置l Activity和Service等组件的配置1.3对接登录系统1.3.1登录接口说明合作商调用相关接口获取登录数据后，需要做验签处理，具体如下：1. 调用LBSDKManager的getInstance(Context cxt)静态方法来获取LBSDKManager的实例（保险起见该方法可以多次调用，不会影响程序运行性能）。调用LBSDKManager的方法显示登录页面。使用方法如下：参数说明：参数名类型参数说明thisContextContext实例loginlistOnLoginListener登录接口的回调成功登录的信息体LogincallBack解析：参数名类型参数说明usernameString登录成功后，用户的用户名logintimeString用户登录的时间戳signString用来登录验签对比（签名生成规则）登录失败信息体LoginErrorMsg解析参数名类型参数说明codeint登录失败错误码msgString登录失败的消息提示参数签名规则参数名类型参数说明签名顺序usernameString用户帐号1appkeyString应用appkey2logintimeString登录时间，时间戳格式3签名字符串示例：sign = MD5(“username=t315688&appkey=91bac46a9b70bd2db563cc483d443ba3&logintime=1395634100”)1.4对接充值系统1.4.1充值接口1. 调用LBSDKManager的getInstance(Context cxt)静态方法来获取LBSDKManager的实例。2. 调用LBSDKManager的显示充值界面。参数说明如下：参数名类型是否必须参数说明actContext是调用者的实例roleidString是角色IDmoneyString是充值金额（元）serveridString是合作商服务器idproductnameString是产品名称productdescString是产品描述attachString否拓展参数（自定义参数）paymentListenerOnPaymentListener是对充值是否成功进行监听充值示例如下：充值成功信息体PaymentCallbackInfo解析：参数名类型参数说明msgString充值结果描述moneyint充值金额数充值失败信息体PaymentErrorMsg解析参数名类型参数说明codeint状态码moneyInt意图充值金额数（元）msgString充值失败消息提醒1.5浮点功能函数：1. 登陆成功后的回调方法中调用showFloatView方法，显示悬浮窗口。按下面设置：2. 在Activity.onStop()/Activity.onPause()方法中调用removeFloatView方法，保证中断游戏，浮点隐藏。在Activity.onResume()/Activity.onStart()方法中调用showFloatView方法，保证回到游戏后，浮点显示，如下方式：1.6资源回收接口（游戏退出必须调用）1. 调用LBSDKManager的getInstance(Context cxt)静态方法来获取LBSDKManager的实例。2. 调用LBSDKManager的recycle()方法进行资源回收。注：该方法在游戏退出时调用（必须要调用）1.7充值服务器回调接口开发合作商需要开发一个接收充值结果的系统，提供该系统的URL给LB，由LB发起请求，合作商响应请求。请求的协议采用http post1.7.1通知充值结果玩家在游戏中使用LB手游SDK进行充值，LB在处理完充值流程之后，主动请求通知游戏方，游戏方未返回游戏接收成功（接收成功判断请参考合作商响应请求），LB会启动系统重发机制（一共发送五次，如果五次没有响应将由工作人员补单）。注意：只有充值成功才会回调通知结果，充值失败的不会通知合作商接收到请求后，需要对所有String类型的参数值做URLEncode处理，URLEncode编码统一为UTF-8，请求参数具体字段说明如下：参数名类型长度参数说明签名顺序orderidString35LB订单号1usernameString30LB登录帐号2gameidInt11游戏ID3roleidString30游戏角色ID4serveridInt11服务器ID5paytypeString10支付类型，支付类型参数说明6amountInt11成功充值金额，单位（元）7paytimeInt11玩家充值时间，时间戳形式，ttachString商户拓展参数9signString32参数签名（用于验签对比）101.7.2签名说明合作商接收到LB的请求后，需要获取相关参数并做验签处理，验签规则如下：以请求参数字段说明中的签名顺序签名，规则为key=value的形式，参数之间以“&”符号相连，组成一串字符串。目前共10个签名字段。签名算法为MD5，统一使用32位UTF-8加密算法。编码后与参数中的sign进行对比，如果相同则签名通过，否则失败。签名字符串示例：sign = MD5(“ordered=100000&username=zhangsan&gameid=6&roleid=zhangsanfeng&serverid=1&paytype=1&amount=1&paytime=20130101125612&attch=test&appkey1231231232213”)注意：验签参数值为URLEncode后的内容，如果参数没有数据值，请以“key=”的形式进行签名，例如：paytime=&attach=自定义。要注意字段的大小写。另外，appkey由LB提供，登录，充值使用同一个appkey。1.7.3合作商相应请求合作商接收到LB发出的请求后，以纯字符串的形式返回下列代码，例如：out.print(“success”);代码代码描述success接收成功errorSign签名错