VHallSDK_Live_iOS

历史版本 v4.0.0 以下版本

快速集成

CocoaPods 方式

在 Podfile 文件中增加如下内容

pod 'VHLiveSDK'        # 使用 直播功能
pod 'VHLiveSDK_Interactive' # 使用 互动直播

执行如下命令
建议：
1. 为了避免缓存导致的无法更新问题，请进行本地 CocoaPods 缓存文件清理
2. 如果必要，请移除工程目录下的 podfile.lock 文件及 Pods 文件夹，以更新版本
```
$ pod cache clean --all # 清理 CocoaPods 缓存
$ pod install	--repo-update # 下载&安装库
```
设置 info.plist 的网络权限、相机、麦克风的使用权限
设置 BitCode : Project -> Build Settings -> Enable Bitcode 值为 NO

修改文件名 : AppDelegate.m 改为 AppDelegate.mm，并添加如下内容

// AppDelegate.m
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
	[VHallApi registerApp:<#AppKey#> SecretKey:<#AppSecretKey#>];
  
}

检查工程中的 Bundle ID 是否与 AppKey 对应

快速使用

详细请参见官方文档

FAQ

上传App Store时会报模拟器错误: 参见 https://www.vhall.com/saas/doc/296.html 中 打包上传 App Store 问题

版本更新信息

版本：v6.17.0 更新时间 2023.07.21

1.【新增】新增推屏卡片互动功能，提升直播间营销互动能力，对接说明见“链接” 2.【优化】解决底层包引用冲突问题 3.【优化】升级底层OpenGL版本至v3.0 4.【优化】优化回放设置倍速场景下拖动进度条倍速设置失效问题

版本：v6.16.0 更新时间 2023.06.16

1.【新增】SDK新增资料下载功能，助力观众留资，对接说明见链接； 2.【新增】新增聊天内容删除消息，消除直播安全隐患，对接说明见链接； 3.【优化】直播发起时自动校验音视频权限获取情况，确保直播顺利发起。

版本：v6.15.0 更新时间 2023.06.07

1.【新增】SDK新增播放指定回放或视频功能，支持精彩片段播放场景，接入说明见链接；2.【新增】新增播放器截图功能，接入说明见链接；3.【优化】支持播放1080P视频；4.【优化】优化直播播放区域发灰及按钮生效范围问题。

版本：v6.14.0 更新时间 2023.05.05

1.【优化】弱网、断网及网络切换的异常处理优化；2.【优化】麦克风、扬声器占用及外接设备切换优化；3.【优化】切换后台等异常中断场景优化处理；

版本：v6.13.1 更新时间 2023.04.03

【修复】可能导致崩溃的线程

版本：v6.13.0 更新时间 2023.03.29

【新增】1、SDK新增显示章节、视频打点能力 2、新增查看奖池，查看中奖名单等抽奖相关接口
【优化】1、优化抽奖互动能力，新增支持口令等特殊抽奖条件 2、观看回放初始化播放位置的功能 3、优化了登录和其他已知问题
【修复】一些可能导致崩溃的场景

版本：v6.12.0 更新时间 2023.03.07

【新增】新增支持验证SaaS观看限制（密码、白名单），对接流程见“链接”；
【优化】对接直播发起端发起倒计时公告，对接流程见“链接”；
【注意】从该版本开始，SDK将不再支持K值验证。
【修复】nil导致的崩溃,线程问题等等

版本：v6.11.0 更新时间 2022.12.23

【新增】快速回答
优化SDK中的一些已知问题

版本：v6.10.0 更新时间 2022.11.24

【新增】预告页面场景
【新增】暖场视频
优化SDK获取活动详情的时机
优化SDK中的一些已知问题

版本：v6.9.0 更新时间 2022.10.28

【新增】直播支持新的“连麦演示”布局
【新增】支持文档融合屏幕
优化SDK互动直播时，提供主动配置旁路，主动配置大画面的能力
优化SDK中的一些已知问题

版本：v6.8.0 更新时间 2022.9.23

【新增】彩排权限
【新增】主持人发起互动混流支持PC配置的图片和背景
优化SDK中的一些已知问题

版本：v6.7.0 更新时间 2022.9.6

【新增】点赞
【新增】计时器
【新增】礼物
【新增】直播间彩排
【新增】虚拟人数
【新增】极简观看模式
【新增】活动详情新增直播主持人信息，直播标题等
【优化】SDK中一些已知问题

版本 v6.6.0 更新时间：2022年8月9日

更新内容：

公告列表
观看直播增加k_id验证
聊天记录增加分页消息锚点，防止重复数据

版本 v6.5.0 更新时间：2022年7月8日

更新内容：

新增视频轮播功能，支持视频直播和互动直播参与轮播
优化互动连麦清晰度，动态切换互动清晰度
修复部分已知BUG

版本 v6.4.1 更新时间：2022年6月14日

更新内容：

优化抽奖相关业务

版本 v6.4.0 更新时间：2022年6月1日

更新内容：

新增支持云导播活动的发起和推流
问卷&问答支持修改显示名称
播放器支持设置背景图片和背景色
修改嘉宾和观众的设备检测流程
修复已知问题

版本 v6.3.4 更新时间：2022年5月13日

更新内容：1、开放动态过滤私聊，聊天消息体新增私聊标识 2、优化已知bug

版本 v6.3.3 更新时间：2022.05.06

更新内容： 1、新增嘉宾进入互动权限，在VHRoomInfo中增加permission字段，在VHRoomMessage中增加inviter_Id字段；2、新增嘉宾作为主讲人邀请上麦功能；3、优化已知bug。

版本 v6.3.2 更新时间：2022.04.29

更新内容： 1、在回放和看直播前调用观看协议；2、新增观看协议功能；3、优化已知bug。

版本 v6.3.1 更新时间：2022.03.31

更新内容：

1.新增相同账号踢出功能；2.优化部分代码。

版本 v6.3.0 更新时间：2022.03.22

更新内容：

1.优化美颜功能，新增红润、大眼、瘦脸、锐化、白牙、亮眼等美颜效果；2.新增滤镜，支持接入自然款、粉嫩款、白亮款等6种滤镜。

版本 v6.2.4 更新时间：2022.02.22

更新内容：

新功能 - 支持多语言化蛹。
新功能 - 修改主持人、嘉宾、助理的角色名称。

版本 v6.2.2 更新时间：2021年12月14日

更新内容：
1、增加对关键字过滤功能的支持
2、优化部分代码

版本 v6.2.1 更新时间：2021年11月10日

更新内容：
1、支持发起和观看无延时直播
2、修复已知问题

版本 v6.2.0 更新时间：2021年10月13日

更新内容：
1、支持1对15的互动
2、嘉宾加入直播支持传入头像

版本 v6.1.4 更新时间：2021年9月6日

更新内容：
1、修复部分活动下发起问答提问时出现的错误
2、修复嘉宾加入正在演示文档的直播间时文档不显示的问题

版本 v6.1.3 更新时间：2021年8月23日

更新内容：
1、解决进入互动活动时密码或k值无效的问题
2、解决部分场景下播放器内存未释放的问题

版本 v6.1.2 更新时间：2021.07.27

更新内容：
1、初始化接口支持传入RSA私钥
2、解决观众进入互动下麦后，发送聊天消息提示包含敏感词问题

版本 v6.1.1 更新时间：2021.07.01

更新内容：
1、修复VHRoom进入房间多次回调的问题

版本 v6.1.0 更新时间：2021.06.29

更新内容：
1、支持主播发起互动直播
2、支持嘉宾加入互动直播
3、优化已知问题

版本 v6.0.3 更新时间：2021.06.03

更新内容：
1、解决播放回放，播放器状态处于启动状态时暂停无效问题
2、优化长方形水印出现形变问题
3、解决某些回放闪退问题

版本 v6.0.2 更新时间：2021.04.15

更新内容：
1、新增跑马灯功能
2、调整水印间距，适配刘海屏
3、修复已知问题

版本 v6.0.1 更新时间：2021.04.02

更新内容：
1、修复6.0版本初始化SDK需要传host问题
2、观看直播/回放播放器，新增视频尺寸回调

版本 v6.0.0 更新时间：2021.03.16

更新内容：
1、发布直播接口，在新版v3控制台创建的直播活动可不传access_token。
2、新增抽奖接口，仅适用于新版控制台v3创建的直播所发起的抽奖。
3、观看直播/回放播放器，新增活动信息VHWebinarInfo，可获取当前在线人数与活动热度信息。
4、发布直播，可修改主播昵称。
5、修复部分机型前后台切换，推流失败问题
6、修复问答，主持人的回答消息昵称错误问题
7、修复投屏播放过程中，无法切换视频问题
8、修复播放回放时，无法切换视频问题
9、修复iOS14下播放回放进入后台暂停后再进入前台无法播放问题

升级v6.0.0注意事项： 1、6.0移除了回放评论功能，建议使用聊天代替。若使用了评论功能，请务必在升级6.0前进行修改，否则评论功能将失效。2、移除了游客进入，新增第三方id登录，使用SDK功能必须先登录。

版本 v5.0.2 更新时间：2021.01.25

更新内容：
1、消息优化
2、播放器优化

版本 v5.0.1 更新时间：2020.11.19

更新内容：
1、日志上报新增字段
2、上线消息中新增PV字段，解决web端观看量显示为0问题

版本 v5.0.0 更新时间：2020.10.28

更新内容：
1、底层优化
2、H5活动新增分页获取聊天记录
3、H5点播开始播放状态修复
4、文档翻页bug修复
5、解决 Seek 精度问题
6、Demo新增竖屏播放

版本 v4.3.4 更新时间：2020.07.02

更新内容：
1、新增是否全体禁言字段
1、新增签到倒计时取消功能

版本 v4.3.3 更新时间：2020.07.02

更新内容：
1、解决文档初始化是否显示的bug

版本 v4.3.2 更新时间：2020.06.22

更新内容：
1、回放文档bug修复
2、预加载房间消息bug修复

版本 v4.3.1 更新时间：2020.06.15

更新内容：
1、解决偶尔文档不加载问题

版本 v4.3.0 更新时间：2020.06.11

更新内容：
1、新增水印功能
2、优化扬声器设备占用（后台切换等情况）
3、角色信息bug修复
4、新增直播前连接消息服务
5、解决回放显示文档问题
6、优化demo

版本 v4.2.1 更新时间：2020.05.21

更新内容：
1、解决互动偶尔声音小问题

版本 v4.2.0 更新时间：2020.04.27

更新内容：
1、支持投屏功能
2、日志上报优化

版本 v4.1.2 更新时间：2020.04.20

更新内容：
1、demo优化
2、解决GPUimage 冲突bug
3、解决偶尔web显示角色错误
4、解决历史聊天信息不全问题
5、回放静音失效问题

版本 v4.1.1 更新时间：2020.03.18

更新内容：
1、解决回放后台播放bug
2、支持pod集成 SDK
3、H5 活动历史消息数据兼容
4、上麦bug修复

版本 v4.1.0 更新时间：2020.02.27

更新内容：
1、解决播放器bug
2、优化Demo

版本 v4.0.1 更新时间：2019.09.16

更新内容：
1、优化Demo
2、修改美颜设置

版本 v4.0.0 更新时间：2019.09.02

更新内容：
1、优化问卷展现形式
2、修复已知bug

历史版本

Demo

Demo 结构

VHSDKDemo.xcworkspace Demo工作空间，用于管理 VHSDKDemo和UIModel两个工程
VHSDKDemo App 层模拟用户 App
VHSDKUIModel Demo UI层简单实现，以静态库形式提供App层使用，此模块是Demo的一部分，仅供参考
VHallSDK 微吼 SaaS 直播 SDK

演示使用说明

1、打开工程 VHSDKDemo.xcworkspace
2、填写 CONSTS.h 中的信息，修改包名签名
3、选择target 为 VHSDKDemo4.x 直接编译运行
4、登录
5、设置相关参数，发直播需要设置有效期内的直播token (AccessToken) 需要用API生成

两种引入App工程方式

1、打开 UIModel.xcodeproj 编译完成可将 VHallSDK，UIModel 复制到目标App工程直接引用。UIModel中使用了第三方库如有冲突可自行删除冲突静态库。

2、源码依赖 UIModel，可直接将VHSDKUIModel下的UIModel文件夹拖到App工程中，在 podfile 中添加 UIModel的依赖库，设置好依赖路径，在 pch 文件中引入UIModel.h 编译即可。注意：需要额外设置DLNA lib路径

UIModel 依赖的第三方库如下，如版本不同可自行调整

  pod 'VHallSDK_Interactive'
  pod 'BarrageRenderer','2.1.0'
  pod 'Masonry','1.1.0'
  pod 'MBProgressHUD','1.2.0'
  pod 'MLEmojiLabel','1.0.2'
  pod 'Reachability','3.2'
  pod 'SDWebImage','5.6.1'
  pod 'MJRefresh','3.3.1'

通过体验appstore中的微吼小直播应用，设置填写Appkey即可体验

VHLiveSDK_Interactive 6.19.7

VHLiveSDK_Interactive 6.19.7

VHLiveSDK_Interactive 6.19.7

VHallSDK_Live_iOS

快速集成

CocoaPods 方式

快速使用

FAQ

版本更新信息

版本：v6.17.0 更新时间 2023.07.21

版本：v6.16.0 更新时间 2023.06.16

版本：v6.15.0 更新时间 2023.06.07

版本：v6.14.0 更新时间 2023.05.05

版本：v6.13.1 更新时间 2023.04.03

版本：v6.13.0 更新时间 2023.03.29

版本：v6.12.0 更新时间 2023.03.07

版本：v6.11.0 更新时间 2022.12.23

版本：v6.10.0 更新时间 2022.11.24

版本：v6.9.0 更新时间 2022.10.28

版本：v6.8.0 更新时间 2022.9.23

版本：v6.7.0 更新时间 2022.9.6

版本 v6.6.0 更新时间：2022年8月9日

版本 v6.5.0 更新时间：2022年7月8日

版本 v6.4.1 更新时间：2022年6月14日

版本 v6.4.0 更新时间：2022年6月1日

版本 v6.3.4 更新时间：2022年5月13日

版本 v6.3.3 更新时间：2022.05.06

版本 v6.3.2 更新时间：2022.04.29

版本 v6.3.1 更新时间：2022.03.31

版本 v6.3.0 更新时间：2022.03.22

版本 v6.2.4 更新时间：2022.02.22

版本 v6.2.2 更新时间：2021年12月14日

版本 v6.2.1 更新时间：2021年11月10日

版本 v6.2.0 更新时间：2021年10月13日

版本 v6.1.4 更新时间：2021年9月6日

版本 v6.1.3 更新时间：2021年8月23日

版本 v6.1.2 更新时间：2021.07.27

版本 v6.1.1 更新时间：2021.07.01

版本 v6.1.0 更新时间：2021.06.29

版本 v6.0.3 更新时间：2021.06.03

版本 v6.0.2 更新时间：2021.04.15

版本 v6.0.1 更新时间：2021.04.02

版本 v6.0.0 更新时间：2021.03.16

版本 v5.0.2 更新时间：2021.01.25

版本 v5.0.1 更新时间：2020.11.19

版本 v5.0.0 更新时间：2020.10.28

版本 v4.3.4 更新时间：2020.07.02

版本 v4.3.3 更新时间：2020.07.02

版本 v4.3.2 更新时间：2020.06.22

版本 v4.3.1 更新时间：2020.06.15

版本 v4.3.0 更新时间：2020.06.11

版本 v4.2.1 更新时间：2020.05.21

版本 v4.2.0 更新时间：2020.04.27

版本 v4.1.2 更新时间：2020.04.20

版本 v4.1.1 更新时间：2020.03.18

版本 v4.1.0 更新时间：2020.02.27

版本 v4.0.1 更新时间：2019.09.16

版本 v4.0.0 更新时间：2019.09.02

历史版本

Demo

Demo 结构

演示使用说明

两种引入App工程方式