合并分支 'patch-2' 到 'Android'

Patch 2

查看合并请求 zwwl/zw_game_sdk!22

AndroidSDK对接说明文档.md

-## GameSDKV1.0文档接入使用
+## GameSDKV1.0文档接入使用
@@ -251,7 +251,6 @@ void loginSuccess(Object data);
 |       data |   object |   用户数据       |
 |       player_id |   String |   玩家ID   |
 |       avatar |   String |   用户头像   |
-|       mobile |   String |   手机号   |
 |       has_identify |   boolean |   是否实名   |
 |       user_token |   strng |   token   |
 
@@ -373,22 +372,22 @@ public void showPay(CustomPayParam payParam, OnPaymentListener paymentListener)
 
 | 名称            |     类型 | 是否必须 |  说明 |
 |:--------------|-------:|-----:|-----------------:|
-| cp_order_id   | string |  非必须 | CP订单ID  |
-| amount        | number |  非必须 | 商品总价（单位：分 |
-| product_price | number |  非必须 | 商品价格(整数，后台自动换算分) |
-| product_id    | String |  非必须 | 商品ID  |
-| product_cnt   | number |  非必须 | 商品数量 |
-| product_name  | string |  非必须 | 商品名称 |
-| product_desc  | string |  非必须 | 商品描述 |
-| ext           | string |  非必须 | 订 单额外信息用（json）|
-| event         | string |  非必须 | 事件|
-| server_id     | string |  非必须 | 区服id |
-| server_name   | string |  非必须 | 区服名称|
-| cp_role_id    | string |  非必须 | cp角色id |
-| role_name     | string |  非必须 | 角色名称 |
-| role_level    | string |  非必须 | 角色等级 |
-| role_vip      | string |  非必须 | 角色vip等级 |
-| role_id       | string |  非必须 | 角色ID   |
+| cp_order_id   | string |  必须 | CP订单ID  |
+| amount        | number |  必须 | 商品总价（单位：分 |
+| product_price | number | 必须 | 商品价格(整数，后台自动换算分) |
+| product_id    | String |  必须 | 商品ID  |
+| product_cnt   | number |  必须 | 商品数量 |
+| product_name  | string |  必须 | 商品名称 |
+| product_desc  | string |  必须 | 商品描述 |
+| ext           | string |  必须 | 订 单额外信息用（json）|
+| event         | string |  必须 | 事件|
+| server_id     | string |  必须 | 区服id |
+| server_name   | string |  必须 | 区服名称|
+| cp_role_id    | string |  必须 | cp角色id |
+| role_name     | string |  必须 | 角色名称 |
+| role_level    | string |  必须 | 角色等级 |
+| role_vip      | string |  必须 | 角色vip等级 |
+
 
 
 ### 8、支付回调通知<a name="sec8"></a>
@@ -442,22 +441,22 @@ public void showPay(CustomPayParam payParam, OnPaymentListener paymentListener)
 
 | 名称 | 类型 | 是否必须| 说明 |
 |:--------| -------------:| -------------------:|-------------:|
-| role{} | object | 非必须  | 角色信息 |
-| event | String | 非必须  | 事件类型，online: 角色登录, create: 创建角色,level_up: 提升等级,offline: 角色退出,other: 其他,delete: 删除角色 |
-| server_id | string | 非必须  | 区服ID |
-| server_name | string | 非必须  | 区服名称 |
-| cp_role_id |string | 非必须  | CP角色ID |
-| role_name | string | 非必须  | 角色名称 |
-| role_level | number | 非必须  | 角色等级 |
-| role_vip | number | 非必须  | 角色VIP等级 |
-| combat_num | number | 非必须  | 角色战力 |
-| online_time | number | 非必须  | 本次在线时长 |
-| cp_account | number | 非必须  | CP账户 |
-| attack | number | 非必须  | 攻击力 |
-| profession | string | 非必须  | 职业 |
-| game_name | string | 非必须  | 帮会(行会)名称 |
-| trans_level | string | 非必须  | 转生等级 |
-| sponsor_level | string | 非必须  | 赞助等级/会员等级 |
+| role{} | object | 必须  | 角色信息 |
+| event | String | 必须  | 事件类型，online: 角色登录, create: 创建角色,level_up: 提升等级,offline: 角色退出,other: 其他,delete: 删除角色 |
+| server_id | string | 必须  | 区服ID |
+| server_name | string | 必须  | 区服名称 |
+| cp_role_id |string | 必须  | CP角色ID |
+| role_name | string | 必须  | 角色名称 |
+| role_level | number | 必须  | 角色等级 |
+| role_vip | number | 必须  | 角色VIP等级 |
+| combat_num | number | 必须  | 角色战力 |
+| online_time | number | 必须  | 本次在线时长 |
+| cp_account | number | 必须  | CP账户 |
+| attack | number | 必须  | 攻击力 |
+| profession | string | 必须  | 职业 |
+| gang_name | string | 必须  | 帮会(行会)名称 |
+| trans_level | string | 必须  | 转生等级 |
+| sponsor_level | string | 必须  | 赞助等级/会员等级 |
 
 
 ### 10、退出登录<a name="sec9"></a>
@@ -555,3 +554,93 @@ public void exitApp(ExitAppListener listener)
 2、打包apk签名机制需要勾选V1、V2签名<a name="sec13.2"></a>
 
 3、sdk代码已经经过混淆，请不要再次混淆sdk代码，demo会贴出SDK混淆代码，可复制到自己混淆中(具体请参考demo)
+
+## 服务端接口   调用方直接使用http 调用接口：
+
+### 接口地址
+
+> 【POST】 /android_sdk/auth/checkLogin
+
+##### 请求参数
+
+> **Headers**:
+>
+> | 参数         | 必选 | 参数值           | 说明                                |
+> | ------------ | ---- | ---------------- | ----------------------------------- |
+> | Content-Type | true | application/json |                                     |
+> | User-Token   | true |                  | 登录后由 SDK 返回的user_token |
+
+> **Body**:
+>
+> | 参数      | 必选 | 类型   | 默认值 | 说明                               |
+> | --------- | ---- | ------ | ------ | ---------------------------------- |
+> | game_id   | true | Int    | -      | 游戏接入时分配的游戏ID             |
+> | player_id | true | Int    | -      | 小游戏登录后由 SDK 返回的player_id |
+> | sign      | true | String | -      | 参数签名                           |
+
+##### 返回参数
+
+> | 参数        | 必选  | 类型   | 默认值 | 说明           |
+> | ----------- | ----- | ------ | ------ | -------------- |
+> | status_code | true  | Int    | -      | 状态码   1 正常在线，否则不允许登录|
+> | msg         | true  | STRING | -      | 返回信息       |
+> | data        | false | OBJECT | []     | 返回数据（空） |
+>
+
+##### 接口说明
+  调用方检测当前用户是否登录过，在线状态； 如果返回参数不是正常登录则不允许登录游戏。
+
+##### 请求示例
+
+
+```php
+<php?
+  public function checkLogin(){
+     $host = 'https://zyou.wozhangwan.com/api';
+     $checkLoginUrl = '/android_sdk/auth/checkLogin';
+     $url = $host.$checkLoginUrl;
+     $gameSecret = "game_secret";
+     $body = ["player_id" => 1245, "game_id" => 14];
+     $userToken = "user_token";
+     $body["sign"] = makeSign($body, $gameSecret);
+     $headers = ["Content-Type:application/json","User-Token:".$userToken];
+     $response = curl_post($url, $body, $hearders);
+  }
+
+ public function makeSign($params,$gameSecret){
+        $signStr = '';
+        ksort($params, SORT_REGULAR);
+        foreach ($params as $key => $val) {
+            if (is_array($val)) {
+                ksort($val, SORT_REGULAR);
+                $val = json_encode($val, JSON_UNESCAPED_UNICODE);
+            }
+            $signStr .= $key . '=' . $val . '&';
+        }
+        $signStr .= 'game_secret=' . $gameSecret;
+        return md5($signStr);
+  }
+
+  public function curl_post($url, $body, $headers){
+  	//初始化
+     $curl  =  curl_init ( );
+     //设置抓取的url
+     curl_setopt ( $curl, CURLOPT_URL ,  $url);
+     //设置头文件的信息作为数据流输出
+     curl_setopt ( $curl, CURLOPT_HEADER ,  1 );
+     //设置获取的信息以文件流的形式返回，而不是直接输出。
+     curl_setopt ( $curl, CURLOPT_RETURNTRANSFER ,  1 );
+     //设置post方式提交
+     curl_setopt ( $curl, CURLOPT_POST ,  1 );
+     //设置post参数
+     curl_setopt ( $curl, CURLOPT_POSTFIELDS ,  json_encode($body) );
+     //设置请求头
+     curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); 
+     //执行命令
+     $data  =  curl_exec ( $curl );
+     //关闭URL请求
+     curl_close ( $curl );
+     //显示获得的数据
+     return json_decode($data, true);
+	}
+```
\ No newline at end of file

SDK对接说明.md

-# 游戏 SDK 对接文档-v1.0.3
+# 游戏 SDK 对接文档-v1.0.3
@@ -630,8 +630,8 @@ zwsdk.login(config:Object)
 > |         data         | Object | 用户数据 |
 > |                 player_id | String | 玩家 ID  |
 > |                 avatar | String | 头像     |
-> |                 mobile | String | 手机号   |
 > |                 has_identify | String | 是否实名 |
+> |                 user_token | String | TOKEN    |
 
 ##### 示例
 
@@ -939,13 +939,13 @@ zwsdk.updateRole(config:Object)
 > | role                                                        | true  | String  | -      | 角色信息                                                                                                                                                 |
 > |         event       | true  | String  | -      | 角色上传事件类型                                                                                                                                         |
 > |         server_id   | true  | String  | -      | 区服 ID                                                                                                                                                  |
-> |         server_name | true  | String  | -      | 区服名称 ID                                                                                                                                              |
+> |         server_name | true  | String  | -      | 区服名称                                                                                                                                              |
 > |         cp_role_id  | true  | String  | -      | CP 角色 ID                                                                                                                                               |
 > |         role_name   | true  | String  | -      | CP 角色名称|
-> |         role_level  | true  | String  | -      | 角色等级 ID                                                                                                                                              |
-> |         role_vip    | true  | String  | -      | 角色 VIP 等级 ID                                                                                                                                         |
-> |         combat_num  | true  | String  | -      | 角色战力 ID                                                                                                                                              |
-> |         online_time | true  | String  | -      | 本次在线时长 ID                                                                                                                                          |
+> |         role_level  | true  | String  | -      | 角色等级                                                                                                                                              |
+> |         role_vip    | true  | String  | -      | 角色 VIP 等级                                                                                                                                         |
+> |         combat_num  | true  | String  | -      | 角色战力                                                                                                                                             |
+> |         online_time | true  | String  | -      | 本次在线时长                                                                                                                                        |
 > |         attack       | false | Int    | 0     | 攻击力                                     |
 > |         profession   | false | String | -      | 职业                                       |
 > |         gang_name    | false | String | -      | 帮会(行会)名称                             |

服务端接口说明.md

-# 服务端接口说明-v1.0.1
+# 服务端接口说明-v1.0.1
@@ -172,10 +172,10 @@
 > **Body:**
 >
 > | 参数                                                         | 必选  | 类型   | 默认值 | 说明                                                       |
-> | :----------------------------------------------------------- | :---- | :----- | :----- | :----------------------------------------- |
-> | game_id                                                      | false | Int    | -      | 游戏的game_id   Android 环境必须给   2022-03-25 android 新增 |
+> | :----------------------------------------------------------- | :---- | :----- | :----- | :--------------------------------------------------------- |
+> | game_id                                                      | true  | Int    | -      | 游戏的game_id, 角色当前游戏ID                              |
 > | player_id                                                    | true  | Int    | -      | 游戏登录后由 SDK 返回的player_id                           |
-> | type                                                         | true  | Int    | 1      | 游戏角色操作环境，1：H5网页端，2：小游戏端 |
+> | type                                                         | true  | Int    | 1      | 游戏角色操作环境，1：H5网页端，2：小游戏端，3：Android游戏 |
 > | os                                                           | false | String | -      | 操作系统                                                   |
 > | role                                                         | true  | Object | -      | 角色信息                                                   |
 > |         combat_num   | false | String | 0      | 角色战力                                                   |
@@ -192,6 +192,7 @@
 > |         gang_name    | false | String | -      | 帮会(行会)名称                                             |
 > |         trans_level  | false | Int    | 0      | 转生等级                                                   |
 > |         sponsor_level | false | Int    | 0      | 赞助等级/会员等级                                          |
+> |         reiki_num | false | Int    | 0      | 角色灵符值                                          |
 > | sign                                                         | true  | String | -      | 签名                                                       |
 
 ##### 返回参数
@@ -223,8 +224,9 @@
      $checkLoginUrl = '/mini_sdk/role/severReport';
      $url = $host.$checkLoginUrl;
 		 $gameSecret = "game_secret";
-     $body = ["player_id" => 1245,//游戏登录后由 SDK 返回的player_id
-              "type" => 1,//游戏角色操作环境，1：H5网页端，2：小游戏端
+     $body = ["game_id"  => 121, //角色当前SDK方游戏ID
+              "player_id" => 1245,//游戏登录后由 SDK 返回的player_id
+              "type" => 1,//游戏角色操作环境，1：H5网页端，2：小游戏端，3：android游戏
               "os" => "windows"//游戏操作系统：windows,android,ios
               "role" =>[
                 "event" => 1,//角色事件类型