iOS-升级文档SDK开发指南.md

@@ -449,6 +449,120 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文
 
 4.优化推流异常播放展示效果
 
+
+## 3.17.11
+
+发布日期：2022.07.22
+
+1.新增直播DP预加载功能
+2.新增在线回放DP预加载功能
+3.新增在线回放文档翻页数据获取异常消息通知
+4.新增在线回放文档支持重载文档翻页数据功能
+5.新增在线回放文档支持翻页失败时刷新翻页功能
+6.新增在线回放支持选择不同的播放器核心
+7.修复已知问题
+
+### 注意事项
+
+#### <font color = red>**1.本地集成时必须替换最新的 CCBundle 文件** </font>
+
+#### <font color = red> **2.本地集成时必须替换最新的 HDBaseUtils.framework ** </font>
+
+#### <font color = red> **3.Cocoapods 集成必须更新最新的 HDBaseUtils （1.1.7） ** </font>
+
+
+
+### 新增API
+
+#### RequestDataPlayBack.h 文件新增
+
+##### 1.翻页数据获取异常消息通知（代理方法）
+
+| 方法                  | 说明                                                       |
+| --------------------- | ---------------------------------------------------------- |
+| (void)onPageDataError | 翻页数据获取失败，请使用 "-(void)reloadPageData;" 重新获取 |
+
+示例代码
+
+```objc
+/// 翻页数据获取失败，请使用 "-(void)reloadPageData;" 重新获取
+- (void)onPageDataError;
+```
+
+##### 2.重载翻页数据（主动方法）
+
+| 方法                 | 说明         |
+| -------------------- | ------------ |
+| (void)reloadPageData | 重载翻页数据 |
+
+示例代码
+
+```objc
+/// 重载翻页数据
+- (void)reloadPageData;
+```
+
+##### 3.文档支持翻页失败时刷新翻页（主动方法）
+
+| 方法                   | 说明     |
+| ---------------------- | -------- |
+| (void)reloadPageChange | 重载翻页 |
+
+示例代码
+
+```objc
+/**
+ *    @brief    文档加载状态
+ *    index
+ *      0 文档组件初始化完成
+ *      1 动画文档加载完成
+ *      2 非动画翻页加载成功
+ *      3 文档组件加载失败
+ *      4 非动画翻页加载失败
+ *      5 文档动画加载失败
+ *      6 画板加载失败
+ *      7 极速动画翻页加载成功
+ *      8 极速动画翻页加载失败
+ *      9 文档组件重载失败
+ */
+- (void)docLoadCompleteWithIndex:(NSInteger)index {
+   	if (index == 4 || index == 5) {
+      	// 翻页失败，可在收到此消息后 调用 - (void)reloadPageChange;
+    }
+}
+
+/// 重载翻页
+- (void)reloadPageChange;
+```
+
+
+
+#### PlayParameter.h 文件新增
+
+##### 1. 新增设置播放器属性
+
+| 方法             | 说明                                              |
+| ---------------- | ------------------------------------------------- |
+| playbackCoreType | 在线回放播放核心（默认：PlaybackCoreTypeDefualt） |
+
+示例代码
+
+```objc
+/// 在线回放播放器核心
+typedef NS_ENUM(NSUInteger, PlaybackCoreType) {
+    ///使用HDSMedia播放器（默认）
+    PlaybackCoreTypeDefualt,
+    ///使用系统AVPlayer播放器
+    PlaybackCoreTypeOrigin,
+};
+
+/// 在线回放播放核心（默认：PlaybackCoreTypeDefualt）
+@property (nonatomic, assign) PlaybackCoreType playbackCoreType;
+```
+
+
+
+
 ## 3.17.10
 
 发布日期：2022.06.23