| ... | ... | @@ -12,20 +12,321 @@ PS. 关于Xcode12最低版本支持 iOS 9.0 ，如何联调 iOS 8.0 设备？ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 4.1.0
|
|
|
|
|
|
|
|
发布日期：2022.04.02
|
|
|
|
|
|
|
|
1.新增声网连麦网络状态回调
|
|
|
|
2.直播新增点赞功能
|
|
|
|
3.直播新增打赏功能
|
|
|
|
4.在线回放新增试看功能
|
|
|
|
5.离线回放支持动画
|
|
|
|
6.优化已知问题
|
|
|
|
|
|
|
|
PS：4.1.0 版本点赞，打赏功能详情见《云直播点赞功能接入文档》，《云直播打赏功能接入文档》
|
|
|
|
|
|
|
|
#### 直播 RequestData.h API
|
|
|
|
|
|
|
|
##### ----- 新增API -----
|
|
|
|
|
|
|
|
###### 互动组件功能配置（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 互动功能配置
|
|
|
|
/// @param configModel 配置信息
|
|
|
|
- (void)onInteractionFunctionConfig:(HDSInteractionFunctionModel *)configModel;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取互动组件Token（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 获取互动组件 token
|
|
|
|
/// @param closure 操作回调 (result 操作状态， message 信息)
|
|
|
|
/// @param tokenClosure token回调 " result == YES 时返回token, result == NO 时返回 @""(空字符串) "
|
|
|
|
- (void)getInteractionTokenWithClosure:(completeHandler)closure tokenClosure:(interactionTokenClosure)tokenClosure;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 推流质量回调（单人连麦）（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 推流质量回调 （单人连麦）
|
|
|
|
/// @param quality 流质量
|
|
|
|
- (void)onPushStreamQuality:(HDSStreamQuality)quality;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 拉流质量回调 （单人连麦）（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 拉流质量回调 （单人连麦）
|
|
|
|
/// @param quality 流质量
|
|
|
|
- (void)onPullStreamQuality:(NSString *)streamID quality:(HDSStreamQuality)quality;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##### ----- API变更 -----
|
|
|
|
|
|
|
|
###### 双击PPT （代理方法）（已废弃）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 双击ppt
|
|
|
|
*/
|
|
|
|
- (void)doubleCllickPPTView DEPRECATED_MSG_ATTRIBUTE("该方法已废弃");
|
|
|
|
```
|
|
|
|
|
|
|
|
PS：双击PPT API 状态变更为废弃，功能可用，但后期不再维护。
|
|
|
|
|
|
|
|
###### 视频状态改变（代理方法）(命名变更)
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 视频状态改变
|
|
|
|
* @param state
|
|
|
|
* HDSMediaPlaybackStateStopped 播放停止
|
|
|
|
* HDSMediaPlaybackStatePlaying 开始播放
|
|
|
|
* HDSMediaPlaybackStatePaused 暂停播放
|
|
|
|
* HDSMediaPlaybackStateInterrupted 播放间断
|
|
|
|
* HDSMediaPlaybackStateSeekingForward 播放快进
|
|
|
|
* update --> HDSMediaPlaybackStateSeekingBackward 播放后退
|
|
|
|
*/
|
|
|
|
- (void)HDSMediaPlayBackStateDidChange:(HDSMediaPlaybackState)state;
|
|
|
|
/// update --> :(HDSMediaPlaybackState)
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取流播放状态 （主动方法）（命名变更）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 获取流播放状态
|
|
|
|
- (HDSMediaPlaybackState)getMediaPlayStatus;
|
|
|
|
/// update --> (HDSMediaPlaybackState)
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### 在线回放 RequestDataPlayBack.h API
|
|
|
|
|
|
|
|
##### ----- 新增API -----
|
|
|
|
|
|
|
|
###### 试看功能（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 试看时长
|
|
|
|
/// @param trialDuration 时长 trialDuration >= 1 代表有 试看时长 < 1 表示没有试看时长
|
|
|
|
- (void)onTrialDuration:(NSTimeInterval)trialDuration;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##### ----- API变更 -----
|
|
|
|
|
|
|
|
###### 双击PPT （代理方法）（已废弃）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 双击ppt
|
|
|
|
*/
|
|
|
|
- (void)doubleCllickPPTView DEPRECATED_MSG_ATTRIBUTE("该方法已废弃");
|
|
|
|
```
|
|
|
|
|
|
|
|
PS：双击PPT API 状态变更为废弃，功能可用，但后期不再维护。
|
|
|
|
|
|
|
|
###### 视频状态改变（代理方法）(命名变更)
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 视频状态改变
|
|
|
|
* @param state
|
|
|
|
* HDSMediaPlaybackStateStopped 播放停止
|
|
|
|
* HDSMediaPlaybackStatePlaying 开始播放
|
|
|
|
* HDSMediaPlaybackStatePaused 暂停播放
|
|
|
|
* HDSMediaPlaybackStateInterrupted 播放间断
|
|
|
|
* HDSMediaPlaybackStateSeekingForward 播放快进
|
|
|
|
* update --> HDSMediaPlaybackStateSeekingBackward 播放后退
|
|
|
|
*/
|
|
|
|
- (void)HDSMediaPlayBackStateDidChange:(HDSMediaPlaybackState)state;
|
|
|
|
/// update --> :(HDSMediaPlaybackState)
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 视频播放完成原因 （代理方法）（命名变更）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 视频播放完成原因
|
|
|
|
* @param reason 原因
|
|
|
|
* HDSMediaFinishReasonPlaybackEnded 自然播放结束
|
|
|
|
* HDSMediaFinishReasonUserExited 用户人为结束
|
|
|
|
* update --> HDSMediaFinishReasonPlaybackError 发生错误崩溃结束
|
|
|
|
*/
|
|
|
|
- (void)HDSMediaPlayerPlaybackDidFinish:(HDSMediaFinishReason)reason;
|
|
|
|
|
|
|
|
/// update --> :(HDSMediaFinishReason)
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取流播放状态 （主动方法）（命名变更）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 获取流播放状态
|
|
|
|
- (HDSMediaPlaybackState)getMediaPlayStatus;
|
|
|
|
/// update --> (HDSMediaPlaybackState)
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### 离线回放 OfflinePlayBack.h API
|
|
|
|
|
|
|
|
##### ----- 新增API -----
|
|
|
|
|
|
|
|
###### 房间配置信息（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 房间配置信息
|
|
|
|
/// @param dic 配置信息
|
|
|
|
- (void)offline_roomConfiguration:(NSDictionary *)dic;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 媒体准备完成（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 媒体准备完成
|
|
|
|
*/
|
|
|
|
- (void)mediaPrepared;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 所有数据准备完成（代理方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 所有数据准备完成
|
|
|
|
*
|
|
|
|
* 数据准备完成后，才能主动获取全量数据
|
|
|
|
* 获取全量聊天数据：- (void)fetchAllChat:(void (^)(NSArray * results))completion;
|
|
|
|
* 获取全量问答数据：- (void)fetchAllQA:(void (^)(NSDictionary * results))completion;
|
|
|
|
* 获取全量广播数据：- (void)fetchAllBroadcast:(void (^)(NSArray * results))completion;
|
|
|
|
* 获取全量随堂测数据：- (void)fetchAllPractic:(void (^)(NSArray * results))completion;
|
|
|
|
* 获取全量翻页数据：- (void)fetchAllPageChange:(void (^)(NSArray *results))completion;
|
|
|
|
*/
|
|
|
|
- (void)dataPrepared;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取全量聊天数据（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 获取全量聊天数据
|
|
|
|
* @param completion 数据回调
|
|
|
|
*/
|
|
|
|
- (void)fetchAllChat:(void (^)(NSArray * results))completion;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取全量问答数据（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 获取全量问答数据
|
|
|
|
* @param completion 数据回调
|
|
|
|
*/
|
|
|
|
- (void)fetchAllQA:(void (^)(NSArray * results))completion;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取全量广播数据（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 获取全量广播数据
|
|
|
|
* @param completion 数据回调
|
|
|
|
*/
|
|
|
|
- (void)fetchAllBroadcast:(void (^)(NSArray * results))completion;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取全量随堂测数据（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 获取全量随堂测数据
|
|
|
|
* @param completion 数据回调
|
|
|
|
*/
|
|
|
|
- (void)fetchAllPractic:(void (^)(NSArray * results))completion;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取全量翻页数据（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 获取全量翻页数据
|
|
|
|
* @param completion 数据回调
|
|
|
|
*/
|
|
|
|
- (void)fetchAllPageChange:(void (^)(NSArray *results))completion;
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 校验文件MD5值（主动方法）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 校验文件MD5值
|
|
|
|
/// @param filePath 文件路径
|
|
|
|
/// @param MD5 源文件MD5值
|
|
|
|
/// @return YES 文件正常 / NO 文件已损坏
|
|
|
|
- (BOOL)HDSCheckFileMD5:(NSString *)filePath MD5:(NSString *)MD5;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##### ----- API变更 -----
|
|
|
|
|
|
|
|
###### 视频状态改变（代理方法）(命名变更)
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 视频状态改变
|
|
|
|
* @param state
|
|
|
|
* HDSMediaPlaybackStateStopped 播放停止
|
|
|
|
* HDSMediaPlaybackStatePlaying 开始播放
|
|
|
|
* HDSMediaPlaybackStatePaused 暂停播放
|
|
|
|
* HDSMediaPlaybackStateInterrupted 播放间断
|
|
|
|
* HDSMediaPlaybackStateSeekingForward 播放快进
|
|
|
|
* HDSMediaPlaybackStateSeekingBackward 播放后退
|
|
|
|
*/
|
|
|
|
- (void)HDSMediaPlayBackStateDidChange:(HDSMediaPlaybackState)state;
|
|
|
|
/// update --> :(HDSMediaPlaybackState)
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 视频播放完成原因 （代理方法）（命名变更）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 视频播放完成原因
|
|
|
|
* @param reason 原因
|
|
|
|
* HDSMediaFinishReasonPlaybackEnded 自然播放结束
|
|
|
|
* HDSMediaFinishReasonUserExited 用户人为结束
|
|
|
|
* HDSMediaFinishReasonPlaybackError 发生错误崩溃结束
|
|
|
|
*/
|
|
|
|
- (void)HDSMediaPlayerPlaybackDidFinish:(HDSMediaFinishReason)reason;
|
|
|
|
|
|
|
|
/// update --> :(HDSMediaFinishReason)
|
|
|
|
```
|
|
|
|
|
|
|
|
###### 获取流播放状态 （主动方法）（命名变更）
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 获取流播放状态
|
|
|
|
- (HDSMediaPlaybackState)getMediaPlayStatus;
|
|
|
|
/// update --> (HDSMediaPlaybackState)
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 4.0.0
|
|
|
|
|
|
|
|
发布日期：2022.01.19
|
|
|
|
|
|
|
|
1.直播、在线回放新增视频logo功能
|
|
|
|
|
|
|
|
2.新增红包雨功能
|
|
|
|
|
|
|
|
3.在线回放新增自定义字段
|
|
|
|
|
|
|
|
4.登录用户名称支持40字符
|
|
|
|
|
|
|
|
5.图片地址链接替换为HTTPS
|
|
|
|
|
|
|
|
6.修复以及优化已知问题
|
|
|
|
|
|
|
|
PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文档》
|
| ... | ... | @@ -37,12 +338,11 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文 |
|
|
|
发布日期：2021.12.17
|
|
|
|
|
|
|
|
1.修复单人连麦功能可能出现连麦失败的问题
|
|
|
|
|
|
|
|
2.修复播放器可能出现叠音问题
|
|
|
|
|
|
|
|
3.修复其他已知bug
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.18.0
|
|
|
|
|
|
|
|
发布日期：2021.11.03
|
| ... | ... | @@ -62,6 +362,123 @@ PS: 4.0.0 版本SDK更新详情见《云直播 iOS 观看端 4.0.0 SDK 升级文 |
|
|
|
4.优化推流异常播放展示效果
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.17.8
|
|
|
|
|
|
|
|
发布日期：2022.03.24
|
|
|
|
|
|
|
|
1.新增日志收集
|
|
|
|
|
|
|
|
#### <font color = red>注：日志收集功能为 **必选项** ，本地接入需要使用最新的 CCBundle 资源文件</font>
|
|
|
|
|
|
|
|
| 新增依赖库 | Cocoapods 接入 | 本地接入 | 签名选择 |
|
|
|
|
| ------------------------------------ | ------------------------ | --------------------------------------------------- | ------------ |
|
|
|
|
| CCFuncTool.framework （动态库） | pod 'HDSCCFuncTool' | 下载zip包中 CCFuncTool 文件夹下，拖入项目中 | Embed & Sign |
|
|
|
|
| SSZipArchive.framework （动态库） | pod 'HDSSZip' | 下载zip包中 CCFuncTool 文件夹下，拖入项目中 | Embed & Sign |
|
|
|
|
| CocoaLumberjack.framework （动态库） | pod 'HDSCocoaLumberjack' | 下载zip包中 HDSCocoaLumberjack 文件夹下，拖入项目中 | Embed & Sign |
|
|
|
|
|
|
|
|
示例代码如下：
|
|
|
|
|
|
|
|
```objc
|
|
|
|
1.在 Appdelegate.m 文件中 导入
|
|
|
|
#import "CCSDK/HDSPreserve.h"
|
|
|
|
|
|
|
|
2.在 didFinishLaunchingWithOptions 方法中添加日志收集方法
|
|
|
|
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
|
|
|
|
[[HDSPreserve shared] HDSApplicationDidFinishLaunching];
|
|
|
|
return YES;
|
|
|
|
}
|
|
|
|
|
|
|
|
3.在 applicationWillTerminate 方法中添加日志收集方法
|
|
|
|
- (void)applicationWillTerminate:(UIApplication *)application {
|
|
|
|
[[HDSPreserve shared] HDSApplicationWillTerminate];
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
2.离线回放新增校验文件MD5
|
|
|
|
|
|
|
|
示例代码
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 校验文件MD5值
|
|
|
|
/// @param filePath 文件路径
|
|
|
|
/// @param MD5 源文件MD5值
|
|
|
|
/// @return YES 文件正常 / NO 文件已损坏
|
|
|
|
- (BOOL)HDSCheckFileMD5:(NSString *)filePath MD5:(NSString *)MD5;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 废弃API
|
|
|
|
|
|
|
|
| 方法 | 说明 |
|
|
|
|
| ----------------------------- | ----------- |
|
|
|
|
| ~~(void)doubleCllickPPTView~~ | ~~双击PPT~~ |
|
|
|
|
|
|
|
|
示例代码
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/**
|
|
|
|
* @brief 双击ppt
|
|
|
|
*/
|
|
|
|
- (void)doubleCllickPPTView DEPRECATED_MSG_ATTRIBUTE("该方法已废弃");
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.17.7
|
|
|
|
|
|
|
|
发布日期：2022.03.04
|
|
|
|
|
|
|
|
1.新增日志收集
|
|
|
|
|
|
|
|
#### <font color = red>注：日志收集功能为 **必选项** ，本地接入需要使用最新的 CCBundle 资源文件</font>
|
|
|
|
|
|
|
|
| 新增依赖库 | Cocoapods 接入 | 本地接入 | 签名选择 |
|
|
|
|
| ------------------------------------ | ------------------------ | --------------------------------------------------- | ------------ |
|
|
|
|
| CCFuncTool.framework （动态库） | pod 'HDSCCFuncTool' | 下载zip包中 CCFuncTool 文件夹下，拖入项目中 | Embed & Sign |
|
|
|
|
| SSZipArchive.framework （动态库） | pod 'HDSSZip' | 下载zip包中 CCFuncTool 文件夹下，拖入项目中 | Embed & Sign |
|
|
|
|
| CocoaLumberjack.framework （动态库） | pod 'HDSCocoaLumberjack' | 下载zip包中 HDSCocoaLumberjack 文件夹下，拖入项目中 | Embed & Sign |
|
|
|
|
|
|
|
|
示例代码如下：
|
|
|
|
|
|
|
|
```objc
|
|
|
|
1.在 Appdelegate.m 文件中 导入
|
|
|
|
#import "CCSDK/HDSPreserve.h"
|
|
|
|
|
|
|
|
2.在 didFinishLaunchingWithOptions 方法中添加日志收集方法
|
|
|
|
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
|
|
|
|
[[HDSPreserve shared] HDSApplicationDidFinishLaunching];
|
|
|
|
return YES;
|
|
|
|
}
|
|
|
|
|
|
|
|
3.在 applicationWillTerminate 方法中添加日志收集方法
|
|
|
|
- (void)applicationWillTerminate:(UIApplication *)application {
|
|
|
|
[[HDSPreserve shared] HDSApplicationWillTerminate];
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
2.离线回放新增校验文件MD5
|
|
|
|
|
|
|
|
示例代码
|
|
|
|
|
|
|
|
```objc
|
|
|
|
/// 校验文件MD5值
|
|
|
|
/// @param filePath 文件路径
|
|
|
|
/// @param MD5 源文件MD5值
|
|
|
|
/// @return YES 文件正常 / NO 文件已损坏
|
|
|
|
- (BOOL)HDSCheckFileMD5:(NSString *)filePath MD5:(NSString *)MD5;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.17.6
|
|
|
|
|
|
|
|
发布日期：2022.2.10
|
| ... | ... | |
