Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

Commit dbc9a95

Browse files
update
1 parent bb59ece commit dbc9a95

File tree

7 files changed

+173
-4
lines changed

7 files changed

+173
-4
lines changed

‎README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,8 @@ Please note that using videos from URLs requires ensuring that you have the righ
134134
| **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 |
135135
| **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 |
136136
|**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.|
137+
|**Events([.durationAny, .itemStatusChangedAny])**| if `Events` is not passed then events mecanism is disabled. You can specify wich events you'd like to receave like `.itemStatusChangedAny` or simply passed `.all` and receave any avalble events. This settings added to improve performance as events emition soes via @State change that triggers view update if you don't need observe any events then disabled events improve performance significantly | - |
138+
| Events([.durationAny, .itemStatusChangedAny]) | If Events is not passed, the event mechanism is disabled. You can specify exactly which events you want to receive (e.g., .itemStatusChangedAny) or simply pass .all 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* | - |
137139

138140
### Additional Notes on Settings
139141

@@ -274,6 +276,8 @@ video_main.m3u8
274276

275277
## Player Events
276278

279+
*If Events is not passed in the settings, the event mechanism is disabled. You can specify exactly which events you want to receive (e.g., .itemStatusChangedAny) or simply pass .all 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.*
280+
277281
| Event | Description |
278282
|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
279283
| `seek(Bool, currentTime: Double)` | Represents an end seek action within the player. The first parameter (`Bool`) indicates whether the seek was successful, and the second parameter (`currentTime`) provides the time (in seconds) to which the player is seeking. |

‎Sources/swiftui-loop-videoplayer/ExtVideoPlayer.swift‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,9 +106,24 @@ public struct ExtVideoPlayer: View{
106106
currentTime = time
107107
})
108108
.onReceive(eventPublisher.collect(.byTime(DispatchQueue.main, .seconds(1))), perform: { event in
109-
playerEvent = event
109+
settings.events
110+
playerEvent = filterEvents(with: settings, for: event)
110111
})
111112
.preference(key: CurrentTimePreferenceKey.self, value: currentTime)
112113
.preference(key: PlayerEventPreferenceKey.self, value: playerEvent)
113114
}
114115
}
116+
117+
fileprivate func filterEvents(with settings: VideoSettings, for events: [PlayerEvent]) -> [PlayerEvent] {
118+
let filters = settings.events // `[PlayerEventFilter]`
119+
120+
// If no filters are provided, return an empty array (or all events—your choice).
121+
guard !filters.isEmpty else {
122+
return []
123+
}
124+
125+
// Keep each `PlayerEvent` only if it matches *at least* one filter in `filters`.
126+
return events.filter { event in
127+
filters.contains(event)
128+
}
129+
}

‎Sources/swiftui-loop-videoplayer/enum/PlayerEvent.swift‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import AVFoundation
1111
/// An enumeration representing various events that can occur within a media player.
1212
@available(iOS 14.0, macOS 11.0, tvOS 14.0, *)
1313
public enum PlayerEvent: Equatable {
14-
14+
1515
/// Represents an end seek action within the player.
1616
/// - Parameters:
1717
/// - Bool: Indicates whether the seek was successful.
Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
//
2+
// PlayerEventFilter.swift
3+
// swiftui-loop-videoplayer
4+
//
5+
// Created by Igor on 12.02.25.
6+
//
7+
8+
import Foundation
9+
10+
/// A "parallel" structure for filtering PlayerEvent.
11+
/// Each case here:
12+
/// 1) Either ignores associated values (xxxAny)
13+
/// 2) Or matches cases that have no associated values in PlayerEvent.
14+
@available(iOS 14.0, macOS 11.0, tvOS 14.0, *)
15+
public enum PlayerEventFilter {
16+
/// Matches any `.seek(...)` case, regardless of Bool or currentTime
17+
case seekAny
18+
19+
/// Matches `.paused` exactly (no associated values)
20+
case paused
21+
22+
/// Matches `.waitingToPlayAtSpecifiedRate` (no associated values)
23+
case waitingToPlayAtSpecifiedRate
24+
25+
/// Matches `.playing` (no associated values)
26+
case playing
27+
28+
/// Matches any `.currentItemChanged(...)` case
29+
case currentItemChangedAny
30+
31+
/// Matches `.currentItemRemoved` exactly (no associated values)
32+
case currentItemRemoved
33+
34+
/// Matches any `.volumeChanged(...)` case
35+
case volumeChangedAny
36+
37+
/// Matches any `.error(...)` case
38+
case errorAny
39+
40+
/// Matches any `.boundsChanged(...)` case
41+
case boundsChangedAny
42+
43+
/// Matches `.startedPiP` (no associated values)
44+
case startedPiP
45+
46+
/// Matches `.stoppedPiP` (no associated values)
47+
case stoppedPiP
48+
49+
/// Matches any `.itemStatusChanged(...)` case
50+
case itemStatusChangedAny
51+
52+
/// Matches any `.duration(...)` case
53+
case durationAny
54+
55+
/// Matches every possible event
56+
case all
57+
}
58+
59+
extension PlayerEventFilter {
60+
/// Checks whether a given `PlayerEvent` matches this filter.
61+
///
62+
/// - Parameter event: The `PlayerEvent` to inspect.
63+
/// - Returns: `true` if the event belongs to this case (ignoring parameters), `false` otherwise.
64+
func matches(_ event: PlayerEvent) -> Bool {
65+
switch (self, event) {
66+
/// Universal case
67+
case (.all, _):
68+
return true
69+
70+
// Compare by case name only, ignoring associated values
71+
case (.seekAny, .seek):
72+
return true
73+
case (.paused, .paused):
74+
return true
75+
case (.waitingToPlayAtSpecifiedRate, .waitingToPlayAtSpecifiedRate):
76+
return true
77+
case (.playing, .playing):
78+
return true
79+
case (.currentItemChangedAny, .currentItemChanged):
80+
return true
81+
case (.currentItemRemoved, .currentItemRemoved):
82+
return true
83+
case (.volumeChangedAny, .volumeChanged):
84+
return true
85+
case (.errorAny, .error):
86+
return true
87+
case (.boundsChangedAny, .boundsChanged):
88+
return true
89+
case (.startedPiP, .startedPiP):
90+
return true
91+
case (.stoppedPiP, .stoppedPiP):
92+
return true
93+
case (.itemStatusChangedAny, .itemStatusChanged):
94+
return true
95+
case (.durationAny, .duration):
96+
return true
97+
98+
// Default fallback: no match
99+
default:
100+
return false
101+
}
102+
}
103+
}
104+
105+
extension Collection where Element == PlayerEventFilter {
106+
/// Checks whether any filter in this collection matches the given `PlayerEvent`.
107+
///
108+
/// - Parameter event: The `PlayerEvent` to test.
109+
/// - Returns: `true` if at least one `PlayerEventFilter` in this collection matches the `event`; otherwise, `false`.
110+
func contains(_ event: PlayerEvent) -> Bool {
111+
return self.contains { filter in
112+
filter.matches(event)
113+
}
114+
}
115+
}

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@ public enum Setting: Equatable, SettingsConvertible{
2121
[self]
2222
}
2323

24+
case events([PlayerEventFilter])
25+
2426
///Enable vector layer to add overlay vector graphics
2527
case vector
2628

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
//
2+
// Events.swift
3+
//
4+
//
5+
// Created by Igor Shelopaev on 14.01.25.
6+
//
7+
8+
import Foundation
9+
10+
@available(iOS 14.0, macOS 11.0, tvOS 14.0, *)
11+
public struct Events: SettingsConvertible{
12+
13+
/// Holds the specific AVLayerVideoGravity setting defining how video content should align within its layer.
14+
private let value : [PlayerEventFilter]
15+
16+
// MARK: - Life circle
17+
18+
/// Initializes a new instance
19+
public init(_ value : [PlayerEventFilter]) {
20+
self.value = value
21+
}
22+
23+
/// Fetch settings
24+
@_spi(Private)
25+
public func asSettings() -> [Setting] {
26+
[.events(value)]
27+
}
28+
}

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

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,9 @@ public struct VideoSettings: Equatable{
3535
/// Enable vector layer to add overlay vector graphics
3636
public let vector: Bool
3737

38+
/// Disable events
39+
public let events: [PlayerEventFilter]
40+
3841
/// Don't auto play video after initialization
3942
public let notAutoPlay: Bool
4043

@@ -72,7 +75,7 @@ public struct VideoSettings: Equatable{
7275
/// - enableVector: A Boolean indicating whether vector graphics rendering should be enabled for overlays.
7376
///
7477
/// All parameters must be provided, except `timePublishing`, which can be `nil`, and `enableVector`, which defaults to `false`.
75-
public init(name: String, ext: String, subtitles: String, loop: Bool, pictureInPicture: Bool, mute: Bool, notAutoPlay: Bool, timePublishing: CMTime?, gravity: AVLayerVideoGravity, enableVector : Bool = false) {
78+
public init(name: String, ext: String, subtitles: String, loop: Bool, pictureInPicture: Bool, mute: Bool, notAutoPlay: Bool, timePublishing: CMTime?, gravity: AVLayerVideoGravity, enableVector : Bool = false, events :[PlayerEventFilter]=[]) {
7679
self.name = name
7780
self.ext = ext
7881
self.subtitles = subtitles
@@ -83,6 +86,7 @@ public struct VideoSettings: Equatable{
8386
self.timePublishing = timePublishing
8487
self.gravity = gravity
8588
self.vector = enableVector
89+
self.events = events
8690
self.unique = true
8791
}
8892

@@ -112,6 +116,8 @@ public struct VideoSettings: Equatable{
112116
notAutoPlay = settings.contains(.notAutoPlay)
113117

114118
vector = settings.contains(.vector)
119+
120+
events = settings.fetch(by : "events", defaulted: [])
115121
}
116122
}
117123

@@ -145,4 +151,3 @@ fileprivate func check(_ settings : [Setting]) -> Bool{
145151
let set = Set(cases)
146152
return cases.count == set.count
147153
}
148-

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /