FEC-10653 Add bufferedTime to the BasicPlayer Protocol

Classes/Player/Decorators/PlayerDecoratorBase.swift

@@ -160,6 +160,10 @@ import AVKit
         return self.player.loadedTimeRanges
     }
 
+    @objc public var bufferedTime: TimeInterval {
+        return self.player.bufferedTime
+    }
+
     open func play() {
         self.player.play()
     }

Classes/Player/PKEvent.swift

@@ -89,7 +89,7 @@ public extension PKEvent {
         return self.data?[EventDataKeys.bitrate] as? NSNumber
     }
 
-    /// Current Bitrate Value, PKEvent Data Accessor
+    /// The PlaybackInfo object, PKEvent Data Accessor
     @objc var playbackInfo: PKPlaybackInfo? {
         return self.data?[EventDataKeys.playbackInfo] as? PKPlaybackInfo
     }
@@ -122,12 +122,12 @@ public extension PKEvent {
         return self.data?[EventDataKeys.metadata] as? [AVMetadataItem]
     }
 
-    /// Content url, PKEvent Data Accessor
+    /// The MediaSource object, PKEvent Data Accessor
     @objc var mediaSource: PKMediaSource? {
         return self.data?[EventDataKeys.mediaSource] as? PKMediaSource
     }
 
-    /// Content url, PKEvent Data Accessor
+    /// The loaded time ranges, PKEvent Data Accessor
     @objc var timeRanges: [PKTimeRange]? {
         return self.data?[EventDataKeys.timeRanges] as? [PKTimeRange]
     }

Classes/Player/PlayerController.swift

@@ -221,6 +221,10 @@ class PlayerController: NSObject, Player {
         return self.currentPlayer.loadedTimeRanges
     }
 
+    public var bufferedTime: TimeInterval {
+        return self.currentPlayer.bufferedTime
+    }
+
     private func shouldDVRLivePlayFromLiveEdge() -> Bool {
         if let pausedPosition = liveDVRPausedPosition, currentTime == 0 {
             let timePassed: TimeInterval = Date().timeIntervalSince(pausedPosition.date)

Classes/Player/PlayerEngineWrapper.swift

@@ -110,6 +110,10 @@ public class PlayerEngineWrapper: NSObject, PlayerEngine {
         return playerEngine?.loadedTimeRanges
     }
 
+    public var bufferedTime: TimeInterval {
+        return playerEngine?.bufferedTime ?? self.currentTime
+    }
+
     public func loadMedia(from mediaSource: PKMediaSource?, handler: AssetHandler) {
         playerEngine?.loadMedia(from: mediaSource, handler: handler)
     }

Classes/Player/PlayerWrapper/AVPlayerWrapper.swift

@@ -194,6 +194,18 @@ open class AVPlayerWrapper: NSObject, PlayerEngine {
         return self.currentPlayer.currentItem?.loadedTimeRanges.map { PKTimeRange(timeRange: $0.timeRangeValue) }
     }
 
+    public var bufferedTime: TimeInterval {
+        if let loadedTimeRanges = self.loadedTimeRanges {
+            for timeRange in loadedTimeRanges {
+                if currentTime.isLess(than: timeRange.end) {
+                    return timeRange.end
+                }
+            }
+        }
+
+        return currentTime
+    }
+
     public func play() {
         if #available(iOS 10.0, tvOS 10.0, *), let shouldPlayImmediately = settings?.shouldPlayImmediately, shouldPlayImmediately == true {
             self.currentPlayer.playImmediately(atRate: 1.0)

Classes/Player/PlayerWrapper/DefaultPlayerWrapper.swift

@@ -129,6 +129,11 @@ class DefaultPlayerWrapper: NSObject, PlayerEngine {
         return nil
     }
 
+    public var bufferedTime: TimeInterval {
+        printInvocationWarning("\(#function)")
+        return 0.0
+    }
+
     func play() {
         printInvocationWarning("\(#function)")
     }

Classes/Player/Protocols/BasicPlayer.swift

@@ -45,6 +45,9 @@ import Foundation
     /// Provides a collection of time ranges for which the player has the media data readily available. The ranges provided might be discontinuous.
     @objc var loadedTimeRanges: [PKTimeRange]? { get }
 
+    /// The current player's buffered time.
+    @objc var bufferedTime: TimeInterval { get }
+
     /// Send a play action for the player.
     @objc func play()