Skip to content

GitLab

iOS 升级文档SDK开发指南 · Changes

Page history
3.19.0 更新 authored by lic's avatar lic
Hide whitespace changes
Inline Side-by-side
Showing with 168 additions and 0 deletions
iOS-升级文档SDK开发指南.md
View page @ 311910dc
...@@ -435,6 +435,154 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文 ...@@ -435,6 +435,154 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文
## 3.19.0
发布日期：2022.10.28
1.直播支持重载文档翻页功能
2.优化直播、在线回放文档状态回调
3.修复优化其它已知问题
### ‼️ 本地集成 ‘必须’ 的准备 : 替换 CCBundle 资源文件，替换 HDBaseUtils 库，替换 CCSDK 库
| 文件名称 | 路径 |
| ----------- | ------------------------------------------------------------ |
| CCBundle | 压缩包 --> SDK 文件夹 --> Live_iOS_Play_SDK 文件夹 --> 选择 CCBundle.bundle 资源文件进行替换 |
| HDBaseUtils | 压缩包 --> SDK 文件夹 --> HDBaseUtils 文件夹 --> 选择 HDBaseUtils.framework 库文件进行替换 |
| CCSDK | 压缩包 --> SDK 文件夹 --> Live_iOS_Play_SDK 文件夹 --> 选择 CCSDK.framework 库文件进行替换 |
### 直播 RequestData.h
#### API变更：文档加载状态
| 方法 | 说明 |
| ------------------------------- | ------------ |
| (void)docLoadCompleteWithIndex: | 文档加载状态 |
示例代码
```objc
/**
* @brief 文档加载状态
* index
* 0 文档组件加载成功
* 1 动态文档翻页成功
* 2 非动画文档(白板 图片)文档翻页完成
* 3 文档组件加载失败
* 4 静态文档翻页失败
* 5 动态文档翻页失败
* 6 画板翻页失败
* 7 极速动画翻页加载成功
* 8 极速动画翻页加载失败
* 9 文档组件重载失败
* 10 静态文档翻页超时
* 11 动态文档动画执行成功
* 12 动态文档动画执行超时
* 13 动态文档加载成功
* 14 动态文档加载失败
*/
- (void)docLoadCompleteWithIndex:(NSInteger)index;
```
#### 文档状态说明及操作
| 参数 | 说明 | 操作 |
| ---- | ------------------------------------------------------------ | -------- |
| 0 | 文档组件加载成功 | 无 |
| 1 | 动态文档翻页成功 | 无 |
| 2 | 非动画文档(白板 图片)文档翻页完成 | 无 |
| 3 | 文档组件加载失败（SDK内部已做重试逻辑，但仍失败需要退出重新进入房间） | 退出重进 |
| 4 | 静态文档翻页失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 5 | 动态文档翻页失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 6 | 画板翻页失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 7 | 极速动画翻页加载成功 | 无 |
| 8 | 极速动画翻页加载失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 9 | 文档组件重载失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 10 | 静态文档翻页超时（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 11 | 动态文档动画执行成功 | 无 |
| 12 | 动态文档动画执行超时（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 13 | 动态文档加载成功 | 无 |
| 14 | 动态文档加载失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
### 新增API：重载翻页
| 方法 | 说明 |
| ----------------------- | -------- |
| (void)reloadPageChange: | 重载翻页 |
示例代码
```objc
/// 重载翻页
/// @param closure 操作回调
- (void)reloadPageChange:(void (^)(BOOL result, NSString *message))closure {
if (result == NO) {
// 重载翻页操作失败，错误信息 message
}
}
```
### 在线回放 RequestDataPlayBack.h
#### API变更：文档加载状态
| 方法 | 说明 |
| ------------------------------- | ------------ |
| (void)docLoadCompleteWithIndex: | 文档加载状态 |
示例代码
```objc
/**
* @brief 文档加载状态
* index
* 0 文档组件加载成功
* 1 动态文档翻页成功
* 2 非动画文档(白板 图片)文档翻页完成
* 3 文档组件加载失败
* 4 静态文档翻页失败
* 5 动态文档翻页失败
* 6 画板翻页失败
* 7 极速动画翻页加载成功
* 8 极速动画翻页加载失败
* 9 文档组件重载失败
* 10 静态文档翻页超时
* 11 动态文档动画执行成功
* 12 动态文档动画执行超时
* 13 动态文档加载成功
* 14 动态文档加载失败
*/
- (void)docLoadCompleteWithIndex:(NSInteger)index;
```
#### 文档状态说明及操作
| 参数 | 说明 | 操作 |
| ---- | ------------------------------------------------------------ | -------- |
| 0 | 文档组件加载成功 | 无 |
| 1 | 动态文档翻页成功 | 无 |
| 2 | 非动画文档(白板 图片)文档翻页完成 | 无 |
| 3 | 文档组件加载失败（SDK内部已做重试逻辑，但仍失败需要退出重新进入房间） | 退出重进 |
| 4 | 静态文档翻页失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 5 | 动态文档翻页失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 6 | 画板翻页失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 7 | 极速动画翻页加载成功 | 无 |
| 8 | 极速动画翻页加载失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 9 | 文档组件重载失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 10 | 静态文档翻页超时（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 11 | 动态文档动画执行成功 | 无 |
| 12 | 动态文档动画执行超时（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
| 13 | 动态文档加载成功 | 无 |
| 14 | 动态文档加载失败（展示文档刷新按钮，用户可手动出发文档重载） | 重载翻页 |
## 3.18.1 ## 3.18.1
发布日期：2021.12.17 发布日期：2021.12.17
...@@ -464,6 +612,26 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文 ...@@ -464,6 +612,26 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文
4.优化推流异常播放展示效果 4.优化推流异常播放展示效果
## 3.17.13
发布日期：2022.10.11
1.新增隐私协议说明
2.iOS16系统功能及UI适配
3.修复直播，在线回放中断后继续播放问题
## 3.17.12
发布日期：2022.08.08
1.优化低性能设备播放加密回放问题
## 3.17.11 ## 3.17.11
发布日期：2022.07.22 发布日期：2022.07.22
......