added new commands loop and unloop

Author: swiftuiux

README.md

@@ -26,6 +26,8 @@ Please note that using videos from URLs requires ensuring that you have the righ
 | `init(settings: () -> VideoSettings, command:)` | Constructor | Initializes the player with a declarative settings block and playback command binding. |
 
 
+### Playback Commands
+
 ### Playback Commands
 
 | Command                     | Description                                                                                                                                          |
@@ -40,6 +42,8 @@ Please note that using videos from URLs requires ensuring that you have the righ
 | `volume(Float)`             | Command to adjust the volume of the video playback. The `volume` parameter is a `Float` value between 0.0 (mute) and 1.0 (full volume). If a value outside this range is passed, it will be clamped to the nearest valid value (0.0 or 1.0). |
 | `subtitles(String?)`        | Command to set subtitles to a specified language or turn them off. Pass a language code (e.g., "en" for English) to set subtitles, or `nil` to turn them off. |
 | `playbackSpeed(Float)`      | Command to adjust the playback speed of the video. The `speed` parameter is a `Float` value representing the playback speed (e.g., 1.0 for normal speed, 0.5 for half speed, 2.0 for double speed). If a negative value is passed, it will be clamped to 0.0. |
+| `loop`                      | Command to enable looping of the video playback. By default, looping is enabled, so this command will have no effect if looping is already active.     |
+| `unloop`                    | Command to disable looping of the video playback. This command will only take effect if the video is currently being looped.                                                                |
 
 
 ### Initializer Parameters Settings

Sources/swiftui-loop-videoplayer/enum/PlaybackCommand.swift

@@ -1,10 +1,3 @@
-//
-//  PlaybackCommand.swift
-//
-//
-//  Created by Igor Shelopaev on 06.08.24.
-//
-
 import AVFoundation
 
 /// An enumeration of possible playback commands.
@@ -44,23 +37,26 @@ public enum PlaybackCommand: Equatable {
     /// Command to set the playback speed of the video playback.
     /// - Parameter speed: A `Float` value representing the playback speed (e.g., 1.0 for normal speed, 0.5 for half speed, 2.0 for double speed).
     case playbackSpeed(Float)
+    
+    /// Command to enable looping of the video playback.
+    case loop
+    
+    /// Command to disable looping of the video playback.
+    case unloop
 
     public static func == (lhs: PlaybackCommand, rhs: PlaybackCommand) -> Bool {
         switch (lhs, rhs) {
-        case (.play, .play):
-            return true
-        case (.pause, .pause):
+        case (.play, .play),
+             (.pause, .pause),
+             (.begin, .begin),
+             (.end, .end),
+             (.mute, .mute),
+             (.unmute, .unmute),
+             (.loop, .loop),
+             (.unloop, .unloop):
             return true
         case (.seek(let lhsTime), .seek(let rhsTime)):
             return lhsTime == rhsTime
-        case (.begin, .begin):
-            return true
-        case (.end, .end):
-            return true
-        case (.mute, .mute):
-            return true
-        case (.unmute, .unmute):
-            return true
         case (.volume(let lhsVolume), .volume(let rhsVolume)):
             return lhsVolume == rhsVolume
         case (.subtitles(let lhsLanguage), .subtitles(let rhsLanguage)):

Sources/swiftui-loop-videoplayer/protocol/view/AbstractPlayer.swift

@@ -10,6 +10,10 @@ import Foundation
 
 @available(iOS 14, macOS 11, tvOS 14, *)
 public protocol AbstractPlayer: AnyObject{
+    
+    /// The looper responsible for continuous video playback.
+    var playerLooper: AVPlayerLooper? { get set }
+    
     /// The queue player that plays the video items.
     var player: AVQueuePlayer? { get set }
 
@@ -155,6 +159,34 @@ extension AbstractPlayer{
         }
     }
 
+    /// Enables looping for the current video item.
+    /// This method sets up the `playerLooper` to loop the currently playing item indefinitely.
+    func loop() {
+        guard let player = player, let currentItem = player.currentItem else {
+            return
+        }
+
+        // Check if the video is already being looped
+        if playerLooper != nil {
+            return // Already looped, no need to loop again
+        }
+
+        // Initialize the player looper with the current item
+        playerLooper = AVPlayerLooper(player: player, templateItem: currentItem)
+    }
+    
+    /// Disables looping for the current video item.
+    /// This method removes the `playerLooper`, stopping the loop.
+    func unloop() {
+        // Check if the video is not looped (i.e., playerLooper is nil)
+        guard playerLooper != nil else {
+            return // Not looped, no need to unloop
+        }
+
+        playerLooper?.disableLooping()
+        playerLooper = nil
+    }
+    
     /// Sets the playback command for the video player.
     /// - Parameter value: The `PlaybackCommand` to set. This can be one of the following:
     ///   - `play`: Command to play the video.
@@ -167,28 +199,34 @@ extension AbstractPlayer{
     ///   - `volume`: Command to adjust the volume of the video playback.
     ///   - `subtitles`: Command to set subtitles to a specified language or turn them off.
     ///   - `playbackSpeed`: Command to adjust the playback speed of the video.
-   func setCommand(_ value: PlaybackCommand) {
-       switch value {
-       case .play:
-           play()
-       case .pause:
-           pause()
-       case .seek(to: let time):
-           seek(to: time)
-       case .begin:
-           seekToStart()
-       case .end:
-           seekToEnd()
-       case .mute:
-           mute()
-       case .unmute:
-           unmute()
-       case .volume(let volume):
-           setVolume(volume)
-       case .subtitles(let language):
-           setSubtitles(to: language)
-       case .playbackSpeed(let speed):
-           setPlaybackSpeed(speed)
-       }
-   }
+    ///   - `loop`: Command to enable looping of the video playback.
+    ///   - `unloop`: Command to disable looping of the video playback.
+    func setCommand(_ value: PlaybackCommand) {
+        switch value {
+        case .play:
+            play()
+        case .pause:
+            pause()
+        case .seek(to: let time):
+            seek(to: time)
+        case .begin:
+            seekToStart()
+        case .end:
+            seekToEnd()
+        case .mute:
+            mute()
+        case .unmute:
+            unmute()
+        case .volume(let volume):
+            setVolume(volume)
+        case .subtitles(let language):
+            setSubtitles(to: language)
+        case .playbackSpeed(let speed):
+            setPlaybackSpeed(speed)
+        case .loop:
+            loop()
+        case .unloop:
+            unloop()
+        }
+    }
 }

Sources/swiftui-loop-videoplayer/protocol/view/LoopingPlayerProtocol.swift

@@ -28,9 +28,6 @@ public protocol LoopingPlayerProtocol: AbstractPlayer{
         var layer : CALayer? { get set }
         var wantsLayer : Bool { get set }
     #endif
-    
-    /// The looper responsible for continuous video playback.
-    var playerLooper: AVPlayerLooper? { get set }
 
     /// The delegate to be notified about errors encountered by the player.
     var delegate: PlayerErrorDelegate? { get set }
@@ -101,6 +98,7 @@ extension LoopingPlayerProtocol {
 
         // Replace the current item with a new item created from the asset
         let newItem = AVPlayerItem(asset: asset)
+        unloop()
         player?.replaceCurrentItem(with: newItem)
 
         // Seek to the beginning of the item if you want to start from the start
@@ -157,9 +155,7 @@ extension LoopingPlayerProtocol {
         wantsLayer = true
         #endif
 
-        if let firstItem = player.items().first {
-            playerLooper = AVPlayerLooper(player: player, templateItem: firstItem)
-        }
+        loop()
         player.play()
     }