

XLVideoPlayer 是一個以 AVFoundation 為基礎打造的自訂影片播放器。它支援在 UITableViewCell 中進行小窗播放,也能切換至全螢幕,並提供手動與螢幕旋轉兩種切換方式。此外,播放器還能保留右下角小窗懸停播放,整體設計盡量降低對 View Controller 與第三方框架的依賴。
在 AVFoundation 體系中,幾個常用類別各司其職:

XLVideoPlayer 本身繼承自 UIView,並將 AVPlayerLayer 加入自身的 layer 中。透過這樣的結構,播放器可以獨立封裝,方便嵌入列表、詳情頁或懸浮視窗。
初始化時,會先建立 AVPlayerItem,再將其交給 AVPlayer。完成後,播放器會註冊進度與狀態觀察,以便即時更新畫面上的播放資訊。
播放器會透過定時觀察回呼更新目前播放時間與總長度,並在影片結束時決定要觸發完成事件,或回到起始點循環播放。這樣的設計讓它能同時適應一般播放與連續播放場景。
此外,播放器會監聽 AVPlayerItem 的 status 與 loadedTimeRanges。前者用於判斷是否可播放,後者則反映網路緩衝進度,讓使用者能看到載入狀態與緩衝進度。
當使用者拖動進度條時,建議先暫停播放,避免手動定位與自動播放進度互相衝突。拖曳結束後,再將播放器跳到目標時間並恢復播放。這個細節能讓互動更順暢,也能避免進度條與實際播放位置不同步。
在早期實作中,若想強制旋轉畫面,常會使用狀態列方向或裝置方向相關 API。但隨著 iOS 版本演進,這些方式出現相容性問題,部分 API 也被 Apple 收斂。若在 iOS 8 以上直接旋轉,可能會出現 UIScreen 未同步、部分區域無法點擊,甚至返回 App 後畫面錯位等狀況。


較穩定的做法之一是透過鍵值編碼設定裝置方向,讓播放器在需要時切換為橫向。不過,這類寫法仍屬於需要謹慎使用的彈性方案,實際專案中仍建議依需求與系統版本充分測試。
整體來說,XLVideoPlayer 的價值在於展示如何以 AVFoundation 為核心,逐步打造具備小窗、全螢幕、進度控制與懸停播放能力的播放器。若你正在實作類似功能,可以從它的結構與細節中獲得不少參考。