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位的长整型，否则无法上报成功；②创建角色时的等级变化时间段取角色创建时间即可。

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