11. 版本更新紀錄

本文件記錄 iOS 舊版點播 SDK（PolyvVodSDK）的版本更新內容，方便在整合或升級 SDK 時查看新增功能、最佳化項目、修復項目及遷移注意事項。

當前頁面已內嵌完整更新記錄，無需跳轉 GitHub 即可閱讀。如需核對原始檔案，可查看 GitHub CHANGELOG.md。

該專案已發佈在 CocoaPods 中，查看各版本可使用 pod trunk info PolyvVodSDK 命令。

[2.26.0] - 2026-05-16

新增功能

• 【SDK】增加播放鏈路日誌採集
• 【DEMO】影片畫面支援手勢縮放

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.25.3] - 2026-03-06

修復優化

• 【SDK】修復 iOS26 上拖動進度條後進度條不再更新的問題

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.25.2] - 2026-01-21

調整優化

• 【SDK】【日誌】優化日誌發送邏輯

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式已進行調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.25.1] - 2025-12-26

調整優化

• 【SDK】httpdns 預解析優化

修復優化

• 【SDK、DEMO】iOS 16 以下系統，倍速播放時觀看統計時長優化

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.25.0] - 2025-12-10

新增功能

• 【DEMO、SDK】支援動態域名調度

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.24.3] - 2025-11-14

新增功能

• 【DEMO、SDK】新增雪碧圖功能

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.24.2] - 2025-10-27

新增功能

• 【DEMO】接入自研投屏SDK

修復優化

• 【SDK】Elog 日誌特殊字元 bug 修復

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否遷移成功。

[2.24.1] - 2025-08-29

新增功能

• 【DEMO】倍速設定統一為7檔設定
• 【DEMO】字幕支援LaTex公式顯示

調整優化

• 【SDK】viewlog 統計優化，支援觀看完成度統計

修復優化

• 【SDK】音訊解碼偶發失敗問題

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.24.0] - 2025-06-30

新增功能

• 【DEMO】dlna 投屏，新增多播能力設定

調整最佳化

• 【SDK】QoS 統計最佳化
• 【SDK】QoS 新增 stalling 事件

修復優化

• 【SDK】多帳號模式下，升級至 2.19.0 以上版本，本地影片崩潰修復

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否遷移成功。

[2.23.0] - 2025-04-21

新增功能

• 【DEMO】增加播放線路配置面板
• 【DEMO、SDK】增加網路狀態監控恢復播放機制
• 【SDK】支援動態加密因子

調整最佳化

• 【DEMO、SDK】Xcode 16 適配
• 【DEMO】最佳化播放錯誤彈窗面板
• 【SDK】最佳化介面請求超時設定
• 【SDK】最佳化並啟用 httpdns 優選
• 【SDK】完善播放異常的日誌追溯能力
• 【DEMO、SDK】最佳化異常重試時可按當前進度播放
• 【SDK】PLVIJKPlayer 升級至 0.15.0 版本

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.22.4] - 2025-01-16

新增功能

• 【DEMO】新增播放器熱力圖、自訂標籤打點功能。（參考 PLVVodSkinPlayerController 類別的 updateSkin 方法）
• 【SDK】新增 enableTeaserBackgroundPlayback 屬性，優化片頭播放控制

@property (nonatomic, assign) BOOL enableTeaserBackgroundPlayback;

修復優化

• 【SDK】iOS 15 以下系統，2 倍速以上播放，觀看時長統計不正確問題修復

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.22.3] - 2024-11-28

新增功能

• 【SDK】新增 seek 完成回呼

/// seek完成回调
@property (nonatomic, copy) void (^seekCompleteHandler)(PLVVodPlayerViewController *player);

調整優化

• 【SDK】Elog 日誌統計優化

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的授權方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否遷移成功。

[2.22.2] - 2024-10-12

新增功能

• 【DEMO】防系統截圖功能演示

修復優化

• 【SDK】斷網播放本地影片，報錯參數優化

調整優化

• 【SDK】iOS 18 適配

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

[2.22.1] - 2024-07-18

修復優化

• 【SDK】影片遷移多帳號支援
• 【SDK】特定條件下記憶播放導致的崩潰修復

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否遷移成功。

[2.22.0] - 2024-06-07

新增功能

• 【Demo、SDK】支援跳過廣告

• 【Deme、SDK】子母畫面可隱藏快進快退按鈕

調整優化

• 【Demo】優化問答題目，可點擊選項選中答案
• 【Demo、SDK】字幕樣式同步播放器設定

修復優化

• 【Demo】修復與其他專案整合可能導致的衝突問題
• 【Demo、SDK】修復 uniapp 下載完成 3 個影片後不會繼續下載的問題
• 【SDK】修復切換倍速後切換清晰度或音訊導致倍速顯示錯誤的問題
• 【SDK】修復弱網環境下無法取得已下載的影片資訊

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

1. 從 2.21.1 升級到 2.22.0，需更新 demo 層
2. 舊版本升級至 2.22.0 版本的點播 SDK，需同步更新 2.22.0 版本的 Demo 層程式碼，以取得新增功能。
3. 若不適合直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.21.1] - 2024-03-19

調整優化

• 【SDK】httpdns 獲取 ipv4、ipv6 地址優化

修復優化

• 【SDK】部分 iPad 裝置開啟畫中畫崩潰修復
• 【SDK】廣告載入大型 GIF 圖片檔案失敗修復

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

1. 從 2.20.1 升級到 2.21.0，無需更新 Demo 層
2. 從舊版本升級至 2.21.0 版本的點播 SDK，需要同步更新 2.20.1 版本的 Demo 層程式碼，以獲得新增功能。
3. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.21.0] - 2024-01-05

新增功能

• 【SDK】播放器新增 seek 參數選項，優化 seek 體驗

調整優化

• 【SDK】播放連結動態域名配置，提升網路抗性

修復優化

• 【SDK】AB 串流影片下載失敗修復

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式已進行調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

1. 從 2.20.1 升級到 2.21.0，無需更新 Demo 層
2. 從舊版本升級至 2.21.0 版本的點播 SDK，需要同步更新 2.20.1 版本的 Demo 層程式碼，以獲得新增功能。
3. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.20.1] - 2023-10-30

調整最佳化

• 【SDK、Demo】Xcode15 與 iOS17 相容性適配

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

1. 從舊版本升級至 2.20.1 版本的點播 SDK，需同步更新 2.20.1 版本的 Demo 層程式碼，以取得本次新增功能。
2. 若不適合直接更新原始碼，可依據 diff 變動內容 檢視 Demo 層的變動，手動更新 Demo 層原始碼。

[2.20.0] - 2023-09-01

調整優化

• 【SDK、Demo】舊版跑馬燈移除
• 【SDK、Demo】優化問答提交統計
• 【Demo】優化跑馬燈顯示樣式
• 【SDK】支援溯源浮水印
• 【SDK】支援跨端續播

修復優化

• 【Demo】修復下載影片出現線路切換問題
• 【SDK】修復播放第三方URL影片seek失效的問題
• 【SDK】修復偶發性崩潰問題
• 【SDK】移除先前版本中未使用的imei欄位

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的驗證方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否成功遷移。

1. 舊版本升級至 2.20.0 版本的点播 SDK，需同步更新 2.20.0 版本的 Demo 層程式碼，以取得本次新增功能。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.19.1] - 2023-07-21

調整優化

• 【SDK】離線影片授權方式修改
• 【SDK】播放器支援設定起始播放位置

修復優化

• 【SDK】修復 userid 設為空值導致崩潰的問題
• 【SDK】修復部分影片音畫不同步問題
• 【SDK】重大安全性升級

遷移說明

從 2.18.x 及以下版本升級到 2.19.0 及以上版本時，請注意影片下載的遷移

自 2.19.0 版本開始，本地播放影片的授權方式進行了調整。為了在覆蓋升級時相容已下載的舊版本影片，初始化 SDK 時會自動進行遷移，必須嚴格測試本地快取影片是否遷移成功。

[2.18.4] - 2023-03-15

修復優化

• 【SDK】修復錯誤 token 引發的崩潰問題。
• 【SDK】修復偶發性崩潰問題。

注意：

1. 從舊版本升級至 2.18.4 版本的點播 SDK，建議同步更新 2.18.4 版本的 Demo 層程式碼，以獲得本次新增的功能。
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.18.3] - 2022-11-18

調整最佳化

• 【SDK】新增 vrm13 開關，最佳化播放體驗。
• 【SDK】vrm13 預設使用軟解。
• 【Demo】修正彈幕按鈕點擊無效果問題。

注意：

1. 從舊版本升級至 2.18.3 版本的點播 SDK，建議同步更新 2.18.3 版本的 Demo 層程式碼，以獲得本次新增的功能。
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.18.1] - 2022-10-12

調整優化

• 【SDK】新增支援系統子母畫面播放倍速功能
• 【SDK】新增支援HttpDNS動態開關功能
• 【SDK、Demo】新增支援軟硬解手動切換功能

注意：

1. 從舊版本升級至 2.18.1 版本的點播 SDK，建議同步更新 2.18.1 版本的 Demo 層程式碼，以獲得本次新增的功能。
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.18.0] - 2022-09-22

調整最佳化

• 【SDK】新增支援播放 vrm13 加密影片

修復優化

• 【SDK】修復連續切換影片時，首幀片頭不會消失的問題
• 【SDK】支援 bitcode 打包

注意：

1. 本次升級內容主要是 SDK 層，無需更新 Demo 層程式碼亦可。
2. 若需更新 Demo 原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.17.0] - 2022-09-05

調整最佳化

• 【Demo】使用慕享投屏SDK替換樂播投屏SDK
• 【Demo】適配iOS 16系統旋轉螢幕
• 【SDK】新增httpdns解析結果的日誌上報
• 【SDK】支援本地傳入token來播放加密影片
• 【SDK】支援系統級畫中畫觀看加密影片
• 【SDK】最佳化迴路濾波配置
• 【SDK】下載模組增加程式碼保護，防止崩潰情況
• 【SDK】修復請求所有下載任務不齊全的問題
• 【SDK】修復下載任務被提前釋放導致更新進度崩潰的問題

注意：

1. 從舊版本升級至 2.16.6 版本的點播 SDK，建議同步更新至 2.17.0 版本的 Demo 層程式碼，以獲得本次修復的功能。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.6] - 2022-04-06

調整最佳化

• 【SDK】播放器支援 https+ip 存取已開啟 SNI 驗證的伺服器
• 【SDK】最佳化 m3u8 影片錯誤重試機制
• 【SDK】新增 elog 錯誤資訊回報
• 【SDK】HttpDNS 新增鑑權功能
• 【SDK】初始化支援多個加密串同時使用

修復優化

• 【Demo】修復懸浮小窗播放影片時，旋轉螢幕出現黑框的問題。
• 【Demo】修復播放廣告影片後，跟隨系統螢幕關閉的問題。
• 【SDK】修復清晰度數量不符的問題。
• 【SDK】修復音訊模式播放導致的手勢失效問題。

注意：

1. 從舊版本升級至 2.16.6 版本的點播 SDK，建議同步更新 2.16.6 版本的 Demo 層程式碼，以獲得本次修復的功能。
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.5] - 2021-12-02

調整優化

• 【Demo】上傳影片支援自訂檔案名稱

修復優化

• 【Demo】修復閃爍雙跑馬燈顯示兩個跑馬燈的問題
• 【Demo】修復斷網後 seek 進度條無效果，斷網情況不允許 seek
• 【Demo】修復斷網後恢復網路，影片播放進度從 0 開始的問題
• 【SDK】修復斷網後恢復網路，偶現影片播放黑屏有聲音的問題

注意：

1. 舊版本升級至 2.16.5 版本的點播 SDK，建議同步更新 2.16.5 版本的 Demo 層程式碼，以獲得本次修復的功能。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.4] - 2021-10-10

調整優化

• 【Demo】跑馬燈2.0發布

修復優化

• 【SDK】修復開啟記憶播放功能時，切換清晰度/線路影響影片播放開始時間的問題
• 【Demo】修復影片未載入時，首幀圖片拉伸的問題
• 【Demo】修復劉海屏全螢幕播放時，遮擋鎖屏按鈕的問題

注意：

1. 從舊版本升級至 2.16.4 版本的点播 SDK，建議同步更新 2.16.4 版本的 Demo 層程式碼，以獲得本次更新的跑馬燈2.0功能。
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.3] - 2021-09-06

調整優化

• 【SDK】暫停廣告位置參數優化
• 【Demo】新增知識清單功能

修復優化

• 【SDK】修復音訊播放 seek 過程過長的問題

注意：

1. 從舊版本升級至 2.16.3 版本的点播 SDK，建議同步更新 2.16.3 版本的 Demo 層程式碼，以獲得本次更新的知識清單功能。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.2] - 2021-08-06

調整優化

• 【Demo】【SDK】新增系統音量控制
• 【Demo】【SDK】新增根據網路環境提示切換清晰度
• 【Demo】新增支援頂部/底部彈幕樣式

修復優化

• 【Demo】限制來源影片播放時不能切換畫質
• 【SDK】「準備」狀態的下載任務在呼叫停止下載方法後，狀態改為「停止」

注意：

1. 從舊版本升級至 2.16.2 版本的點播 SDK，建議同步更新 2.16.2 版本的 Demo 層程式碼，以獲得本次版本新增與修復的功能。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.1] - 2021-07-22

調整優化

• 【SDK】新增播放外部影片時記憶播放進度與續播功能
• 【SDK】新增自訂暫停廣告大小與位置的功能
• 【SDK】修復投屏的觀看日誌統計不到的問題
• 【SDK】修復請求下載中任務會出現下載完成任務的問題
• 【Demo】新增螢幕旋轉與全半螢幕狀態分離功能

注意：

1. 從舊版本升級至 2.16.1 版本的點播 SDK，建議同步更新 2.16.1 版本的 Demo 層程式碼，以獲得螢幕旋轉與全半螢幕狀態分離的能力。
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.16.0] - 2021-06-29

調整最佳化

• 【SDK】適配 DRM12 方案下的影片播放

注意：

1. 本次升級內容主要是 SDK 層，無需更新 Demo 層程式碼。

[2.15.2] - 2021-06-10

調整優化

• 【SDK】優化廣告播放規則，在有記憶進度的情況下可設定廣告是否跳過
• 【SDK】修復音訊時長比影片時長短的情況下，播放進度不更新的問題

注意：

1. 本次升級內容主要是 SDK 層，無需更新 Demo 層程式碼。

[2.15.1] - 2021-05-12

調整最佳化

• 【SDK】投屏URL的拼接移至SDK層
• 【SDK】投屏URL參數加入Base64處理最佳化
• 【SDK】FFMpeg打包瘦身
• 【SDK】修復影片片頭播放黑畫面的問題
• 【SDK】修復切換影片時，上一個影片的片頭會繼續播放的問題
• 【SDK】修復某些m3u8影片，無法seek到0、無法重播的問題
• 【SDK】修復背景狀態下，無網路恢復為4G網路情況引起崩潰的問題
• 【SDK】對齊Android SDK，修改SDK中網路請求的User-Agent
• 【Demo】投屏URL的取得由Demo層拼接改為從SDK取得

注意：

1. 從舊版本升級至 2.15.1 版本的點播 SDK，建議同步更新 2.15.1 版本的 Demo 層程式碼，以獲得投屏播放時的觀看統計功能。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.15.0] - 2021-04-14

調整優化

• 【SDK】新增影片禁播功能
• 【SDK】SDK 中的 HTTP 請求改為 HTTPS 請求
• 【SDK】解決部分直播轉存影片 seek 卡住的問題
• 【Demo】問答功能中選擇題的顯示優化、新增填空題型
• 【Demo】支援投屏的觀看統計

注意：

1. 從舊版本升級至 2.15.0 版本的点播 SDK，建議同步更新 2.15.0 版本的 Demo 層程式碼，以獲得最新的問答功能與投屏觀看統計
2. 若不方便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼

[2.14.1] - 2021-02-25

調整優化

• 【SDK】升級 PolyvAliHttpDNS 至 1.8.0 以上
• 【SDK】修復前後台切換影片播放黑畫面問題
• 【SDK】修復切換影片會從上一個影片播放時間開始的問題
• 【SDK】直播轉存影片 Seek 優化

注意：

1. 舊版本升級至 2.14.1 版本的點播 SDK，建議同步更新 2.14.1 版本的 Demo 層程式碼。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.14.0] - 2020-12-23

調整最佳化

• 【SDK】新增 IPV6 開關
• 【SDK】片頭邏輯最佳化
• 【Demo】增加禁止拖曳的提示資訊
• 【Demo】投放螢幕開始/結束時，啟動播放位置最佳化

注意：

1. 從舊版本升級至 2.14.0 版本的点播 SDK，建議同步更新 2.14.0 版本的 Demo 層程式碼。
2. 若不便直接更新原始碼，可根據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.13.1] - 2020-11-20

調整最佳化

• 【SDK】支援移除播放器已設定的跑馬燈

將播放器 PLVVodPlayerViewController 的跑馬燈屬性 marquee 設為 nil 時，會移除已設定的跑馬燈。

注意：

1. 本次升級內容主要是 SDK 層，無需更新 Demo 層程式碼。
2. 若原先專案程式碼中存在 self.marquee = nil 的情況，需做好程式碼保護，否則會視為移除跑馬燈處理。

[2.13.0] - 2020-10-26

調整最佳化

• 【SDK】升級 IJK 播放器依賴庫至 0.9.1，解決與客戶的 IJK 播放器衝突的問題

修復優化

• 【SDK】原始檔案下載 URL 更新

注意：

1. 本次升級內容主要是 SDK 層，無需更新 Demo 層程式碼。

[2.12.1] - 2020-10-19

調整優化

• 【Demo】升級 demo 依賴的第三方庫樂播投屏 SDK 版本號至 30226

修復優化

• 【SDK】修復取得全部下載任務列表時無法取得已下載任務的問題

[2.12.0] - 2020-09-08

調整優化

• 【Demo】將開源點播播放器 PLVVodSkinPlayerController 的佈局程式碼移至 Demo 層

• 【示範】png 圖片大小壓縮

注意：

1. 本次升級內容主要是 Demo 層的更新，若要取得本次升級內容，除了將 SDK 升級至 2.12.0 版本外，還需同步更新 2.12.0 版本的 Demo 層程式碼。
2. 若不適合直接更新原始碼，可依據 diff 變動內容 查看 Demo 層的變動，手動更新 Demo 層原始碼。

[2.11.0] - 2020-07-20

調整優化

• 【Demo】開放 PLVVodSkinPlayerController 的屬性 maxPosition 為公有屬性

修復優化

• 【Demo】修復部分機型無法投放螢幕的問題
• 【SDK】修復播放速率變為 0 的問題
• 【SDK】安全性升級

[2.10.0] - 2020-06-15

調整優化

• 【Demo】SDK 帳號加密串等統一在 PLVVodAccount 中定義

修復優化

• 【Demo】修復 vid 測試播放頁面輸入框被鍵盤擋住的 bug
• 【SDK】修復播放器全螢幕時偶發的崩潰
• 【SDK】修復記住上一次播放位置有時未生效的 bug

[2.9.1] - 2020-06-01

新增功能

• 【SDK】新增取得目前播放影片 pid 的方法與取得即時播放狀態的方法：

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

• 【SDK】根據後台設定控制 Viewlog 發送頻率，預設每 10 秒發送一次。

修復優化

• 【SDK】啟動 app 時 iOS 13.4 部分機型偶發性崩潰問題修復
• 【Demo】懸浮窗範例程式碼在橫豎螢幕切換時，懸浮窗比例發生變化問題修復，需同步更新懸浮窗開源程式碼（PolyvOpenSourceModule/Floating）

[2.9.0] - 2020-05-19

新增功能

• 【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

調整優化

• 【Demo】新增投屏功能巨集定義 PLVCastFeature
• 【SDK】移除依賴庫 PLVNetworkDiagnosisTool

修復優化

• 【Demo】修復手勢滑動播放器改變音量會不準確的問題
• 【SDK】支援播放 wav 格式的音訊檔案
• 【SDK】修復下載影片時偶發的線上崩潰
• 【SDK】修復記憶體洩漏導致的線上崩潰

[2.8.1] - 2020-05-08

修復優化

-【SDK】移除 UIWebView 相關內容 -【SDK】修復後台切換到前台時，介面會發生短暫卡頓的問題

[2.8.0] - 2020-03-31

新增功能

• 【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 下的開源程式碼到專案中

調整優化

• 【SDK】支援播放離線影片時彈出問答題目
• 【SDK】請求影片資源時區分下載與播放行為

修復優化

• 【Demo】關閉彈幕開關失效問題
• 【SDK】子執行緒中播放可能導致的崩潰問題

[2.7.1] - 2020-03-22

新增功能

• 【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;
  

調整最佳化

• 【SDK】支援 pod subspec 方式整合，可解決依賴庫衝突問題

修復優化

• 【SDK】子執行緒中銷毀播放器導致的崩潰問題

[2.7.0] - 2020-01-06

調整優化

• 【SDK】將依賴庫 PolyvIJKPlayer 更改為動態庫，同時，PolyvIJKPlayer 的 framework 套件名稱從 IJKMediaFramework 改為 PolyvIJKMediaFramework

[2.6.6] - 2020-01-06

新增功能

• 增加影片內容觀看時長的介面

• iOS 新增影片播放軟硬解設定介面

• 增加 seek 的 elog 統計事件

• 基於 appId 維度的流量數據統計

• PLVVodPlayerViewController ,

• @property (nonatomic, assign, readonly) NSTimeInterval videoContentPlayedTime; 觀看的影片內容時長
• @property (nonatomic, assign) BOOL isVideoToolBox; 預設硬解

調整優化

• 統一 viewlog params 的傳值方式
• 支援動態設定是否允許背景播放
• 子帳號簽名規則修改

修復優化

• [demo] iOS 13 下所有輸入框聯想提示無法選擇
• [demo] 解決與雲課堂 SDK 的衝突
• 確保播放器主執行緒播放，避免部分場景下 iOS 13 系統上崩潰

[2.6.5] - 2019-10-28

新增功能

• 支援三分割畫面播放

• 影片載入時顯示載入網速

• 增加當前播放進度回呼

• PLVVodPlayerViewController ,

• @property (nonatomic, assign) BOOL pptEnable; 三分屏功能開關
• @property (nonatomic, copy) void (^playbackProgressHandler)(PLVVodPlayerViewController *player, NSTimeInterval curPlayTime); 播放進度回呼

• PLVPPTSimpleDetailController：三分屏功能播放頁（DEMO）

調整優化

• 點播 viewlog 補充 flow 播放流量欄位
• vid 合法性判斷邏輯優化，優化錯誤提示

修復優化

• 清除下載目錄所有影片時，同時清除資料庫記錄
• 自動播放參數在 setURL 方法不生效問題修復

[2.6.4] - 2019-08-13

新增功能

• 點播子帳號支援

• 自訂片頭支援

• 本地問答功能支援

• 隨機更新自訂問答支援（示範）

• 發送彈幕介面增加回傳彈幕 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; 設定自訂片頭

調整優化

• m3u8 播放地址支援 httpdns 解析播放
• 跑馬燈支援設定固定時間間隔，更新至 0.0.4 版本

修復優化

• 部分影片播放結束時間與影片時長不一致問題修復
• 部分舊影片請求 Key 404 報錯問題修復

[2.6.3] - 2019-06-25

新增功能

• 增加離線播放發送 viewlog 日誌的開關

• 第三方影片播放，支援自訂請求標頭

• PLVVodPlayerViewController ,

• @property (nonatomic, assign) BOOL enableLocalViewLog 離線播放發送 viewlog
• - (void)setURL:(NSURL *)videoUrl withHeaders:(NSDictionary<NSString *, NSString *> *)headers; 第三方播放連結可自訂 header

調整優化

• 播放器網路錯誤的重試優化，提示優化
• SDK 發送 elog 錯誤日誌完善

修復優化

• 音訊播放模式，自動播放開關設定無效問題修復
• 橫豎螢幕切換，跑馬燈可能顯示在檢視區域外問題修復

[2.6.2] - 2019-05-20

• 新增影片上傳功能，整合方式 pod 'PLVVodUploadSDK', '~> 0.1.0'
• 詳細整合方式請參閱：iOS 上傳SDK 整合說明

[2.6.1] - 2019-05-20

新增功能

• 下載支援多帳號功能
• 本地影片播放支援顯示字幕
• 播放器提供顯示問答的介面
• 播放器新增方法取得影片寬高
• PLVVodDownloadManager ,
  • @property (nonatomic, assign) BOOL isMultiAccount 多帳號支援開關，預設為 NO
  • @property (nonatomic, copy) NSString *previousDownloadDir 單一帳號時所設定的影片下載目錄，用於舊帳號資料遷移到新帳號
  • -switchDownloadAccount 登入或切換到具體帳號
  • -logoutMultiAccount 登出目前帳號，登出後，會採用預設帳號進行下載相關操作
• PLVVodExam
  • +createExamWithDic 將問答資訊字典轉為 PLVVodExam 模型物件
  • +createExamArrayWithDicArray 將問答資訊字典陣列轉為 PLVVodExam 模型物件陣列
• PLVVodPlayerViewController
  • -getVideoSize 取得影片的寬高，在影片播放就緒後可取得數值

調整最佳化

• 直播轉存隨選，聊天室訊息以彈幕形式載入播放器
• 彈幕介面升級
• 增加播放失敗重試機制，自動切換碼率/切換線路
• 最佳化播放邏輯，高碼率影片尚未編碼成功時，自動切換至低碼率影片播放

修復優化

• 修復 QoS 緩衝區統計二次緩衝時間不準確的問題
• 修改資料庫預設路徑，解決儲存空間滿時資料庫可能被系統清理的問題
• 開闢新執行緒執行解壓縮操作，解決其他下載中影片資料接收回呼方法不執行的問題
• 修復網路狀態連續變化時可能引發的崩潰

[2.6.0] - 2019-05-15

新增功能

• 新增音訊檔案下載功能
• 影片播放時提示網路類型
• 新增影片解壓縮進度回呼
• 播放統計，新增 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;

調整最佳化

• 播放統計，音訊/影片/線路/碼率切換時統一觀看時長統計規則
• 預設開啟 httpdns 功能
• 最佳化 ATS 設定，httpdns 不依賴 ATS 設定；投影功能依賴 ATS 設定，需支援 HTTP 請求。具體設定請參考 Demo
• 問答區分單選與多選題型
• App 退到背景時，儲存當前播放進度

修復優化

• 問答解析窗在垂直畫布時佈局不正確；答題後旋轉螢幕，選項可能被遮擋；問答窗在iPad上被遮擋
• 問答點擊「跳過」，播放影片回退問題修復
• 問答窗，問題標題過長顯示不全
• 解決精準Seek下出現影片慢放問題
• 解決緩衝進度條閃動的問題

[2.5.6] - 2019-04-03

新增功能

• 新增播放器防錄影功能

• 播放器支援多線路切換

• 直式小視窗播放，支援自訂清晰度/線路倍速按鈕顯示

• 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 是否顯示清晰度按鈕

調整優化

• 影片播放前顯示影片封面圖
• 投屏元件增加註解、針對防錄影功能的使用時機進行註解說明、預設投屏按鈕隱藏（客戶使用投屏功能，只需解開註解即可）

修復優化

• 直式螢幕切換至橫式螢幕，跑馬燈始終顯示在中間不變化的問題修復
• 影片可播放但尚未開始播放，seek 失效的問題修復
• 刪除影片，資料庫記錄會重建的問題修復
• 刪除全部影片，autoStar 自動下載失效的問題修復

[2.5.5] - 2019-02-26

新增功能

• 播放器新增影片標記功能，具體實作請參考 demo
• PLVVodPlayerViewController，新增影片標記資訊點擊回呼，傳遞被選取的標記資訊索引
  • @property (nonatomic, copy) void (^videoTipsSelectedHandler)(NSUInteger tipIndex);
• PLVVodPlayerSkin ,
  • -addVideoPlayTips ， 新增影片標記資訊
  • -showVideoPlayTips，顯示影片標記資訊

• @property (nonatomic, copy) void(^plvVideoTipsPlayerBlock)(NSUInteger playIndex); 點擊標記資訊播放事件處理

修復優化

• 投屏功能 SDK 升級，部分錯誤修復

[2.5.4] - 2019-02-15

新增功能

• 播放器新增投射功能
• 播放器新增鎖定螢幕按鍵功能
• 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

調整最佳化

• ijkplayer 升級至 0.4.0 版本
• 播放音訊時顯示首圖
• 問答播放器最佳化
• 播放器點擊進度條，可 seek 至指定位置
• 切換清晰度時記住原播放速率最佳化
• 適配無 UI 音訊播放場景

修復優化

• 修復部分直播轉存影片播放完畢後重播失敗的問題
• 修復片頭/片頭廣告未播放完畢，切換影片時聲音重疊的問題
• 修復部分場景下導致 vid 為空而在 setVideo 時出現崩潰的問題

[2.5.3] - 2018-12-17

新增功能

• 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 陣列批量取得播放次數

調整優化

• Cocoapods 支援動態庫方式整合 SDK，解決與其他音視訊 SDK 部分衝突問題，整合方式：
  • pod 'PolyvVodSDK_Dylib'

修復優化

• 答題正確時，無法續播而是重新播放的問題已修復（Demo）
• 音訊模式下，從背景回到前景時，播放動畫停止的問題已修復（Demo）
• 長按皮膚功能設定按鈕後，播放器皮膚再也無法顯示的問題已修復（Demo）
• 斷點資料失效後，影片無法再次下載的問題已修復
• 播放器已退出，部分場景下仍會中斷第三方 App 背景播放的問題已修復

[2.5.2] - 2018-11-08

新增功能

• PLVVodPlayerViewController，支援URL播放影片，相容第三方平台影片播放
  • -setURL 透過URL播放/切換影片
• PLVVodPlayerUtil，新增播放器工具類別，提供播放進度、播放進度時間戳記取得方法
  • -lastPositionWithVid 透過vid取得上一次播放進度
  • -lastPositionTimestampWithVid 透過vid取得上一次播放進度時間戳記
• PLVVodPlayerViewController，新增循環播放屬性（暫不支援m3u8影片），適用短影片播放場景
  • @property (nonatomic, assign) BOOL enablePlayRecycle;
• PLVVodErrorUtil，Demo中新增錯誤處理工具類別，根據錯誤碼回傳錯誤提示，支援自訂錯誤提示
  • -getErrorMsgWithCode 根據錯誤碼回傳錯誤提示
• PLVVodServiceUtil，Demo中新增業務工具類別，提供相關擴充的API介面
  • -requestVideoListWithAccount 根據子帳戶、影片分類ID等參數，取得影片列表資訊

調整優化

• PLVVodVideo 模型 title 屬性修改為可讀寫，使用者可自訂設定 title
• 播放器音量調整，可選擇調整系統音量或播放器音量，請參閱 Demo 中 PLVVodSkinPlayerController 類別的音量調整邏輯

修復優化

• 1.0 升級至 2.0，已快取影片相容性問題修復
• 播放令牌介面，viewerId、viewerName 支援 base64 編碼，修復參數含中文字元時取得 token 失敗問題
• 同一播放器切換影片後，資料統計錯誤問題修復
• 非 ViewDidLoad 函式中初始化播放器，iPad 上崩潰問題修復

[2.5.1] - 2018-09-26

修復優化

• 呼叫 API 進行位元率切換，切換後影片會暫停播放的問題已修復
• 將影片加入下載佇列時，立即將記錄儲存至資料庫，解決退出 App 後有時無法儲存下載記錄的問題

[2.5.0] - 2018-09-17

新增功能

• 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 時優先使用此方法

• 增加影片詳細資料資料庫快取功能

調整最佳化

• 下載頁面改版，介面互動最佳化為快取中/已快取列表
• 最佳化已快取介面顯示播放邏輯，先透過 -localVideos 方法從本地目錄取得已快取影片列表基本資訊，再透過 -requestDownloadCompleteList 方法 取得已快取影片列表詳細資訊，組合資料後分別用於本地影片播放與介面顯示。詳見 demo。

修復優化

• 恢復 HLS 加密影片 zip 下載方式
• mp4 / flv 等單一檔案影片下載，支援背景下載功能
• PLVVodDownloadManager 中 -localVideos 方法錯誤修復，過濾未快取完成的 HLS 影片
• 播放器 iPad 橫豎螢幕適配
• 部分來源檔案影片播放失敗修復
• 斷網後重新連線，下載狀態不正確問題修復
• 提升下載功能的整體穩定性

[2.4.1] - 2018-08-31

新增功能

• 播放器支援預設音訊播放功能

• PLVVodPlayerViewController，新增正常播放結束標誌屬性，用於判斷播放器是正常播放結束，還是異常播放結束；

  • @property (nonatomic, readonly) BOOL reachEndSuccess;

• PLVVodPlayerViewController，新增播放恢復回呼，播放異常結束後，該 block 每 5 秒回呼一次，在此 block 中可實現恢復播放邏輯；具體可參考 PLVVodSkinPlayerController 檔案中的相關邏輯。

  • @property (nonatomic, copy) void (^playbackRecoveryHandle)(PLVVodPlayerViewController *player);

修復優化

• 碼率切換時，影片會重新播放
• 影片播放結束時，無法區分是正常結束還是異常結束
• 同一個播放器播放不同影片時，無法準確記錄各個影片的歷史播放位置
• 斷網狀態下播放離線影片，影片總時長顯示錯誤
• 播放器解析的影片時長與 videojson 的影片時長不一致，導致錯誤記錄歷史播放位置，再次播放影片時總是從最後幾秒開始播放

[2.4.0] - 2018-07-16

新增功能

• PLVVodDownloadManager，新增 App 進入前景、背景狀態時的方法，用於提升背景下載的穩定性；
  • -applicationWillEnterForeground App 回到前景時呼叫，具體請參考 AppDelegate 中的呼叫方式
  • -applicationDidEnterBackground App 切換到背景時呼叫，具體請參考 AppDelegate 中的呼叫方式

修復優化

• 優化下載邏輯，提升背景下載的穩定性

[2.3.3] - 2018-06-26

新增功能

• PLVVodDownloadManager，新增 App 即將終止執行時的呼叫方法，修改並儲存影片下載狀態，用於 App 下次啟動時恢復影片下載狀態；

    + `-applicationWillTerminate`
  

修復優化

• 緊急修復影片下載過程中，App 終止執行，再次啟動 App 後，下載列表影片狀態不正確，且無法正常下載影片的問題
• 一般修復碼率切換後，播放器倍速顯示不匹配的問題

[2.3.0] - 2018-06-08

新增功能

• 增加音視頻播放切換功能，具體用法請參考 demo 中 PLVVodSkinPlayerController 的範例

修復優化

• 解決斷網狀態下，無法播放本地已下載影片的錯誤

[2.2.0] - 2018-04-12

新增功能

• PLVVodDownloadManager, 補充相容 1.x.x 離線影片方法；
  • -compatibleWithPreviousVideos

[2.1.0] - 2018-03-27

新增功能

• 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

調整優化

• 優化介面文件註解；
• PLVVodPlayerViewController 中的 autoContinue 命名更改為更準確的 rememberLastPosition；

[2.0.0] - 2018-03-19

調整優化

• 優化介面文件註解，為類別、列舉、常數添加文件註解；

[2.0.0] - 2018-03-16

新增功能

• 問答新增錯誤註解、正確註解屬性與邏輯；

調整優化

• 優化切換影片時更新播放器狀態值的邏輯；
• 優化介面文件註解，新增預設值的描述；
• 優化自動播放邏輯；
• 更新版本號；

[0.0.5] - 2018-03-14

新增功能

• 新增錯誤類型「影片與帳號不匹配」；
• 新增網路監測功能；
• 新增錯誤類型「網路不可達」；
• 為 viewlog、Qos 及錯誤收集建立快取佇列；

調整最佳化

• 最佳化播放器介面佈局；
• 最佳化廣告播放器佈局；
• 最佳化廣告播放邏輯；
• 最佳化片頭播放邏輯；
• 最佳化播放器事件回呼；
• 最佳化下載管理器介面；
  • - (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 邏輯；
• 最佳化程式碼文件註解；

移除內容

• PLVVodPlayerViewController 移除冗餘屬性：enableSrt、srtKey；

修復優化

• 修復播放片頭、廣告記憶體無法釋放問題；
• 修復播放器因子類別屬性同名導致的計時器無法銷毀釋放問題；
• 修復直播轉存影片類型判斷錯誤導致的下載失敗問題；
• 修復廣告時長邏輯；
• 修復音量與播放器值不同步問題；
• 修復時間顯示格式；
• 修復 -requestDownloadInfosWithCompletion: 無窮迴圈崩潰問題；