【iOSappstoresdk文档更新】pod集成，广告，种花

iossdk_appstore对接说明文档_含广告分享.md

-## ZYouSDK V1.0.0文档接入使用
+## ZYouSDK V1.0.0文档接入使用
@@ -83,9 +83,12 @@
 
    3.1、从平台处获取对接SDK
 
+   3.2、pod集成
+     将Demo中的Podfile复制到项目根目录，将target改为实际项目target，执行pod install --repo-update，后续打开项目找.xcworkspace
+
    3.2、手动集成
 
-     将ZYouSDKFramework文件夹直接添加进工程，ZYouSDKFramework 文件夹中包含ZYouSDK,ZYSDKConfig,ZYouBundle三个文件 
+     打开项目后，将ZYouSDKFramework文件夹直接添加进工程，ZYouSDKFramework 文件夹中包含ZYouSDK,ZYSDKConfig,ZYouBundle三个文件，及QQ分享的SDK：TencentOpenAPI.framework 
 
    3.3、添加依赖 TARGETS -> Build Phases -> Link Binary With Libraries 下添加
 ```
@@ -132,12 +135,17 @@
    在TARGETS - Signing & Capabilities 下添加In-App Purchase
 
    3.8、Xcode开启https请求
+
    在 Info.plist 中添加 NSAppTransportSecurity 类型 Dictionary
+
    在 NSAppTransportSecurity 下添加 NSAllowsArbitraryLoads 类型 Boolean ,值设为 YES
 
    3.9、Xcode添加白名单
+
    在 Info.plist 中添加 LSApplicationQueriesSchemes 类型 Array
-   在LSApplicationQueriesSchemes下添加以下白名单
+
+   在LSApplicationQueriesSchemes下添加以下白名单。具体参考demo，可从demo中复制过来
+
    需要注意的是 目前苹果最多支持50个 超过的部分可能会不起作用
 
 ```
@@ -168,6 +176,8 @@ snssdk1128
 ```
 ![example2.png](https://zhangsheng-1300623068.cos.ap-guangzhou.myqcloud.com/example2.png)
 
+   在 Info.plist 中添加 SKAdNetworkItems，具体参考demo，可从demo中复制过来
+
    3.10、在Build Settings - Other Linker Flags里面加入
 ```
 -ObjC
@@ -649,6 +659,154 @@ payNotify();
 }];
 ```
 
+## 12、广告<a name="sec11"></a>
+### 广告初始化
+```
+/*
+ 初始化广告
+ takuAppID
+ takuAppKey
+*/
+- (void)zy_ad_initWithTakuAppID:(NSString *)takuAppID takuAppKey:(NSString *)takuAppKey;
+```
+
+### 调用示例<a name="sec11.2"></a>
+
+```
+ // 研发在广告初始化时调用，可放在游戏加载完成后
+        [[ZYouManager shareInstance] zy_ad_initWithTakuAppID:@"a6911ace71f10b" takuAppKey:@"a82c177f8a35d09d453487ed9b9980b24"];
+```
+### 预加载广告
+```
+/*
+ 预加载广告
+ placementID 广告位ID
+ scene 场景ID
+ extra 额外参数
+ loadBlock(placementID, blockType, loadState, data, error) 回调处理
+ // 广告的基础代理回调声明，包括广告位与广告源级别的加载成功或失败回调，以及竞价广告源的竞价结束与竞价失败回调
+ // 一个广告位可以配置多个广告源，因此单次加载操作（load）时，可能会收到多次广告源（ADSource）回调
+ // 所有广告源加载结束最后也会收到回调，下面用类型区分，下面是回调的参数说明
+ - placementID 广告位ID
+ - blockType 回调类型
+ -- 1 所有广告源加载结束事件回调
+ -- 2 加载结束后获取展示收益，可用于接收获取信息
+ -- 3 广告位中某一个广告源加载广告的回调
+ -- 4 广告位中某一个广告源竞价广告的回调
+ - loadState 加载回调状态
+ -- 1 开始加载
+ -- 2 加载成功
+ -- 3 加载失败
+ - data 额外信息字典，无额外信息返回nil
+ - error 错误信息，无错误返回nil
+*/
+- (void)zy_adType:(NSString *)adType preLoadAdWithPlacementID:(NSString *)placementID scene:(NSString *)scene extra:(NSDictionary *)extra loadBlock:(void(^)(NSString *placementID, NSString *blockType, NSString *loadState, NSDictionary *data, NSString *error))loadBlock;
+```
+
+### 调用示例<a name="sec11.2"></a>
+
+```
+// 广告加载，研发调用，第一次广告加载可放在游戏初始化完成后，第二次加载可放在第一次广告显示之后，依次类推
+        // 加载完成会全部回调，研发若需要回调，一般只需要用加载完成回调，也可不处理回调
+        NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];
+        // 可选接入，以下几个key参数适用于广告平台的服务端激励验证，将被透传
+        [loadConfigDict setValue:@"media_val_RewardedVC" forKey:@"media_val_RewardedVC"];
+        [loadConfigDict setValue:@"rv_test_user_id" forKey:@"rv_test_user_id"];
+        [loadConfigDict setValue:@"reward_Name" forKey:@"reward_Name"];
+        [loadConfigDict setValue:@3 forKey:@"reward_Amount"];
+        __weak typeof(self) weakSelf = self;
+        [[ZYouManager shareInstance] zy_adType:@"reward" preLoadAdWithPlacementID:@"b6911ad1b628fa" scene:@"" extra:loadConfigDict loadBlock:^(NSString * _Nonnull placementID, NSString * _Nonnull blockType, NSString * _Nonnull loadState, NSDictionary *  _Nonnull data, NSString * _Nonnull error) {
+            [weakSelf loadBlock:placementID :blockType :loadState :data :error];
+        }];
+```
+&nbsp;&nbsp; 广告加载回调处理见demo的loadBlock:
+
+### 展示广告
+```
+/*
+ 展示广告
+ placementID 广告位ID
+ scene 场景ID
+ showBlock(placementID, scene, blockType, showState, data, error) 回调处理
+ //下面是回调的参数说明
+ - placementID 广告位ID
+ - scene 场景ID
+ - blockType 回调类型
+ -- 1 激励广告视频播放回调
+ -- 2 激励视频再看一个相关回调
+ - showState 显示回调状态
+ -- 1 开始播放
+ -- 2 播放完毕
+ -- 3 播放失败
+ -- 4 已点击
+ -- 5 激励成功
+ -- 6 已关闭
+ -- 7 已打开或跳转深链接页面
+ - data 额外信息字典，无额外信息返回nil
+ - error 错误信息，无错误返回nil
+ - result 结果补充 只有激励广告已关闭和打开跳转深链接页面时才返回，其他情况为nil
+ 返回激励广告已关闭时，已经激励成功result为1，否则为2
+ 返回激励广告打开跳转深链接页面时，打开或跳转成功result为1，否则为2
+*/
+- (void)zy_adType:(NSString *)adType showAdWithPlacementID:(NSString *)placementID scene:(NSString *)scene showBlock:(void(^)(NSString *placementID, NSString *scene, NSString *blockType, NSString *showState, NSDictionary *data, NSString *error, NSString *result))showBlock;
+```
+
+### 调用示例<a name="sec11.2"></a>
+
+```
+// 广告显示，在研发需要进行广告显示的按钮或图标点击事件中调用
+        // 所有回调都会透传出来，研发按需取用，一般只需要拿激励广告激励成功的回调
+        __weak typeof(self) weakSelf = self;
+        [[ZYouManager shareInstance] zy_adType:@"reward" showAdWithPlacementID:@"b6911ad1b628fa" scene:@"" showBlock:^(NSString * _Nonnull placementID, NSString * _Nonnull scene, NSString * _Nonnull blockType, NSString * _Nonnull showState, NSDictionary *  _Nonnull data, NSString * _Nonnull error, NSString * _Nonnull result) {
+            [weakSelf showBlock:placementID :scene :blockType :showState :data :error :result];
+        }];
+```
+&nbsp;&nbsp; 广告显示回调处理见demo的showBlock:
+
+## 13、透传功能<a name="sec11"></a>
+### 透传触发事件
+```
+/*
+ 研发透传触发事件扩展
+ event 事件类型
+ data为NSDictionary 参数以key-value格式添加到data
+ finishBlock 事件完成回调
+ */
+- (void)zy_openSdkEvent:(NSString *)event data:(NSDictionary *)data finishBlock:(void(^)(void))finishBlock;
+```
+
+### 调用示例<a name="sec11.2"></a>
+
+&nbsp;&nbsp; 获取种花链接
+
+```
+ NSDictionary *data = @{
+                        @"prop_id": @"123456"//道具id
+                    };
+                    [[ZYouManager shareInstance] zy_openSdkEvent:@"flower_jump" data:data finishBlock:^{
+                        
+                    }];
+```
+### 调用示例<a name="sec11.2"></a>
+
+&nbsp;&nbsp; 上报种花道具
+
+```
+ NSTimeInterval timestamp = [NSDate date].timeIntervalSince1970;
+        NSString *cp_role_id = @"123456";
+        NSString *role_name = @"role_name";
+        NSDictionary *data = @{
+            @"cp_role_id": cp_role_id,//cp角色id
+            @"role_name": role_name,//角色名称
+            @"expire_time": @(timestamp) ?: @0,//过期时间 秒级时间戳
+            @"prop_id": @"123456"//道具id
+        };
+        [[ZYouManager shareInstance] zy_openSdkEvent:@"flower_report" data:data finishBlock:^{
+            [self toastView:@"上报成功"];
+        }];
+```
+
+
 ## 服务端接口   调用方直接使用http 调用接口：
 
 ### 接口地址