安卓网游SDK文档

SDK4.4.0接入方式变更和接入要求说明

当乐网游SDK从4.3.4版本开始,接入方式有比较大的改动,请各位开发大大留意新版开发包内附带的接入文档,客户端接入文档和服务端接入文档均有改变


一、客户端下单参数传递调整


新版SDK要求CP在下单时传递准确的游戏服务器ID(zoneId)、游戏服务器名称(zoneName)、游戏角色ID(roleId)、游戏角色名称(roleName)等,具体说明如下:


①游戏服务器ID(zoneId):指用户创建角色所在服务器(区)的ID,请勿直接传递在当乐配置的支付回调地址服务器ID,若游戏确实没有区服的概念,传递字符串1;


②游戏服务器名称(zoneName):指用户创建角色所在服务器(区)的名称,通常是中文名称,若游戏确实没有区服的概念,传递字符串001;


③游戏角色ID(roleId):指用户在游戏中创建的角色对应的ID,请勿直接传递当乐回调的用户唯一标识(UMID),若游戏没有角色ID,传递字符1;


④游戏角色名称(roleName):指用户在游戏中创建的角色名称,请勿直接传递当乐用户名或昵称,若游戏没有角色概念,传递字符001。


更多参数请查看下表:


二、支付回调及返回值


1、在4.3.5以上版本SDK中,当乐支付回调中新增了CP订单号(cpOrder)字段。



2、请在收到当乐回调通知时,务必校验支付回调中传递的如下两项内容:


 ①订单实付金额(支付回调中传递的money字段):必须与实际发放的商品道具价格一致


 ②当乐umid(支付回调中传递的umid字段):必须与实际发放角色在CP方用户数据库中对应的当乐umid保持一致


注意,一旦有任意一项校验不通过,请勿发货,并返回失败


3、支付回调如果需要兼容新老版本,请通过CP订单号(cpOrder)字段是否存在区分新老版本。



三、新增服务端下单方式


服务端下单能有效防止客户端数据被篡改的情况,推荐有条件的CP采用该方式接入;



四、新增角色信息上报扩展接口


为方便对合作游戏进行深度运营,从SDK4.3.4开始,要求CP按文档要求上报游戏的角色信息


角色上报节点:角色创建成功、角色名称变更、进入服务器、角色等级升级


特别强调:①时间戳必须以毫秒为单位,即数据格式为13位的长整型,否则无法上报成功;②创建角色时的等级变化时间段取角色创建时间即可。


由于新版接口参数和接入方式均发生了比较大的变化,请在接入前仔细阅读客户端和服务端开发文档。