Merge branch 'ios_zlj' of http://git.wozhangwan.com/zwwl/zw_game_sdk into release

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

-## ZYouSDK V1.0.0文档接入使用
+## ZYouSDK V1.0.0文档接入使用
@@ -705,6 +705,7 @@ payNotify();
 ```
 ### 12.2 全自动加载所有激励广告
 ```
+/// 全自动加载所有激励广告
 - (void)autoLoadAllRewardedAd;
 ```
 ### 调用示例<a name="sec11.2"></a>
@@ -716,40 +717,55 @@ payNotify();
 ```
 /// 全自动加载多组场景的激励广告
 /// - Parameters:
-///   - RewardedSceneIDs: 场景ID组
-- (void)autoLoadRewardedAdRewardedSceneIDs:(NSArray *)RewardedSceneIDs;
+///   - sceneIDs: 场景ID组
+- (void)autoLoadRewardedAdSceneIDs:(NSArray *)sceneIDs;
 ```
 ### 调用示例<a name="sec11.2"></a>
 ```
  // 广告全自动加载多组场景，研发调用
-[[ZYouManager shareInstance] autoLoadRewardedAdRewardedSceneIDs:@[@"b1s8", @"b1s9"]];
+[[ZYouManager shareInstance] autoLoadRewardedAdSceneIDs:@[@"b1s8", @"b1s9"]];
 ```
-### 12.4 加载激励广告
+### 12.4 预加载激励广告
 ```
-/// 加载激励广告
+/// 预加载激励广告
 /// - Parameters:
-///   - RewardedPlacementID: 广告位ID
-///   - RewardedSceneID: 场景ID，可选，可在后台生成。没有可传入空字符串
-///   - extra: 额外信息字典，适用于广告平台的服务端激励验证，将被透传
-- (void)loadRewardedAd:(NSString *)RewardedPlacementID RewardedSceneID:(NSString *)RewardedSceneID extra:(NSDictionary *)extra;
+///   - sceneID: 场景ID
+- (void)loadRewardedAdSceneID:(NSString *)sceneID;
 ```
 ### 调用示例<a name="sec11.2"></a>
 ```
-// 广告加载，研发调用，第一次广告加载可放在游戏初始化完成后，第二次加载可放在第一次广告显示之后，依次类推
-[[ZYouManager shareInstance] loadRewardedAd:@"b1gumhqnlglb24" RewardedSceneID:@""  extra:loadConfigDict];
+// 广告预加载，研发调用
+[[ZYouManager shareInstance] loadRewardedAdSceneID:@"b1s8"];
 ```
 ### 12.5 显示激励广告
 ```
-- (void)showRewardedAd;
+/// 显示激励广告（无法展示时通过 didFailToShowADBlock 回调）
+/// - Parameters:
+///   - sceneID: 场景ID
+- (void)showRewardedAdSceneID:(NSString *)sceneID;
 ```
 ### 调用示例<a name="sec11.2"></a>
 ```
 // 广告显示，在研发需要进行广告显示的按钮或图标点击事件中调用
-[[ZYouManager shareInstance] showRewardedAd];
+[[ZYouManager shareInstance] showRewardedAdSceneID:@"b1s8"];
 ```
 
+说明：
+
+a)在游戏启动后全自动加载，如果已经加载所有场景，后面无需再手动预加载
+
+b)手动预加载目前为可选接入，游戏中需要单独加载某个场景广告，提前预加载传入场景id即可
+
+c)广告显示目前只有一种方法，传入需要显示的场景id即可
+
 ### 12.6 激励广告回调
 ```
+/// 全自动加载失败
+/// - Parameters:
+///   - error: 错误信息
+- (void)didFailToAutoLoadADBlock:(void(^)(NSError *error))block;
+```
+```
 /// 广告位加载完成
 /// - Parameter placementID: 广告位ID
 - (void)didFinishLoadingADBlock:(void(^)(NSString *placementID))block;
@@ -762,6 +778,13 @@ payNotify();
 - (void)didFailToLoadADBlock:(void(^)(NSString *placementID, NSError *error))block;
 ```
 ```
+/// 广告位显示失败（sceneID 无效、无广告位、未就绪等）
+/// - Parameters:
+///   - placementID: 广告位ID
+///   - error: 错误信息
+- (void)didFailToShowADBlock:(void(^)(NSString *placementID, NSError *error))block;
+```
+```
 /// 获得展示收益
 /// - Parameters:
 ///   - placementID: 广告位ID
@@ -858,6 +881,16 @@ payNotify();
 ```
 
 ### 调用示例<a name="sec11.2"></a>
+下面的toastView为Demo展示，实际项目根据自身需求处理
+
+```
+/// 全自动加载失败
+/// - Parameter error: 错误信息
+[[ZYouManager shareInstance] didFailToAutoLoadADBlock:^(NSError * _Nonnull error) {
+    NSString *msg = [NSString stringWithFormat:@"广告全自动加载失败,%@", error];
+    [self toastView:msg];
+}];
+```
 
 ```
 /// 广告位加载完成
@@ -878,6 +911,16 @@ payNotify();
 }];
 ```
 ```
+/// 广告位显示失败（sceneID 无效、无广告位、未就绪等）
+/// - Parameters:
+///   - placementID: 广告位ID
+///   - error: 错误信息
+[[ZYouManager shareInstance] didFailToShowADBlock:^(NSString * _Nonnull placementID, NSError * _Nonnull error) {
+    NSString *msg = [NSString stringWithFormat:@"广告展示失败%@ %@", placementID.length ? placementID : @"", error.localizedDescription];
+    [self toastView:msg];
+}];
+```
+```
 /// 获得展示收益
 /// - Parameters:
 ///   - placementID: 广告位ID
@@ -1062,6 +1105,13 @@ payNotify();
 ```
  [[ZYouManager shareInstance] zy_openSdkEvent:@"serviceCenterUrl"];
 ```
+### 调用示例<a name="sec11.2"></a>
+
+&nbsp;&nbsp; 活动站跳转
+
+```
+ [[ZYouManager shareInstance] zy_openSdkEvent:@"activityStationUrl"];
+```
 
 ## 服务端接口   调用方直接使用http 调用接口：