update

Author: swiftuiux

README.md

@@ -28,7 +28,7 @@ The player's functionality is designed around a dual ⇆ interaction model:
 
 - **Commands and Settings**: Through these, you instruct the player on what to do and how to do it. Settings define the environment and initial state, while commands offer real-time control. As for now, you can conveniently pass command by command; perhaps later I’ll add support for batch commands
 
-- **Event Feedback**: Through event handling, the player communicates back to the application, informing it of internal changes that may need attention. Due to the nature of media players, especially in environments with dynamic content or user interactions, the flow of events can become flooded. To manage this effectively and prevent the application from being overwhelmed by the volume of incoming events, the **system collects these events every second and returns them as a batch**. Pass `Events([])` in the `settings` to enable event mechanism.
+- **Event Feedback**: Through event handling, the player communicates back to the application, informing it of internal changes that may need attention. Due to the nature of media players, especially in environments with dynamic content or user interactions, the flow of events can become flooded. To manage this effectively and prevent the application from being overwhelmed by the volume of incoming events, the **system collects these events every second and returns them as a batch**. Pass `Events()` in the `settings` to enable event mechanism.
 
 ## [Documentation(API)](https://swiftpackageindex.com/swiftuiux/swiftui-loop-videoplayer/main/documentation/swiftui_loop_videoplayer)
 
@@ -134,7 +134,7 @@ Please note that using videos from URLs requires ensuring that you have the righ
 | **NotAutoPlay** | Indicates if the video should not play after initialization. Notice that if you use `command` as a control flow for the player the start command should be `.idle` | false |
 | **EnableVector** | Use this struct to activate settings that allow the addition of vector-based overlays via commands. If it is not passed via settings, any commands to `addVector` or `removeAllVectors` will have no effect. | Not Enabled |
 |**PictureInPicture**| Enable Picture-in-Picture (PiP) support. If not passed than any command like `startPiP` or `stopPiP` have no effect. Take a look the example app *Video11.swift*. It does not work on simulator. You can observe the feature only on real devices.| - |
-| **Events([.durationAny, .itemStatusChangedAny])** | If `Events([])` is not passed in the `settings: VideoSettings`, the event mechanism is disabled. You can specify exactly which events you want to receive (e.g., .itemStatusChangedAny) or simply pass `Events([])` to receive all available events. This setting was added to improve performance because events are emitted via @State changes, which trigger view updates. If you don’t need to observe any events, disabling them can significantly boost performance. Take a look on the implementation in the example app *Video8.swift* | - |
+| **Events([.durationAny, .itemStatusChangedAny])** | If `Events([])` is not passed in the `settings: VideoSettings`, the event mechanism is disabled. You can specify exactly which events you want to receive (e.g., .itemStatusChangedAny) or simply pass `Events()` to receive all available events. This setting was added to improve performance because events are emitted via @State changes, which trigger view updates. If you don’t need to observe any events, disabling them can significantly boost performance. Take a look on the implementation in the example app *Video8.swift* | - |
 
 ### Additional Notes on Settings
 

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

@@ -21,7 +21,7 @@ public enum Setting: Equatable, SettingsConvertible{
         [self]
     }
 
-    case events([PlayerEventFilter])
+    case events([PlayerEventFilter]?)
 
     ///Enable vector layer to add overlay vector graphics
     case vector

Sources/swiftui-loop-videoplayer/settings/Events.swift

@@ -11,12 +11,12 @@ import Foundation
 public struct Events: SettingsConvertible{
 
     /// Holds the specific AVLayerVideoGravity setting defining how video content should align within its layer.
-    private let value : [PlayerEventFilter]
+    private let value : [PlayerEventFilter]?
 
     // MARK: - Life circle
 
     /// Initializes a new instance
-    public init(_ value : [PlayerEventFilter]) {
+    public init(_ value : [PlayerEventFilter]? = nil) {
         self.value = value
     }
 

Sources/swiftui-loop-videoplayer/utils/VideoSettings.swift

@@ -117,7 +117,18 @@ public struct VideoSettings: Equatable{
 
         vector = settings.contains(.vector)
 
-        events = settings.fetch(by : "events", defaulted: nil)
+        let hasEvents = settings.contains {
+            if case .events = $0 {
+                return true
+            }
+            return false
+        }
+        
+        if hasEvents{
+            events = settings.fetch(by : "events", defaulted: []) ?? []
+        }else{
+            events = nil
+        }
     }
 }