Changelog

本文档用于描述每个版本的更新、修改。本文档叙述了 PolyvVodSDK 项目的更新日志。

该项目已发布在 CocoaPods 中，查看各版本可使用 pod trunk info PolyvVodSDK 命令。

[2.21.1] - 2024-03-19

Changed

【SDK】httpdns 获取ipv4、ipv6地址优化

Fixed

【SDK】部分iPad设备开启画中画崩溃修复
【SDK】广告加载大的gif 图片文件失败修复

迁移说明

由 2.18.x 及以下版本升级到 2.19.0 及以上版本时，需要注意视频下载的迁移

自 2.19.0 版本开始，本地播放视频鉴权方式进行了调整，为了在覆盖升级时兼容已下载的旧版本视频，初始换sdk时会自动迁移，必须严格测试本地缓存视频是否迁移成功。

2.20.1升级到2.21.0，无需更新demo 层
以前旧版本升级至 2.21.0 版本的点播 SDK，需要同步更新 2.20.1 版本的 Demo 层代码，以获得新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.21.0] - 2024-01-05

Added

【SDK】播放器新增seek参数选项，优化seek 体验

Changed

【SDK】播放链接动态域名配置，提升网络抗性

Fixed

【SDK】AB流视频下载失败修复

迁移说明

由 2.18.x 及以下版本升级到 2.19.0 及以上版本时，需要注意视频下载的迁移

自 2.19.0 版本开始，本地播放视频鉴权方式进行了调整，为了在覆盖升级时兼容已下载的旧版本视频，初始换sdk时会自动迁移，必须严格测试本地缓存视频是否迁移成功。

2.20.1升级到2.21.0，无需更新demo 层
以前旧版本升级至 2.21.0 版本的点播 SDK，需要同步更新 2.20.1 版本的 Demo 层代码，以获得新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.20.1] - 2023-10-30

Changed

【SDK、Demo】Xcode15&iOS17兼容适配

迁移说明

由 2.18.x 及以下版本升级到 2.19.0 及以上版本时，需要注意视频下载的迁移

自 2.19.0 版本开始，本地播放视频鉴权方式进行了调整，为了在覆盖升级时兼容已下载的旧版本视频，初始换sdk时会自动迁移，必须严格测试本地缓存视频是否迁移成功。

旧版本升级至 2.20.1 版本的点播 SDK，需要同步更新 2.20.1 版本的 Demo 层代码，以获得本次新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.20.0] - 2023-09-01

Changed

【SDK、Demo】旧版跑马灯移除
【SDK、Demo】优化问答提交统计
【Demo】优化跑马灯显示样式
【SDK】支持溯源水印
【SDK】支持跨端续播

Fixed

【Demo】修复下载视频出现线路切换问题
【SDK】修复播放第三方URL视频seek失效的问题
【SDK】修复偶发性崩溃问题
【SDK】移除先前版本中未使用的imei字段

迁移说明

由 2.18.x 及以下版本升级到 2.19.0 及以上版本时，需要注意视频下载的迁移

自 2.19.0 版本开始，本地播放视频鉴权方式进行了调整，为了在覆盖升级时兼容已下载的旧版本视频，初始换sdk时会自动迁移，必须严格测试本地缓存视频是否迁移成功。

旧版本升级至 2.20.0 版本的点播 SDK，需要同步更新 2.20.0 版本的 Demo 层代码，以获得本次新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.19.1] - 2023-07-21

Changed

【SDK】离线视频鉴权方式修改
【SDK】播放器支持设置起播位置

Fixed

【SDK】修复userid设置为空引起崩溃的问题
【SDK】修复部分视频音画不同步问题
【SDK】重大安全性升级

迁移说明

由 2.18.x 及以下版本升级到 2.19.0 及以上版本时，需要注意视频下载的迁移

自 2.19.0 版本开始，本地播放视频鉴权方式进行了调整，为了在覆盖升级时兼容已下载的旧版本视频，初始换sdk时会自动迁移，必须严格测试本地缓存视频是否迁移成功。

[2.18.4] - 2023-03-15

Fixed

【SDK】修复错误token引发的崩溃问题。
【SDK】修复偶发性崩溃问题。

注意：

旧版本升级至 2.18.4 版本的点播 SDK，建议同步更新 2.18.4 版本的 Demo 层代码，以获得本次新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.18.3] - 2022-11-18

Changed

【SDK】新增vrm13开关，优化播放体验。
【SDK】vrm13默认使用软解。
【Demo】修复弹幕按钮点击无效果问题

注意：

旧版本升级至 2.18.3 版本的点播 SDK，建议同步更新 2.18.3 版本的 Demo 层代码，以获得本次新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.18.1] - 2022-10-12

Changed

【SDK】新增支持系统画中画播放倍速功能
【SDK】新增支持HttpDNS动态开关功能
【SDK、Demo】新增支持软硬解手动切换功能

注意：

旧版本升级至 2.18.1 版本的点播 SDK，建议同步更新 2.18.1 版本的 Demo 层代码，以获得本次新增的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.18.0] - 2022-09-22

Changed

【SDK】新增支持播放vrm13加密视频

Fixed

【SDK】修复连续切换视频的时候，首帧片头不会消失的问题
【SDK】支持bitcode打包

注意：

本次升级内容主要是 SDK 层，无需更新 Demo 层代码也可。
若需要更新demo源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.17.0] - 2022-09-05

Changed

【Demo】使用慕享投屏SDK替换乐播投屏SDK
【Demo】适配iOS 16系统旋转屏幕
【SDK】新增httpdns解析结果的日志上报
【SDK】支持本地传入token来播放加密视频
【SDK】支持系统级画中画观看加密视频
【SDK】优化环路滤波配置
【SDK】下载模块增加代码保护，防止崩溃情况
【SDK】修复请求所有下载任务不齐全的问题
【SDK】修复下载任务被提前释放导致更新进度崩溃的问题

注意：

旧版本升级至 2.16.6 版本的点播 SDK，建议同步更新 2.17.0 版本的 Demo 层代码，以获得本次修复的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.6] - 2022-04-06

Changed

【SDK】播放器支持https+ip访问开启了SNI验证的服务器
【SDK】优化m3u8视频错误重试机制
【SDK】新增elog错误信息上报
【SDK】HttpDNS新增鉴权功能
【SDK】初始化支持多个加密串同时使用

Fixed

【Demo】修复悬浮小窗播放视频的时候，旋转屏幕有黑框的问题。
【Demo】修复播放广告视频之后，跟随系统息屏的问题
【SDK】修复清晰度数量不符的问题。
【SDK】修复音频模式播放导致的手势失效问题。

注意：

旧版本升级至 2.16.6 版本的点播 SDK，建议同步更新 2.16.6 版本的 Demo 层代码，以获得本次修复的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.5] - 2021-12-02

Changed

【Demo】上传视频支持自定义文件名

Fixed

【Demo】修复闪烁双跑马灯显示两个跑马灯的问题
【Demo】修复断网后seek进度条无效果，断网情况不允许seek
【Demo】修复断网后恢复网络，视频播放进度从0开始的问题
【SDK】修复断网后恢复网络，偶现视频播放黑屏有声音的问题

注意：

旧版本升级至 2.16.5 版本的点播 SDK，建议同步更新 2.16.5 版本的 Demo 层代码，以获得本次修复的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.4] - 2021-10-10

Changed

【Demo】跑马灯2.0发布

Fixed

【SDK】修复开启记忆播放功能时，切换清晰度/线路影响视频播放开始播放时间的问题
【Demo】修复视频未加载出来时，首帧图片拉伸的问题
【Demo】修复刘海屏全屏播放时，遮挡锁屏按钮的问题

注意：

旧版本升级至 2.16.4 版本的点播 SDK，建议同步更新 2.16.4 版本的 Demo 层代码，以获得本次更新的跑马灯2.0功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.3] - 2021-09-06

Changed

【SDK】暂停广告位置参数优化
【Demo】新增知识清单功能

Fixed

【SDK】修复音频播放seek过程太长的问题

注意：

旧版本升级至 2.16.3 版本的点播 SDK，建议同步更新 2.16.3 版本的 Demo 层代码，以获得本次更新的知识清单功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.2] - 2021-08-06

Changed

【Demo】【SDK】新增系统音量控制
【Demo】【SDK】新增根据网络环境提示切换清晰度
【Demo】新增支持顶部/底部弹幕样式

Fixed

【Demo】限制源视频播放不能切换清晰度
【SDK】“准备”状态的下载任务在调用停止下载方法后，状态改为“停止”

注意：

旧版本升级至 2.16.2 版本的点播 SDK，建议同步更新 2.16.2 版本的 Demo 层代码，以获得本次版本新增和修复的功能。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.1] - 2021-07-22

Changed

【SDK】新增播放外部视频时记忆播放进度和续播功能
【SDK】新增自定义暂停广告大小和位置的功能
【SDK】修复投屏的观看日志统计不到的问题
【SDK】修复请求下载中任务会出现下载完成任务的问题
【Demo】新增屏幕旋转与全半屏状态分离功能

注意：

旧版本升级至 2.16.1 版本的点播 SDK，建议同步更新 2.16.1 版本的 Demo 层代码，以获得屏幕旋转与全半屏状态分离的能力。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.16.0] - 2021-06-29

Changed

【SDK】适配DRM12方案下的视频播放

注意：

本次升级内容主要是SDK 层，无需更新 Demo 层代码。

[2.15.2] - 2021-06-10

Changed

【SDK】优化广告播放规则，有记忆进度的情况下可配置广告是否跳过
【SDK】修复音频时长比视频时长短的情况下，播放进度不更新的问题

注意：

本次升级内容主要是SDK 层，无需更新 Demo 层代码。

[2.15.1] - 2021-05-12

Changed

【SDK】投屏URL的拼接移动到sdk层
【SDK】投屏URL参数添加base64处理优化
【SDK】FFMpeg打包瘦身
【SDK】修复视频片头播放黑屏的问题
【SDK】修复切换视频时，上一个视频的片头会继续播放的问题
【SDK】修复某些m3u8视频，无法seek到0、无法重播的问题
【SDK】修复后台状态下，无网络恢复为4g网络情况引起崩溃的问题
【SDK】对齐安卓sdk，修改sdk中网络请求的user-agent
【Demo】投屏URL的获取由demo层拼接改为从SDK获取

注意：

旧版本升级至 2.15.1 版本的点播 SDK，建议同步更新 2.15.1 版本的 Demo 层代码，以获得投屏播放时的观看统计能力。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.15.0] - 2021-04-14

Changed

【SDK】添加视频禁播功能
【SDK】sdk中的http请求更换为https请求
【SDK】解决部分直播转存视频seek卡住的问题
【Demo】问答功能中选择题的显示优化、新增填空题型
【Demo】支持投屏的观看统计

注意：

旧版本升级至 2.15.0 版本的点播 SDK，建议同步更新 2.15.0 版本的 Demo 层代码，以获得最新的问答功能和投屏观看统计
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.14.1] - 2021-02-25

Changed

【SDK】升级PolyvAliHttpDNS到1.8.0以上
【SDK】修复前后台切换视频播放黑屏问题
【SDK】修复切换视频会从上一个视频播放时间开始的问题
【SDK】直播转存视频Seek优化

注意：

旧版本升级至 2.14.1 版本的点播 SDK，建议同步更新 2.14.1 版本的 Demo 层代码。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.14.0] - 2020-12-23

Changed

【SDK】添加IPV6开关
【SDK】片头逻辑优化
【Demo】增加禁止拖拽的提示信息
【Demo】投屏开始/结束时，起播位置优化

注意：

旧版本升级至 2.14.0 版本的点播 SDK，建议同步更新 2.14.0 版本的 Demo 层代码。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.13.1] - 2020-11-20

Changed

【SDK】支持移除播放器已设置的跑马灯

将播放器 PLVVodPlayerViewController 的跑马灯属性 marquee 设为 nil 时，会移除已设置的跑马灯。

注意：

本次升级内容主要是SDK 层，无需更新 Demo 层代码。
如果原先项目代码中存在 self.marquee = nil 的情况，需做好代码保护，否则会当作移除跑马灯处理。

[2.13.0] - 2020-10-26

Changed

【SDK】升级IJK播放器依赖库到0.9.1，解决与客户的IJK播放器冲突的问题

Fixed

【SDK】源文件下载 url 更新

注意：

本次升级内容主要是SDK 层，无需更新 Demo 层代码。

[2.12.1] - 2020-10-19

Changed

【Demo】升级 demo 依赖第三方库乐播投屏 SDK 的版本号到 30226

Fixed

【SDK】修复获取全部下载任务列表获取不到已下载任务的问题

[2.12.0] - 2020-09-08

Changed

【Demo】开源点播播放器PLVVodSkinPlayerController 的布局代码到 Demo 层
【Demo】png 图片大小压缩

注意：

本次升级内容主要是 Demo 层的更新，如果想获得本次升级内容，除了升级 SDK 到 2.12.0 版本，还需同步更新 2.12.0 版本的 Demo 层代码。
若不便直接更新源码，可根据 diff 变动内容查看 Demo 层的变动，手动更新Demo层源码

[2.11.0] - 2020-07-20

Changed

【Demo】开放 PLVVodSkinPlayerController 的属性 maxPosition 为公有属性

Fixed

【Demo】修复部分机型无法投屏的问题
【SDK】修复播放速率变为 0 的问题
【SDK】安全性升级

[2.10.0] - 2020-06-15

Changed

【Demo】SDK 账号加密串等统一定义在 PLVVodAccount 中

Fixed

【Demo】修复vid测试播放页面输入框被键盘挡住的bug
【SDK】修复播放器全屏时偶发的崩溃
【SDK】修复记住上一次播放位置有时没生效的bug

[2.9.1] - 2020-06-01

Added

【SDK】新增获取当前播放视频 pid 方法和获取实时播放状态的方法：

@interface PLVVodPlayerViewController : UIViewController
- (NSString *)getPlayId;// 返回当前播放视频的 pid
- (NSDictionary *)getRealPlayStatus; // 返回播放器实时状态
@end

【SDK】根据后台设置控制 Viewlog 发送频率，默认 10 秒发送一次。

Fixed

【SDK】启动 app 时 iOS 13.4 部分机型偶发性崩溃问题修复
【Demo】悬浮窗示例代码在横竖屏切换时，悬浮窗比例发生变化问题修复，需同步更新悬浮窗开源代码（PolyvOpenSourceModule/Floating）

[2.9.0] - 2020-05-19

Added

【SDK】提供参数控制视频预加载视频的时长及大小

@interface PLVVodPlayerViewController : UIViewController
@property (nonatomic, assign) NSInteger maxCacheSize; // 预加载缓冲大小，单位字节
@property (nonatomic, assign) NSInteger maxCacheDuration; // 预加载缓冲时长，单位秒
@property (nonatomic, assign) NSInteger minCacheFrame; // 预加载最小缓冲帧数
@end

【SDK】支持延迟启动 HttpDNS，默认配置加密串时启动，延迟启动需在配置加密串之前设置

@interface PLVVodSettings : NSObject
@property (class, nonatomic, assign) BOOL delayHttpDNS; // 延迟启动 HttpDNS，enableHttpDNS 为 YES 时生效，默认 NO
@property (class, nonatomic, assign) NSInteger delayHttpDNSTime; // 延迟启动 HttpDNS 的时间，delayHttpDNS 为 YES 时生效，默认 2，单位秒

【SDK】支持对播放器设置最多两个 logo，代码示例参考 demo 中的 - (void)addLogo 方法

@class PLVVodPlayerLogoParam // logo 配置参数类

/// logo 图层 UIView 子类
@interface PLVVodPlayerLogo : UIView
- (void)insertLogoWithParam:(PLVVodPlayerLogoParam *)param; // 为 logo 图层添加 logo 图片
@end

@interface PLVVodPlayerViewController  : UIViewController
- (void)addPlayerLogo:(PLVVodPlayerLogo *)logo; // 为播放器增加 logo 显示图层
@end

Changed

【Demo】增加投屏功能宏定义 PLVCastFeature
【SDK】移除依赖库 PLVNetworkDiagnosisTool

Fixed

【Demo】修复手势滑动播放器改变音量会不准确的问题
【SDK】支持播放 wav 格式的音频文件
【SDK】修复下载视频时偶发的线上崩溃
【SDK】修复内存泄漏导致的线上崩溃

[2.8.1] - 2020-05-08

Fixed

-【SDK】移除 UIWebView 相关内容 -【SDK】修复后台切换到前台时，界面会发生短暂卡顿的问题

[2.8.0] - 2020-03-31

Added

【SDK, Demo】支持长按屏幕快进

@interface PLVVodSkinPlayerController : PLVVodPlayerViewController
@property (nonatomic, assign) BOOL disableLongPressGesture; // 是否屏蔽长按倍速快进手势，默认为 NO
@property (nonatomic, assign) double longPressPlaybackRate; // 长按快进时的倍速，默认为 2.0
@end

【SDK, Demo】增加全屏播放时视频方向设置，需同步更新播放器皮肤（路径 PolyvOpenSourceModule/Skin）

typedef NS_ENUM(NSInteger, PLVVodFullScreenOrientation) {
    PLVVodFullScreenOrientationAuto = 0, // 根据视频宽高比自动判断，当宽高比 >=1 时，横向全屏；当宽高比 <1 时，竖向全屏
    PLVVodFullScreenOrientationPortrait, // 竖向全屏
    PLVVodFullScreenOrientationLandscape, // 横向全屏
};

@interface PLVVodPlayerViewController : UIViewController
@property (nonatomic, assign) PLVVodFullScreenOrientation fullScreenOrientation; // 设置全屏方向
@property (nonatomic, copy) void (^didFullScreenSwitch)(BOOL fullScreen); // 全屏状态变化回调
- (void)setPlayerFullScreen:(BOOL)full; // 设置播放器是否处于全屏模式
@end

【Demo】增加禁止拖拽进度条的开关，应在调用方法 -addPlayerOnPlaceholderView:rootViewController 之前设置

@interface PLVVodSkinPlayerController : PLVVodPlayerViewController
@property (nonatomic, assign) BOOL restrictedDragging; // 是否限制拖拽进度功能，默认为 NO，可随意拖拽进度
@property (nonatomic, assign) BOOL allForbidDragging; // 在属性 restrictedDragging 为 YES 的基础上，是否允许对已播放的进度进行拖拽
@end

【Demo】增加支持悬浮窗播放的功能，需引入 demo 中路径 PolyvOpenSourceModule/Floating 下的开源代码到项目中

Changed

【SDK】支持播放离线视频时弹出问答题目
【SDK】请求视频资源时区分下载和播放行为

Fixed

【Demo】关闭弹幕开关失效问题
【SDK】子线程中播放可能导致的崩溃问题

[2.7.1] - 2020-03-22

Added

【SDK】PLVVodDownloadManager 增加以下方法：

/// 迁移已经缓存的视频数据
- (BOOL)moveDownloadVideoFromSourceDir:(NSString *)sourceDir toDestDir:(NSString *)destDir;
/// 开始指定vid视频下载，根据priority 参数执行不同的下载策略
- (void)startDownloadWithVid:(NSString *)vid highPriority:(BOOL)priority; 
/// 停止下载指定视频，可选择是否自动开启下一个视频的下载
- (void)stopDownloadWithVid:(NSString *)vid autoNext:(BOOL)autoNext;

【SDK】PLVVodPlayerViewController 新增 -leavePlayerWithPause 方法
```
/// 离开播放器并暂停
- (void)leavePlayerWithPause;
```

Changed

【SDK】支持 pod subspec 方式集成，可解决依赖库冲突问题

Fixed

【SDK】子线程中销毁播放器导致的崩溃问题

[2.7.0] - 2020-01-06

Changed

【SDK】更改依赖库 PolyvIJKPlayer 为动态库，同时，PolyvIJKPlayer 的 framework 包名从 IJKMediaFramework 改为 PolyvIJKMediaFramework

[2.6.6] - 2020-01-06

Added

增加视频内容观看时长的接口
iOS 增加视频播放软硬解设置接口
增加seek 的elog 统计事件
基于appId 维度的流量数据统计
PLVVodPlayerViewController ,
- @property (nonatomic, assign, readonly) NSTimeInterval videoContentPlayedTime; 观看的视频内容时长
- @property (nonatomic, assign) BOOL isVideoToolBox; 默认硬解

Changed

统一 viewlog params 的传值方式
支持动态设置是否允许后台播放
子帐号签名规则修改

Fixed

[demo] iOS 13下所有输入框联想提示无法选择
[demo] 解决与云课堂sdk 的冲突
确保播放器主线程播放，避免部分场景下iOS 13 系统上崩溃

[2.6.5] - 2019-10-28

Added

支持三分屏播放
视频加载时显示加载网速
增加当前播放进度回调
PLVVodPlayerViewController ,
- @property (nonatomic, assign) BOOL pptEnable; 三分屏功能开关
- @property (nonatomic, copy) void (^playbackProgressHandler)(PLVVodPlayerViewController *player, NSTimeInterval curPlayTime);播放进度回调
PLVPPTSimpleDetailController：三分屏功能播放页(DEMO)

Changed

点播viewlog 补充flow 播放流量字段
vid 合法性判断逻辑优化，优化错误提示

Fixed

清除下载目录所有视频时，同时清除数据库记录
自动播放参数在setURL 方法不生效问题修复

[2.6.4] - 2019-08-13

Added

点播子账号支持
自定义片头支持
本地问答功能支持
随机更新自定义问答支持（demo）
发送弹幕接口增加返回弹幕id及参数校验
PLVVodSettings,
- + (instancetype)settingsWithAppId:(NSString *)appId secretKey:(NSString *)secretKey userId:(NSString *)userId; 点播子账号初始化
PLVVodExam,
- + (NSArray <PLVVodExam *> *)localExamsWithVid:(NSString *)vid downloadDir:(NSString *)downloadDir; 获取本地问答数据
PLVVodPlayerViewController,
- - (BOOL)setCustomTeaser:(NSString *)teaserUrl teaserDuration:(NSInteger )teaserDuration; 设置自定义片头

Changed

m3u8 播放地址支持httpdns 解析播放
跑马灯支持设置固定时间间隔，更新至0.0.4 版本

Fixed

部分视频播放结束时间与视频时长不一致问题修复
部分旧视频请求Key 404报错问题修复

[2.6.3] - 2019-06-25

Added

增加离线播放发送viewlog 日志的开关
第三方视频播放，支持自定义请求header
PLVVodPlayerViewController ,
- @property (nonatomic, assign) BOOL enableLocalViewLog 离线播放发送viewlog
- - (void)setURL:(NSURL *)videoUrl withHeaders:(NSDictionary<NSString *, NSString *> *)headers; 第三方播放链接可自定义header

Changed

播放器网络错误的重试优化，提示优化
sdk 发送elog 错误日志完善

Fixed

音频播放模式，自动播放开关设置无效问题修复
横竖屏切换，跑马灯可能显示在视图区域外问题修复

[2.6.2] - 2019-05-20

新增视频上传功能，集成方式 pod 'PLVVodUploadSDK', '~> 0.1.0'
详细集成方式参见：iOS 上传SDK 集成说明

[2.6.1] - 2019-05-20

Added

下载支持多账号功能
本地视频播放支持显示字幕
播放器提供显示问答的接口
播放器新增方法获取视频宽高
PLVVodDownloadManager ,
- @property (nonatomic, assign) BOOL isMultiAccount 多账号支持开关，默认NO
- @property (nonatomic, copy) NSString *previousDownloadDir 单帐号时所设置的视频下载目录，用于旧账号数据迁移到新账号
- -switchDownloadAccount 登入或切换到具体账号
- -logoutMultiAccount 登出当前帐号，登出后，会采用默认帐号进行下载相关操作
PLVVodExam
- +createExamWithDic 将问答信息字典转为 PLVVodExam 模型对象
- +createExamArrayWithDicArray 将问答信息字典数组转为 PLVVodExam 模型对象数组
PLVVodPlayerViewController
- -getVideoSize 获取视频的宽高，在视频播放就绪后可获取到数值

Changed

直播转存点播，聊天室消息以弹幕形式加载到播放器
弹幕接口升级
增加播放失败重试机制，自动切换码率/切换线路
优化播放逻辑，高码率视频还未编码成功，自动切换到低码率视频播放

Fixed

qos buffer 统计二次缓冲时间不准确问题修复
修改数据库默认路径，解决存储空间满时数据库可能被系统清理的问题
开辟新线程执行解压操作，解决其他下载中视频数据接收回调方法不执行问题
修复网络状态连续变化时可能引发的崩溃

[2.6.0] - 2019-05-15

Added

新增音频文件下载功能
视频播放时提示网络类型
新增视频解压进度回调
播放统计，新增viewerAvatar 参数，统计观看用户头像
PLVVodVideoParams , 新增数据类型，用于下载管理各接口参数传递，兼容视频/音频文件处理
- videoParamsWithVid:fileType: 初始化方法
PLVVodDownloadManager 新增兼容音频/视频下载管理的接口，无需音频下载的用户建议使用旧方法
- +downloadAudio 音频文件下载方法
- -startDownloadWithVideoParams 从指定视频/音频文件开始下载
- -stopDownloadWithVideoParams 停止下载指定的视频/音频文件
- -removeDownloadWithVideoParams 移除视频/音频下载任务，并删除对应文件
- -requestDownloadInfoWithVideoParams 获取视频/音频下载详细信息
- -removeVideoWithVideoParams 删除指定视频/音频文件（与下载任务无关）
PLVVodNetworkTipsView (Demo) 在线视频播放时提示网络类型，用户进一步选择播放或取消，具体实现参考demo
- @property (nonatomic, copy) void (^playBtnClickBlock) (void); 按钮点击回调
- -show 显示提示框
- -hide 隐藏提示框
PLVVodDownloadInfo 新增视频解压进度回调,优化下载进度UI展示
- @property (nonatomic, copy) void (^unzipProgressDidChangeBlock)(PLVVodDownloadInfo *info)
PLVVodSettings 播放统计，新增viewerAvatar 参数
- @property (nonatomic, copy) NSString *viewerAvatar;

Changed

播放统计，音视频/线路/码率切换时统一观看时长统计规则
默认开启httpdns 功能
优化ats设置，httpdns不依赖ats设置；投屏功能依赖ats设置，需要支持http请求。具体设置参考demo
问答区分单选多选题型
App 退到后台时，保存当前播放进度

Fixed

问答解析窗在竖直画布时布局不正确；答题后旋转屏幕，选项可能被遮挡；问答窗在iPad上被遮挡
问答点击“跳过”，播放视频回退问题修复
问答窗，问题标题过长显示不全
解决精准Seek下出现视频慢放问题
解决缓冲进度条闪动的问题

[2.5.6] - 2019-04-03

Added

新增播放器防录屏功能
播放器支持多线路切换
竖屏小窗播放，支持自定义清晰度/线路倍速按钮显示
PLVVodVideo , 新增音频文件线路属性，用于线路切换
- @property (nonatomic, strong, readonly) NSArray<NSString *> *availableVoiceRouteLines;
PLVVodPlayerViewController，防录屏功能，默认NO 关闭
- @property (nonatomic, assign) BOOL videoCaptureProtect;
PLVVodShrinkscreenView，（DEMO）小窗播放，自定义显示按钮
- @property (nonatomic, assign) BOOL isShowRouteline 是否显示线路按钮
- @property (nonatomic, assign) BOOL isShowRate 是否显示速率按钮
- @property (nonatomic, assign) BOOL isShowQuality 是否显示清晰度按钮

Changed

视频播放前显示视频封面图
投屏组件增加注释、针对防录屏功能的使用时机进行注释说明、默认投屏按钮隐藏（客户使用投屏功能，只需解开注释即可）

Fixed

竖屏切换到横屏，跑马灯始终显示在中间不变化问题修复
视频可播放但未开始播放，seek 失效问题修复
删除视频，数据库记录会重建问题修复
删除全部视频，autoStar 自动下载失效问题修复

[2.5.5] - 2019-02-26

Added

播放器新增视频打点功能，具体实现参考demo
PLVVodPlayerViewController，新增视频打点信息点击回调，传递被选中的打点信息索引
- @property (nonatomic, copy) void (^videoTipsSelectedHandler)(NSUInteger tipIndex);
PLVVodPlayerSkin ,
- -addVideoPlayTips ，添加视频打点信息
- -showVideoPlayTips，展示视频打点信息

@property (nonatomic, copy) void(^plvVideoTipsPlayerBlock)(NSUInteger playIndex); 点击打点信息播放事件处理

Fixed

投屏功能sdk升级，部分bug修复

[2.5.4] - 2019-02-15

Added

播放器新增投屏功能
播放器新增锁屏键功能
PLVVodPlayUtil ,
- requestCastKeyIvWitVideo 根据video模型获取投屏加密信息
PLVCastBusinessManager，新增投屏业务管理类，部分方法如下，具体实现参考demo
- -initCastBusinessWithListPlaceholderView 初始化投屏功能
- -setup 启用投屏功能
PLVCastManager，新增投屏管理器，部分方法如下，具体实现参考demo
- +getCastAuthorization 获取投屏权限，可在AppDelegate中提前调用
- +authorizationInfoIsLegal 是否已设置授权信息
- -quitAllFuntionc 停止投屏功能
- -startPlayWithVideo 开始视频播放
- -pause 暂停播放
- -resume 恢复播放
- -stop 停止播放
PLVCastManagerDelegate，新增投屏管理器代理协议，部分代理方法如下，具体实现参考demo
- -plvCastManager_findServices 设备搜索发现设备回调
- -plvCastManager_connectServicesResult 设备连接回调
- -plvCastManager_castError 投屏错误回调
- -plvCastManager_playStatusChangedWithStatus 播放状态回调
- -plvCastManager_playTimeChangedWithCurrentTime 播放进度回调
PLVVodLockScreenView，新增播放器锁屏键功能，具体实现参考demo

Changed

ijkplayer 升级到0.4.0 版本
播放音频时显示首图
问答播放器优化
播放器点击进度条，可以seek到指定位置
切换清晰度时记住原播放速率优化
适配无UI音频播放场景

Fixed

部分直播转存视频播放完毕后重播失败问题修复
片头/片头广告未播放完毕，切换视频声音重叠问题修复
部分场景下导致vid为空而在setVideo时出现崩溃问题修复

[2.5.3] - 2018-12-17

Added

PLVVodDownloadManager，支持多任务下载功能，1～3 个
- @property (nonatomic, assign) NSUInteger maxRuningCount 设置同时下载的最大任务数，默认为1
PLVVodDownloadManager (Database)，新增下载管理分类，拓展sdk 数据库功能
- -createExtendTableWithClass 创建扩展表
- -insertOrUpdateWithExtendInfo 插入或更新一条记录
- -getExtendInfoWithClass:condition 根据条件查询记录
- -getAllExtendInfoWithClass 查询所有记录
- -deleteExtendInfoWithClass:condition 根据条件删除一条记录
- -deleteAllExtendInfoWithClass 删除所有记录
PLVVodExtendVideoInfo，（Demo）数据库拓展表结构示例，具体参考demo
PLVVodDBManager，（Demo）新增PLVVodDBManager 二次封装sdk 数据库操作api，方便应用处理，具体参考demo
PLVVodPlayerViewController，增加seekType属性，实现精确seek功能
- @property (nonatomic, assign) PLVVodPlaySeekType seekType;
PLVSubtitleManager，（Demo）播放器支持顶部显示字幕功能，pod 'PLVSubtitle', '~> 0.1.0'
- -managerWithSubtitle:lale:topLable:error 支持顶部显示字幕初始化方法
PLVVodServiceUtil，（Demo）添加批量获取视频播放次数接口
- -requestPlayTimesWithVids 根据vid数组批量获取播放次数

Changed

Cocoapods 支持动态库方式集成sdk，解决与其他音视频sdk部分冲突问题,集成方式：
- pod 'PolyvVodSDK_Dylib'

Fixed

答题正确，不能续播而是重新播放问题修复（Demo）
音频模式下，从后台回到前台，播放动画停止问题修复（Demo）
长按皮肤功能设置按钮，播放器皮肤再也无法显示问题修复（Demo）
断点数据失效后，视频不能再次下载问题修复
播放器已经退出，部分场景下仍会中断第三方App后台播放问题修复

[2.5.2] - 2018-11-08

Added

PLVVodPlayerViewController，支持URL播放视频，兼容第三方平台视频播放
- -setURL 通过URL 播放/切换视频
PLVVodPlayerUtil，新增播放器工具类，提供播放进度，播放进度时间戳获取方法
- -lastPositionWithVid 通过vid获取上一次播放进度
- -lastPositionTimestampWithVid 通过vid获取上一次播放进度时间戳
PLVVodPlayerViewController，新增循环播放属性（暂不支持m3u8视频），适用短视频播放场景
- @property (nonatomic, assign) BOOL enablePlayRecycle;
PLVVodErrorUtil，Demo 中新增错误处理工具类，根据错误码返回错误提示，支持自定义错误提示
- -getErrorMsgWithCode 根据错误码返回错误提示
PLVVodServiceUtil，Demo 中新增业务工具类，提供相关拓展的API 接口
- -requestVideoListWithAccount 根据子账户，视频分类id等参数，获取视频列表信息

Changed

PLVVodVideo 模型title属性修改为可读写，用户可自定义设置title
播放器音量调节，可选择调节系统音量还是播放器音量，参见Demo PLVVodSkinPlayerController 类中音量调节逻辑

Fixed

1.0 升级到2.0，已缓存视频兼容问题修复
播放令牌接口，viewerId,viewerName 支持base64编码，修复参数含中文字符时获取token失败问题
同一播放器切换视频后，数据统计错误问题修复
非ViewDidLoad 函数中初始化播放器，iPad 上崩溃问题修复

[2.5.1] - 2018-09-26

Fixed

调用Api 进行码率切换，切换后视频会暂停播放问题修复
添加视频到下载队列，立即保存记录到数据库，解决退出app 后有时不能保存下载记录的问题

[2.5.0] - 2018-09-17

Added

PLVVodDownloadManager，下载队列中添加指定视频的暂停/开始功能，用法参见demo
- -startDownloadWithVid 开始下载指定视频
- -stopDownloadWithVid 停止下载指定视频
PLVVodDownloadManager，新增从数据库中获取缓存中/已缓存视频列表信息，用法参见demo
- -requstDownloadProcessingListWithCompletion 从数据库中获取所有缓存中视频信息（准备缓存，缓存中，缓存失败等等）
- -requestDownloadCompleteList 从数据库获取所有已缓存成功视频信息
PLVVodDownloadManager，新增单个视频的下载完成回调，用法参见demo
- @property (nonatomic, copy) void(^downloadCompleteBlock)(PLVVodDownloadInfo *info);
PLVVodDownloadManager，新增根据vid 获取下载信息方法
- -requestDownloadInfoWithVid
PLVVodVideo，新增videojson 获取方法，此方法自动更新保存videojson 到本地数据库，且优先返回本地数据
- -requestVideoPriorityCacheWithVid 添加视频到下载队列，获取videojson 时优先使用该方法
增加视频详情数据库缓存功能

Changed

下载页面改版，界面交互优化为缓存中/已缓存列表
优化已缓存界面展示播放逻辑，先通过-localVideos 方法从本地目录获取已缓存视频列表基本信息，再通过-requestDownloadCompleteList 方法获取已缓存视频列表详细信息，组合数据后分别用于本地视频播放与界面展示。详见demo。

Fixed

恢复HLS 加密视频zip 下载方式
mp4 / flv 等单文件视频下载，支持后台下载功能
PLVVodDownloadManager 中 -localVideos 方法bug修复，过滤未缓存完成的HLS 视频
播放器Ipad 横竖屏适配
部分源文件视频播放失败修复
断网后再联网，下载状态不正确问题修复
提升下载功能的整体稳定性

[2.4.1] - 2018-08-31

Added

播放器支持默认音频播放功能
PLVVodPlayerViewController，新增正常播放结束标志属性，用于判断播放器是正常播放结束，还是异常播放结束；
- @property (nonatomic, readonly) BOOL reachEndSuccess;
PLVVodPlayerViewController，新增播放恢复回调，播放异常结束后，该block每5s回调一次，在该block中可实现恢复播放逻辑;具体可参考PLVVodSkinPlayerController 文件中相关逻辑
- @property (nonatomic, copy) void (^playbackRecoveryHandle)(PLVVodPlayerViewController *player);

Fixed

码率切换，视频会重新播放
视频播放结束，不能区分是正常结束，还是异常结束
同一个播放器播放不同视频，不能准确记录各个视频的历史播放位置
断网状态播放离线视频，视频总时长显示错误
播放器解析的视频时长与videojson的视频时长不一致，导致错误记录历史播放位置，再次播放视频总是从最后几秒开始播放

[2.4.0] - 2018-07-16

Added

PLVVodDownloadManager，添加App 进入前台，后台状态时的方法，用于提升后台下载的稳定性；
- -applicationWillEnterForeground App 回到前台调用，具体参考AppDelegate 里面调用方式
- -applicationDidEnterBackground App 切换到后台调用，具体参考AppDelegate 里面调用方式

Fixed

优化下载逻辑，提升后台下载的稳定性

[2.3.3] - 2018-06-26

Added

PLVVodDownloadManager，添加App即将终止运行时的调用方法，修改并保存视频下载状态，用于App下次启动时恢复视频下载状态；
```
  + `-applicationWillTerminate`
```

Fixed

紧急修复视频下载过程中，App终止运行，再次启动App 后，下载列表视频状态不正确，且不能正常下载视频的问题
一般修复码率切换后，播放器倍速显示不匹配的问题

[2.3.0] - 2018-06-08

Added

增加音视频播放切换功能，具体用法参考 demo中 PLVVodSkinPlayerController 的例子

Fixed

解决断网状态，不能播放本地已经下载视频的bug

[2.2.0] - 2018-04-12

Added

PLVVodDownloadManager, 补充兼容 1.x.x 离线视频方法；
- -compatibleWithPreviousVideos

[2.1.0] - 2018-03-27

Added

PLVVodPlayerViewController，添加是否就绪播放回调；
- @property (nonatomic, copy) void (^preparedToPlayHandler)(PLVVodPlayerViewController *player);
PLVVodPlayerViewController，添加播放状态回调；
- @property (nonatomic, copy) void (^playbackStateHandler)(PLVVodPlayerViewController *player);
PLVVodPlayerViewController，添加加载状态回调；
- @property (nonatomic, copy) void (^loadStateHandler)(PLVVodPlayerViewController *player);
PLVVodPlayerViewController，添加播放结束回调；
- @property (nonatomic, copy) void (^reachEndHandler)(PLVVodPlayerViewController *player);

[2.0.0] - 2018-03-21

Changed

优化接口文档注释；
PLVVodPlayerViewController 中 autoContinue 命名更改为更为准确的 rememberLastPosition；

[2.0.0] - 2018-03-19

Changed

优化接口文档注释，为类、枚举、常量添加文档注释；

[2.0.0] - 2018-03-16

Added

问答增加错误注解、正确注解属性与逻辑；

Changed

优化切换视频时更新播放器状态值逻辑；
优化接口文档注释，添加默认值的描述；
优化自动播放逻辑；
更新版本号；

[0.0.5] - 2018-03-14

Added

添加错误类型“视频与账号不匹配”；
添加网络监测功能；
添加错误类型“网络不可达”；
为 viewlog、Qos 和错误收集建立缓存队列；

Changed

优化播放器界面布局；
优化广告播放器布局；
优化广告播放逻辑；
优化片头播放逻辑；
优化播放器事件回调；
优化下载管理器接口；
- - (void)requestDownloadInfosWithCompletion:(void (^)(NSMutableArray<PLVVodDownloadInfo *> *downloadInfos))completion; -> - (void)requestDownloadInfosWithCompletion:(void (^)(NSArray<PLVVodDownloadInfo *> *downloadInfos))completion;
优化自动续播逻辑；
优化广告状态回调；
优化无广告时的 UI；
优化 PLVVodVideo 接口；
添加 PLVVodVideo 对象描述；
PLVVodAd 实现 NSStringFromPLVVodAdType、NSStringFromPLVVodAdLocation 函数；
优化广告匹配逻辑，实现每种广告按照其所在的分类中回溯寻找、设置广告；
优化播放器跑马灯视图层级；
优化网络请求错误日志；
优化本地视频文件大小的获取；
优化移除下载任务逻辑；
PLVVodDownloadManager，enableBackgroundDownload 在 iOS 8 以上默认为 YES；
优化 PLVVodVideo 的 -available 判断逻辑；
优化 PLVVodDownloadManager 无法创建下载器时的错误回调；
优化 httpDNS 逻辑；
优化代码文档注释；

Removed

PLVVodPlayerViewController 去除冗余属性：enableSrt、srtKey；

Fixed

修复播放片头、广告内存不能释放问题；
修复播放器由于子类属性重名引起的定时器不能销毁释放问题；
修复直播转存视频类型判断错误导致的下载失败问题；
修复广告时长逻辑；
修复音量与播放器值不同步问题；
修复时间显示格式；
修复 -requestDownloadInfosWithCompletion: 死循环崩溃问题；

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

[2.21.1] - 2024-03-19

Changed

Fixed

迁移说明

[2.21.0] - 2024-01-05

Added

Changed

Fixed

迁移说明

[2.20.1] - 2023-10-30

Changed

迁移说明

[2.20.0] - 2023-09-01

Changed

Fixed

迁移说明

[2.19.1] - 2023-07-21

Changed

Fixed

迁移说明

[2.18.4] - 2023-03-15

Fixed

[2.18.3] - 2022-11-18

Changed

[2.18.1] - 2022-10-12

Changed

[2.18.0] - 2022-09-22

Changed

Fixed

[2.17.0] - 2022-09-05

Changed

[2.16.6] - 2022-04-06

Changed

Fixed

[2.16.5] - 2021-12-02

Changed

Fixed

[2.16.4] - 2021-10-10

Changed

Fixed

[2.16.3] - 2021-09-06

Changed

Fixed

[2.16.2] - 2021-08-06

Changed

Fixed

[2.16.1] - 2021-07-22

Changed

[2.16.0] - 2021-06-29

Changed

[2.15.2] - 2021-06-10

Changed

[2.15.1] - 2021-05-12

Changed

[2.15.0] - 2021-04-14

Changed

[2.14.1] - 2021-02-25

Changed

[2.14.0] - 2020-12-23

Changed

[2.13.1] - 2020-11-20

Changed

[2.13.0] - 2020-10-26

Changed

Fixed

[2.12.1] - 2020-10-19

Changed

Fixed

[2.12.0] - 2020-09-08

Changed

[2.11.0] - 2020-07-20

Changed

Fixed