合并分支 'release' 到 'master'

道具日志接入

查看合并请求 zwwl/zw_game_sdk!237

iOSSDK对接说明文档.md

-## ZYouSDK V1.0.0文档接入使用
+## ZYouSDK V1.0.0文档接入使用
@@ -99,19 +99,19 @@
      将ZYouSDKFramework文件夹直接添加进工程，ZYouSDKFramework文件夹中包含ZYouSDK,ZYSDKConfig,ZYouBundle,alipay四个文件
 ![ios1.png](https://zhangsheng-1300623068.cos.ap-guangzhou.myqcloud.com/ios1.png)   
 
-   2.3 ZYSDKConfig配置文件中 game_id为平台方提供, zyscheme 为zy+game_id+sdk.zwnet.cn 的拼写 其他配置参数请勿修改  
+   2.2.1 ZYSDKConfig配置文件中 game_id为平台方提供, zyscheme 为zy+game_id+sdk.zwnet.cn 的拼写 其他配置参数请勿修改  
 
-   2.4 点击项目名称，点击 Info 选项卡，在 URL Types 选项中，点击 +，在 URL Schemes 中输入 ZYSDKConfig文件中zyscheme的值   
+   2.2.2 点击项目名称，点击 Info 选项卡，在 URL Types 选项中，点击 +，在 URL Schemes 中输入 ZYSDKConfig文件中zyscheme的值 
 
-   2.5 在 Build Phases 选项卡的 Link Binary With Libraries 中，增加以下依赖：  
+   2.2.3 点击项目名称，点击 Info 选项卡，添加key值Privacy - Tracking Usage Description，value为为了给您提供更精准的游戏推荐，我们需要获取您的广告权限。
+如下图：
+![example3.png](https://zyouapk.zwnet.cn/zhangsheng/production/ios/img/N6Mj3wHsMpTaEXTh1762912222794.png) 
 
-![ios5.png](https://zhangsheng-1300623068.cos.ap-guangzhou.myqcloud.com/ios5.png)   
-
-   2.6、Xcode开启https请求
+   2.2.4 Xcode开启https请求
    在 Info.plist 中添加 NSAppTransportSecurity 类型 Dictionary
    在 NSAppTransportSecurity 下添加 NSAllowsArbitraryLoads 类型 Boolean ,值设为 YES
 
-   2.7、Xcode添加白名单
+   2.2.5 Xcode添加白名单
    在 Info.plist 中添加 LSApplicationQueriesSchemes 类型 Array
    在LSApplicationQueriesSchemes下添加以下白名单
 ```
@@ -123,13 +123,15 @@ alipay
 ```
 ![example2.png](https://zhangsheng-1300623068.cos.ap-guangzhou.myqcloud.com/example2.png)
 
+   2.2.6 在 Build Phases 选项卡的 Link Binary With Libraries 中，增加以下依赖，其中AppTrackingTransparency.framework，AdSupport.framework为新增：
 
+![ios5.png](https://zyouapk.zwnet.cn/zhangsheng/production/ios/img/2HsYM8ZJXDSABFPd1762912675140.png)  
 
-   2.8、在Build Settings - Other Linker Flags里面加入-ObjC参数
+   2.2.7 在Build Settings - Other Linker Flags里面加入-ObjC参数
 
 ![example3.png](https://zhangsheng-1300623068.cos.ap-guangzhou.myqcloud.com/example3.png)
 
-   2.9、添加Associated Domains（需要更新bundle identifier支持）
+   2.2.8 添加Associated Domains（需要更新bundle identifier支持）
 
 在 Signing & Capabilities 中打开 +Capability ，然后选择 Associated Domains
 得到如下设置，添加applinks:zmgameios.wozhangwan.com
@@ -529,6 +531,26 @@ payNotify();
 ```
 - 说明：此方法会监听sdk从个人中心退出 如游戏需要退出可以在此回调方法中操作
 
+### 10、页签入口<a name="sec9"></a>
+
+```
+/*
+ 研发页签触发事件
+ event 事件类型
+ 目前只有跳转掌喵一种，传@"zmiao"
+ 后续有其他页签可通过此参数扩展
+ */
+- (void)zy_openSdkEvent:(NSString *)event;
+
+```
+
+#### 调用示例<a name="sec9.1"></a>
+
+```
+[[ZYouManager shareInstance] zy_openSdkEvent:@"zmiao"];
+```
+- 说明：这里是研发游戏内图标或其他入口点击触发的事件。研发只需点击后触发这个方法，后续逻辑由掌游sdk实现。目前只有一个页签，写死为zmiao，后续有其他需求可扩展传规定的字符串即可。
+
 
 
 ## 服务端接口   调用方直接使用http 调用接口：

道具日志接口.md

+v1.0
+v1.0
+
+## 道具日志接口
+
+接受道具日志数据
+
+### 请求方式
+
+1. POST 数据结构 JSON
+
+2. Header数据需要加验证参数 Authorization
+
+3. Authorization 将请求数据，
+   a. 按照key ascll 码小到大排序,   
+   b.拼接参数 string =    "key1=value1&key2=value2" + secert;
+   c. 将string 转为32 位的md5数据， stringMd5 = string.md5();  
+   d. 截取stringMd5 第二位到第17位， 一共 16位字符串, 之后转为大写， 为Authorization
+
+#### 1. 道具日志接口
+
+https://zyouapi.wozhangwan.com/server/prop/reportLog
+请求数据
+
+| 字段                  | 是否必传 | 字段类型     |                          |      |
+|---------------------|------|----------|--------------------------|------|
+| zw_app_id           | 是    | String   | app_id                   |      |
+| cp_account          | 是    | String   | 用户ID                     |      |
+| cp_role_id          | 是    | String   | 角色ID                     |      |
+| role_name           | 否    | String   | 角色名称                     |      |
+| server_id           | 否    | String   | 区服ID                     |      |
+| server_name         | 否    | String   | 区服名称                     |      |
+| recharge_total      | 否    | Int      | 累计充值(单位：分)               |      |
+| week_recharge_total | 否    | Int      | 周充值(单位：分)                |      |
+| prop_id             | 否    | String   | 道具id                     |      |
+| prop_name           | 否    | String   | 道具名                      |      |
+| special_prop_name   | 否    | String   | 特殊道具名                    |      |
+| amount              | 否    | Int      | 收入支出金额(单位：分)             |      |
+| prop_num            | 否    | String   | 道具数量                     |      |
+| prop_remain_num     | 否    | Int      | 道具剩余数量                   |      |
+| source              | 否    | String   | 来源                       |      |
+| action_time         | 否    | dateTime | 发生时间 2024-05-08 15:00:00 |      |
+|
+
+返回数据
+
+|             | 是否必要 | 字段类型   |              |
+|-------------|------|--------|--------------|
+| status_code | 是    | int    | 1 成功  2 失败   |
+| msg         | 是    | string | 返回信息  ： 处理成功 |
+
+