react-native-theoplayer 11.5.0 → 11.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/CHANGELOG.md +12 -1
  2. package/README.md +1 -0
  3. package/android/src/main/java/com/theoplayer/PlayerEventEmitter.kt +9 -0
  4. package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +58 -85
  5. package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +3 -0
  6. package/android/src/main/java/com/theoplayer/media/MediaControlModule.kt +102 -0
  7. package/android/src/main/java/com/theoplayer/media/MediaControlProxy.kt +376 -0
  8. package/android/src/main/java/com/theoplayer/media/MediaNotificationBuilder.kt +78 -34
  9. package/android/src/main/java/com/theoplayer/media/MediaPlaybackService.kt +53 -20
  10. package/android/src/main/java/com/theoplayer/media/MediaSessionConfig.kt +6 -6
  11. package/android/src/main/java/com/theoplayer/media/MediaSessionConfigAdapter.kt +23 -20
  12. package/android/src/main/java/com/theoplayer/player/PlayerModule.kt +0 -1
  13. package/android/src/main/java/com/theoplayer/presentation/PipUtils.kt +98 -93
  14. package/android/src/main/java/com/theoplayer/util/ReadableExtension.kt +14 -0
  15. package/android/src/main/res/drawable/ic_next.xml +9 -0
  16. package/android/src/main/res/drawable/ic_prev.xml +9 -0
  17. package/android/src/main/res/values/strings.xml +4 -0
  18. package/ios/THEOplayerRCTBridge.m +16 -0
  19. package/ios/THEOplayerRCTDebug.swift +3 -0
  20. package/ios/THEOplayerRCTMainEventHandler.swift +17 -0
  21. package/ios/THEOplayerRCTTypeUtils.swift +30 -0
  22. package/ios/THEOplayerRCTView.swift +15 -5
  23. package/ios/backgroundAudio/THEOplayerRCTBackgroundAudioManager.swift +1 -1
  24. package/ios/backgroundAudio/THEOplayerRCTNowPlayingManager.swift +49 -3
  25. package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift +151 -68
  26. package/ios/backgroundAudio/THEOplayerRCTView+MediaControlConfig.swift +25 -11
  27. package/ios/mediaControl/THEOplayerRCTMediaControlAPI.swift +79 -0
  28. package/ios/mediaControl/THEOplayerRCTMediaControlManager.swift +38 -0
  29. package/ios/pip/THEOplayerRCTPipControlsManager.swift +9 -12
  30. package/lib/commonjs/api/event/PlayerEvent.js +8 -0
  31. package/lib/commonjs/api/event/PlayerEvent.js.map +1 -1
  32. package/lib/commonjs/api/media/MediaControlAPI.js +14 -0
  33. package/lib/commonjs/api/media/MediaControlAPI.js.map +1 -0
  34. package/lib/commonjs/api/media/barrel.js +11 -0
  35. package/lib/commonjs/api/media/barrel.js.map +1 -1
  36. package/lib/commonjs/api/player/PlayerEventMap.js +1 -0
  37. package/lib/commonjs/api/player/PlayerEventMap.js.map +1 -1
  38. package/lib/commonjs/api/player/THEOplayer.js.map +1 -1
  39. package/lib/commonjs/internal/THEOplayerView.js +4 -0
  40. package/lib/commonjs/internal/THEOplayerView.js.map +1 -1
  41. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js +6 -0
  42. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
  43. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +9 -9
  44. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  45. package/lib/commonjs/internal/adapter/WebEventForwarder.js +5 -0
  46. package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
  47. package/lib/commonjs/internal/adapter/event/PlayerEvents.js +7 -1
  48. package/lib/commonjs/internal/adapter/event/PlayerEvents.js.map +1 -1
  49. package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js +42 -0
  50. package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
  51. package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js +32 -0
  52. package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
  53. package/lib/commonjs/internal/adapter/web/WebMediaSession.js +78 -16
  54. package/lib/commonjs/internal/adapter/web/WebMediaSession.js.map +1 -1
  55. package/lib/commonjs/manifest.json +1 -1
  56. package/lib/module/api/event/PlayerEvent.js +9 -0
  57. package/lib/module/api/event/PlayerEvent.js.map +1 -1
  58. package/lib/module/api/media/MediaControlAPI.js +10 -0
  59. package/lib/module/api/media/MediaControlAPI.js.map +1 -0
  60. package/lib/module/api/media/barrel.js +1 -0
  61. package/lib/module/api/media/barrel.js.map +1 -1
  62. package/lib/module/api/player/PlayerEventMap.js +1 -0
  63. package/lib/module/api/player/PlayerEventMap.js.map +1 -1
  64. package/lib/module/api/player/THEOplayer.js.map +1 -1
  65. package/lib/module/internal/THEOplayerView.js +5 -1
  66. package/lib/module/internal/THEOplayerView.js.map +1 -1
  67. package/lib/module/internal/adapter/THEOplayerAdapter.js +6 -0
  68. package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
  69. package/lib/module/internal/adapter/THEOplayerWebAdapter.js +9 -9
  70. package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  71. package/lib/module/internal/adapter/WebEventForwarder.js +6 -1
  72. package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
  73. package/lib/module/internal/adapter/event/PlayerEvents.js +5 -0
  74. package/lib/module/internal/adapter/event/PlayerEvents.js.map +1 -1
  75. package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js +37 -0
  76. package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
  77. package/lib/module/internal/adapter/media/MediaControlWebAdapter.js +27 -0
  78. package/lib/module/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
  79. package/lib/module/internal/adapter/web/WebMediaSession.js +78 -16
  80. package/lib/module/internal/adapter/web/WebMediaSession.js.map +1 -1
  81. package/lib/module/manifest.json +1 -1
  82. package/lib/typescript/api/event/PlayerEvent.d.ts +9 -0
  83. package/lib/typescript/api/event/PlayerEvent.d.ts.map +1 -1
  84. package/lib/typescript/api/media/MediaControlAPI.d.ts +30 -0
  85. package/lib/typescript/api/media/MediaControlAPI.d.ts.map +1 -0
  86. package/lib/typescript/api/media/MediaControlConfiguration.d.ts +5 -1
  87. package/lib/typescript/api/media/MediaControlConfiguration.d.ts.map +1 -1
  88. package/lib/typescript/api/media/barrel.d.ts +1 -0
  89. package/lib/typescript/api/media/barrel.d.ts.map +1 -1
  90. package/lib/typescript/api/player/PlayerEventMap.d.ts +7 -2
  91. package/lib/typescript/api/player/PlayerEventMap.d.ts.map +1 -1
  92. package/lib/typescript/api/player/THEOplayer.d.ts +5 -0
  93. package/lib/typescript/api/player/THEOplayer.d.ts.map +1 -1
  94. package/lib/typescript/internal/THEOplayerView.d.ts +1 -0
  95. package/lib/typescript/internal/THEOplayerView.d.ts.map +1 -1
  96. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts +3 -1
  97. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
  98. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +3 -2
  99. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
  100. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts +1 -0
  101. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
  102. package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts +4 -1
  103. package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts.map +1 -1
  104. package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts +1 -0
  105. package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts.map +1 -1
  106. package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts +12 -0
  107. package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts.map +1 -0
  108. package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts +14 -0
  109. package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts.map +1 -0
  110. package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts +10 -3
  111. package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts.map +1 -1
  112. package/package.json +3 -3
  113. package/react-native-theoplayer.podspec +1 -1
  114. package/src/api/event/PlayerEvent.ts +10 -0
  115. package/src/api/media/MediaControlAPI.ts +33 -0
  116. package/src/api/media/MediaControlConfiguration.ts +5 -1
  117. package/src/api/media/barrel.ts +1 -0
  118. package/src/api/player/PlayerEventMap.ts +7 -0
  119. package/src/api/player/THEOplayer.ts +6 -0
  120. package/src/internal/THEOplayerView.tsx +8 -0
  121. package/src/internal/adapter/THEOplayerAdapter.ts +9 -0
  122. package/src/internal/adapter/THEOplayerWebAdapter.ts +12 -9
  123. package/src/internal/adapter/WebEventForwarder.ts +7 -0
  124. package/src/internal/adapter/event/PlayerEvents.ts +10 -0
  125. package/src/internal/adapter/event/native/NativePlayerEvent.ts +2 -0
  126. package/src/internal/adapter/media/MediaControlNativeAdapter.ts +38 -0
  127. package/src/internal/adapter/media/MediaControlWebAdapter.ts +28 -0
  128. package/src/internal/adapter/web/WebMediaSession.ts +85 -21
  129. package/src/manifest.json +1 -1
  130. package/android/src/main/java/com/theoplayer/media/MediaQueueNavigator.kt +0 -33
@@ -7,10 +7,21 @@ import MediaPlayer
7
7
  class THEOplayerRCTNowPlayingManager {
8
8
  // MARK: Members
9
9
  private weak var player: THEOplayer?
10
+ private weak var view: THEOplayerRCTView?
10
11
  private let nowPlayingQueue = DispatchQueue(label: "com.theoplayer.reactnative.nowplayinginfo")
11
12
  private var nowPlayingInfoStorage = [String : Any]()
12
13
  private var nowPlayingInfoGeneration: Int = 0
13
14
 
15
+ // The player that most recently published Now Playing info to the process-wide info center.
16
+ // Used to scope clearing so a disabled player only clears its own info and never clobbers
17
+ // another (newly-active) owner during a multi-player hand-off.
18
+ private static weak var currentOwner: THEOplayerRCTNowPlayingManager?
19
+
20
+ // MARK: computed
21
+ private var mediaSessionEnabled: Bool {
22
+ self.view?.mediaControlConfig.mediaSessionEnabled ?? DEFAULT_MEDIA_SESSION_ENABLED
23
+ }
24
+
14
25
  // MARK: player Listeners
15
26
  private var durationChangeListener: EventListener?
16
27
  private var playingListener: EventListener?
@@ -32,14 +43,20 @@ class THEOplayerRCTNowPlayingManager {
32
43
 
33
44
  // clear nowPlayingInfo
34
45
  self.clearNowPlayingInfoStorage()
35
- self.clearNowPlayingInfoOnInfoCenter()
46
+ if self.mediaSessionEnabled {
47
+ self.clearNowPlayingInfoOnInfoCenter()
48
+ } else {
49
+ // Disabled player being destroyed: still clean up, but only if it owns the shared info.
50
+ self.clearNowPlayingIfOwner()
51
+ }
36
52
 
37
53
  if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE][NOWPLAYINGINFO] Destroy, nowPlayingInfo cleared on infoCenter.") }
38
54
  }
39
55
 
40
56
  // MARK: - player setup / breakdown
41
- func setPlayer(_ player: THEOplayer) {
57
+ func setPlayer(_ player: THEOplayer, view: THEOplayerRCTView?) {
42
58
  self.player = player;
59
+ self.view = view
43
60
 
44
61
  // attach listeners
45
62
  self.attachListeners()
@@ -67,6 +84,13 @@ class THEOplayerRCTNowPlayingManager {
67
84
  // Reset any existing playing info; this invalidates any artwork fetch still in flight
68
85
  let generation = self.clearNowPlayingInfoStorage()
69
86
 
87
+ // When the media session is disabled we must not publish, nor unconditionally clear (that would
88
+ // clobber another active owner). Only clear if this player currently owns the shared info.
89
+ guard self.mediaSessionEnabled else {
90
+ self.clearNowPlayingIfOwner()
91
+ return
92
+ }
93
+
70
94
  // Gather new playing info
71
95
  if let player = self.player,
72
96
  let sourceDescription = player.source,
@@ -78,7 +102,7 @@ class THEOplayerRCTNowPlayingManager {
78
102
  self.updateAlbum(metadata.metadataKeys?["album"] as? String)
79
103
  self.updateDuration(player.duration)
80
104
  self.updateMediaType() // video
81
- self.updatePlaybackRate(player.playbackRate)
105
+ self.updatePlaybackRate(player.paused ? 0 : player.playbackRate)
82
106
  self.updateServiceIdentifier(metadata.metadataKeys?["nowPlayingServiceIdentifier"] as? String)
83
107
  self.updateContentIdentifier(metadata.metadataKeys?["nowPlayingContentIdentifier"] as? String)
84
108
  self.updateCurrentTime(player.currentTime)
@@ -133,8 +157,11 @@ class THEOplayerRCTNowPlayingManager {
133
157
  }
134
158
 
135
159
  private func processNowPlayingInfoToInfoCenter() {
160
+ guard self.mediaSessionEnabled else { return }
136
161
  let nowPlayingInfo = self.getNowPlayingInfoStorage()
137
162
  if !nowPlayingInfo.isEmpty {
163
+ // This player is now publishing to the shared info center: claim ownership.
164
+ THEOplayerRCTNowPlayingManager.currentOwner = self
138
165
  Task { @MainActor in
139
166
  MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
140
167
  if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE][NOWPLAYINGINFO] nowPlayingInfo processed to infoCenter.") }
@@ -149,7 +176,26 @@ class THEOplayerRCTNowPlayingManager {
149
176
  }
150
177
 
151
178
  private func clearNowPlayingInfoOnInfoCenter() {
179
+ guard self.mediaSessionEnabled else { return }
180
+ if THEOplayerRCTNowPlayingManager.currentOwner === self {
181
+ THEOplayerRCTNowPlayingManager.currentOwner = nil
182
+ }
183
+ self.performClearOnInfoCenter()
184
+ }
185
+
186
+ /// Clear the shared Now Playing info only if this player currently owns it. Bypasses the
187
+ /// mediaSessionEnabled guard so a player can clean up its own info at the moment it is disabled,
188
+ /// without clobbering another (newly-active) owner during a multi-player hand-off.
189
+ private func clearNowPlayingIfOwner() {
190
+ guard THEOplayerRCTNowPlayingManager.currentOwner === self else { return }
191
+ THEOplayerRCTNowPlayingManager.currentOwner = nil
192
+ self.performClearOnInfoCenter()
193
+ }
194
+
195
+ private func performClearOnInfoCenter() {
152
196
  Task { @MainActor in
197
+ // Avoid redundant clears (and their log noise) when the info center is already empty.
198
+ guard MPNowPlayingInfoCenter.default().nowPlayingInfo?.isEmpty == false else { return }
153
199
  MPNowPlayingInfoCenter.default().nowPlayingInfo = nil
154
200
  if DEBUG_NOWINFO { PrintUtils.printLog(logText: "[NATIVE][NOWPLAYINGINFO] clearing nowPlayingInfo (to nil) on infoCenter.") }
155
201
 
@@ -7,10 +7,11 @@ import MediaPlayer
7
7
  class THEOplayerRCTRemoteCommandsManager: NSObject {
8
8
  // MARK: Members
9
9
  private weak var player: THEOplayer?
10
+ private weak var view: THEOplayerRCTView?
10
11
  private var isLive: Bool = false
11
12
  private var inAd: Bool = false
12
13
  private var hasSource: Bool = false
13
- private var mediaControlConfig = MediaControlConfig()
14
+ private var commandsRegistered: Bool = false
14
15
 
15
16
  // MARK: player Listeners
16
17
  private var durationChangeListener: EventListener?
@@ -18,98 +19,168 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
18
19
  private var adBreakBeginListener: EventListener?
19
20
  private var adBreakEndListener: EventListener?
20
21
 
22
+ // MARK: computed
23
+ private var mediaSessionEnabled: Bool {
24
+ self.view?.mediaControlConfig.mediaSessionEnabled ?? DEFAULT_MEDIA_SESSION_ENABLED
25
+ }
26
+ private var seekToLiveOnResume: Bool {
27
+ self.view?.mediaControlConfig.seekToLiveOnResume ?? DEFAULT_SEEK_TO_LIVE_ON_RESUME
28
+ }
29
+ private var skipForwardInterval: NSNumber {
30
+ NSNumber(value: self.view?.mediaControlConfig.skipForwardInterval ?? DEFAULT_SKIP_INTERVAL)
31
+ }
32
+ private var skipBackwardInterval: NSNumber {
33
+ NSNumber(value: self.view?.mediaControlConfig.skipBackwardInterval ?? DEFAULT_SKIP_INTERVAL)
34
+ }
35
+ private var allowLivePlayPause: Bool {
36
+ self.view?.mediaControlConfig.allowLivePlayPause ?? DEFAULT_ALLOW_LIVE_PLAY_PAUSE
37
+ }
38
+
21
39
  // MARK: - destruction
22
40
  func destroy() {
23
41
  // dettach listeners
24
42
  self.dettachListeners()
43
+ // remove our targets from the shared command center
44
+ self.removeCommandTargets()
25
45
  }
26
46
 
27
47
  // MARK: - player setup / breakdown
28
- func setPlayer(_ player: THEOplayer) {
48
+ func setPlayer(_ player: THEOplayer, view: THEOplayerRCTView?) {
29
49
  self.player = player;
50
+ self.view = view;
30
51
  self.initRemoteCommands()
31
52
 
32
53
  // attach listeners
33
54
  self.attachListeners()
34
55
  }
35
56
 
36
- func setMediaControlConfig(_ newMediaControlConfig: MediaControlConfig) {
37
- self.mediaControlConfig = newMediaControlConfig
38
- self.updateRemoteCommands()
39
- }
40
-
41
57
  private func initRemoteCommands() {
42
58
  self.isLive = false
43
59
  self.inAd = false
44
60
  self.hasSource = false
61
+ // Register/deregister targets and apply the correct enabled state based on the current config.
62
+ // Note: MPRemoteCommandCenter is a process-wide singleton shared by all player instances, so we
63
+ // must not touch its state here for a player that doesn't own the media session.
64
+ self.updateRemoteCommands()
65
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands initialised.") }
66
+ }
67
+
68
+ private func addCommandTargets() {
69
+ guard !self.commandsRegistered else { return }
45
70
  let commandCenter = MPRemoteCommandCenter.shared()
46
-
47
- commandCenter.playCommand.isEnabled = false
48
- commandCenter.pauseCommand.isEnabled = false
49
- commandCenter.togglePlayPauseCommand.isEnabled = false
50
- commandCenter.stopCommand.isEnabled = false
51
- commandCenter.changePlaybackPositionCommand.isEnabled = false
52
- commandCenter.skipForwardCommand.isEnabled = false
53
- commandCenter.skipBackwardCommand.isEnabled = false
54
- commandCenter.previousTrackCommand.isEnabled = false
55
- commandCenter.nextTrackCommand.isEnabled = false
56
-
57
- // PLAY
58
- commandCenter.playCommand.addTarget(self, action: #selector(onPlayCommand(_:)))
59
- // PAUSE
60
- commandCenter.pauseCommand.addTarget(self, action: #selector(onPauseCommand(_:)))
61
- // PLAY/PAUSE
62
- commandCenter.togglePlayPauseCommand.addTarget(self, action: #selector(onTogglePlayPauseCommand(_:)))
71
+ // NOTE: play/pause/togglePlayPause are (re)registered separately via reclaimPlayPauseCommands(),
72
+ // because the THEOplayer SDK adds its own play/pause targets to every player instance and we must
73
+ // strip those to keep remote play/pause scoped to the active player only.
63
74
  // STOP
64
75
  commandCenter.stopCommand.addTarget(self, action: #selector(onStopCommand(_:)))
65
76
  // SCRUBBER
66
77
  commandCenter.changePlaybackPositionCommand.addTarget(self, action: #selector(onScrubCommand(_:)))
67
- // ADD SEEK FORWARD
68
- commandCenter.skipForwardCommand.preferredIntervals = [NSNumber(value: self.mediaControlConfig.skipForwardInterval)]
78
+ // SEEK FORWARD
69
79
  commandCenter.skipForwardCommand.addTarget(self, action: #selector(onSkipForwardCommand(_:)))
70
- // ADD SEEK BACKWARD
71
- commandCenter.skipBackwardCommand.preferredIntervals = [NSNumber(value: self.mediaControlConfig.skipBackwardInterval)]
80
+ // SEEK BACKWARD
72
81
  commandCenter.skipBackwardCommand.addTarget(self, action: #selector(onSkipBackwardCommand(_:)))
73
- // ADD NEXT TRACK
82
+ // NEXT TRACK
74
83
  commandCenter.nextTrackCommand.addTarget(self, action: #selector(onNextTrackCommand(_:)))
75
- // ADD PREVIOUS TRACK
84
+ // PREVIOUS TRACK
76
85
  commandCenter.previousTrackCommand.addTarget(self, action: #selector(onPreviousTrackCommand(_:)))
77
-
78
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands initialised.") }
86
+ self.commandsRegistered = true
87
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote command targets added.") }
88
+ }
89
+
90
+ /// Take exclusive ownership of the play/pause/togglePlayPause remote commands.
91
+ ///
92
+ /// The THEOplayer SDK registers its own play/pause handlers on the shared MPRemoteCommandCenter for
93
+ /// EVERY player instance at creation (via initAudioSession -> setupRemoteTransportControls). With
94
+ /// multiple players this makes a single remote play/pause control all instances. We therefore remove
95
+ /// all targets (SDK's and any stale ones) and re-add only this active player's handlers.
96
+ private func reclaimPlayPauseCommands() {
97
+ let commandCenter = MPRemoteCommandCenter.shared()
98
+ commandCenter.playCommand.removeTarget(nil)
99
+ commandCenter.pauseCommand.removeTarget(nil)
100
+ commandCenter.togglePlayPauseCommand.removeTarget(nil)
101
+ commandCenter.playCommand.addTarget(self, action: #selector(onPlayCommand(_:)))
102
+ commandCenter.pauseCommand.addTarget(self, action: #selector(onPauseCommand(_:)))
103
+ commandCenter.togglePlayPauseCommand.addTarget(self, action: #selector(onTogglePlayPauseCommand(_:)))
104
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Reclaimed play/pause commands from SDK for active player.") }
105
+ }
106
+
107
+ private func removeCommandTargets() {
108
+ guard self.commandsRegistered else { return }
109
+ let commandCenter = MPRemoteCommandCenter.shared()
110
+ commandCenter.playCommand.removeTarget(self)
111
+ commandCenter.pauseCommand.removeTarget(self)
112
+ commandCenter.togglePlayPauseCommand.removeTarget(self)
113
+ commandCenter.stopCommand.removeTarget(self)
114
+ commandCenter.changePlaybackPositionCommand.removeTarget(self)
115
+ commandCenter.skipForwardCommand.removeTarget(self)
116
+ commandCenter.skipBackwardCommand.removeTarget(self)
117
+ commandCenter.nextTrackCommand.removeTarget(self)
118
+ commandCenter.previousTrackCommand.removeTarget(self)
119
+ self.commandsRegistered = false
120
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote command targets removed.") }
121
+ }
122
+
123
+ private func hasActionHandler(for action: MediaControlAction) -> Bool {
124
+ return self.view?.mediaControlManager.hasMediaControlActionHandler(for: action) ?? false
125
+ }
126
+
127
+ private func executeAction(for action: MediaControlAction) -> Bool {
128
+ return self.view?.mediaControlManager.executeMediaControlAction(action: action) ?? false
79
129
  }
80
130
 
81
131
  func updateRemoteCommands() {
82
132
  let commandCenter = MPRemoteCommandCenter.shared()
83
133
 
84
- let skipControlsEnabled = self.hasSource && !self.inAd && !self.isLive
85
- let playPauseControlsEnabled = self.hasSource && !self.inAd && (!self.isLive || mediaControlConfig.allowLivePlayPause)
134
+ // Only the player that owns the media session may participate. When disabled, withdraw this
135
+ // player's command handlers entirely and leave the shared command center untouched so we don't
136
+ // respond to remote commands nor clobber the active player's command state.
137
+ guard self.mediaSessionEnabled else {
138
+ self.removeCommandTargets()
139
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands disabled: withdrew from shared command center.") }
140
+ return
141
+ }
142
+
143
+ // Ensure this player's command handlers are registered on the shared command center.
144
+ self.addCommandTargets()
145
+ // Take play/pause ownership away from the SDK's per-instance handlers so remote play/pause only
146
+ // affects this (active) player.
147
+ self.reclaimPlayPauseCommands()
148
+
149
+ let playPauseControlsEnabled = self.hasSource && !self.inAd && (!self.isLive || self.allowLivePlayPause)
150
+ let positionControlEnabled = self.hasSource && !self.inAd && !self.isLive
151
+ let seekControlEnabled = self.hasSource && !self.inAd && !self.isLive && !self.hasActionHandler(for: .SKIP_TO_NEXT) && !self.hasActionHandler(for: .SKIP_TO_PREVIOUS)
152
+ let trackControlEnabled = self.hasActionHandler(for: .SKIP_TO_NEXT) && self.hasActionHandler(for: .SKIP_TO_PREVIOUS)
86
153
 
87
154
  // update the enabled state to have correct visual representation in the lockscreen
88
155
  commandCenter.pauseCommand.isEnabled = playPauseControlsEnabled
89
156
  commandCenter.playCommand.isEnabled = playPauseControlsEnabled
90
157
  commandCenter.togglePlayPauseCommand.isEnabled = playPauseControlsEnabled
91
158
  commandCenter.stopCommand.isEnabled = playPauseControlsEnabled
92
- commandCenter.changePlaybackPositionCommand.isEnabled = skipControlsEnabled
93
- commandCenter.skipForwardCommand.isEnabled = skipControlsEnabled
94
- commandCenter.skipBackwardCommand.isEnabled = skipControlsEnabled
95
- commandCenter.nextTrackCommand.isEnabled = skipControlsEnabled
96
- commandCenter.previousTrackCommand.isEnabled = skipControlsEnabled
159
+ commandCenter.changePlaybackPositionCommand.isEnabled = positionControlEnabled
160
+ commandCenter.skipForwardCommand.isEnabled = seekControlEnabled
161
+ commandCenter.skipBackwardCommand.isEnabled = seekControlEnabled
162
+ commandCenter.nextTrackCommand.isEnabled = trackControlEnabled
163
+ commandCenter.previousTrackCommand.isEnabled = trackControlEnabled
97
164
 
98
165
  // set configured skip forward/backward intervals
99
- commandCenter.skipForwardCommand.preferredIntervals = [NSNumber(value: self.mediaControlConfig.skipForwardInterval)]
100
- commandCenter.skipBackwardCommand.preferredIntervals = [NSNumber(value: self.mediaControlConfig.skipBackwardInterval)]
166
+ commandCenter.skipForwardCommand.preferredIntervals = [self.skipForwardInterval]
167
+ commandCenter.skipBackwardCommand.preferredIntervals = [self.skipBackwardInterval]
101
168
 
102
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands updated for \(self.isLive ? "LIVE" : "VOD") (ALLOWLIVEPLAYPAUSE: \(mediaControlConfig.allowLivePlayPause)) (\(self.inAd ? "AD IS PLAYING" : "NO AD PLAYING")).") }
169
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Remote commands updated for \(self.isLive ? "LIVE" : "VOD") (ALLOWLIVEPLAYPAUSE: \(self.view?.mediaControlConfig.allowLivePlayPause ?? false)) (\(self.inAd ? "AD IS PLAYING" : "NO AD PLAYING")).") }
103
170
  }
104
171
 
105
172
  @objc private func onPlayCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
173
+ guard self.mediaSessionEnabled else { return .commandFailed }
106
174
  if let player = self.player,
107
175
  !self.inAd {
108
- if self.isLive && self.mediaControlConfig.seekToLiveOnResume {
176
+ if self.isLive && self.seekToLiveOnResume {
109
177
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Seek to live.") }
110
178
  player.currentTime = .infinity
111
179
  }
112
- player.play()
180
+ if !self.executeAction(for: .PLAY) {
181
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Executing default Play action.") }
182
+ player.play()
183
+ }
113
184
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command handled.") }
114
185
  } else {
115
186
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Play command not handled.") }
@@ -118,9 +189,13 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
118
189
  }
119
190
 
120
191
  @objc private func onPauseCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
192
+ guard self.mediaSessionEnabled else { return .commandFailed }
121
193
  if let player = self.player,
122
194
  !self.inAd {
123
- player.pause()
195
+ if !self.executeAction(for: .PAUSE) {
196
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Executing default Pause action.") }
197
+ player.pause()
198
+ }
124
199
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command handled.") }
125
200
  } else {
126
201
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Pause command not handled.") }
@@ -129,19 +204,26 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
129
204
  }
130
205
 
131
206
  @objc private func onTogglePlayPauseCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
207
+ guard self.mediaSessionEnabled else { return .commandFailed }
132
208
  if let player = self.player,
133
209
  !self.inAd {
134
- if player.paused {
135
- if self.isLive && self.mediaControlConfig.seekToLiveOnResume {
136
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Seek to live.") }
137
- player.currentTime = .infinity
210
+ if player.paused {
211
+ if !self.executeAction(for: .PLAY) {
212
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Executing default Toogle play action.") }
213
+ if self.isLive && self.seekToLiveOnResume {
214
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Seek to live.") }
215
+ player.currentTime = .infinity
216
+ }
217
+ player.play()
218
+ }
219
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggled to playing.") }
220
+ } else {
221
+ if !self.executeAction(for: .PAUSE) {
222
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Executing default Toogle pause action.") }
223
+ player.pause()
224
+ }
225
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggled to paused.") }
138
226
  }
139
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggled to playing.") }
140
- player.play()
141
- } else {
142
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggled to paused.") }
143
- player.pause()
144
- }
145
227
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command handled.") }
146
228
  } else {
147
229
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Toggle play/pause command not handled.") }
@@ -150,10 +232,14 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
150
232
  }
151
233
 
152
234
  @objc private func onStopCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
235
+ guard self.mediaSessionEnabled else { return .commandFailed }
153
236
  if let player = self.player,
154
237
  !self.inAd {
155
238
  if !player.paused {
156
- player.pause()
239
+ if !self.executeAction(for: .PAUSE) {
240
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Executing default Pause action.") }
241
+ player.pause()
242
+ }
157
243
  }
158
244
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] Stop command handled.") }
159
245
  } else {
@@ -163,6 +249,7 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
163
249
  }
164
250
 
165
251
  @objc private func onScrubCommand(_ event: MPChangePlaybackPositionCommandEvent) -> MPRemoteCommandHandlerStatus {
252
+ guard self.mediaSessionEnabled else { return .commandFailed }
166
253
  if let player = self.player,
167
254
  !self.isLive,
168
255
  !self.inAd {
@@ -175,6 +262,7 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
175
262
  }
176
263
 
177
264
  @objc private func onSkipForwardCommand(_ event: MPSkipIntervalCommandEvent) -> MPRemoteCommandHandlerStatus {
265
+ guard self.mediaSessionEnabled else { return .commandFailed }
178
266
  if let player = self.player,
179
267
  !self.isLive,
180
268
  !self.inAd {
@@ -187,6 +275,7 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
187
275
  }
188
276
 
189
277
  @objc private func onSkipBackwardCommand(_ event: MPSkipIntervalCommandEvent) -> MPRemoteCommandHandlerStatus {
278
+ guard self.mediaSessionEnabled else { return .commandFailed }
190
279
  if let player = self.player,
191
280
  !self.isLive,
192
281
  !self.inAd {
@@ -199,12 +288,9 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
199
288
  }
200
289
 
201
290
  @objc private func onPreviousTrackCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
202
- if let player = self.player,
203
- self.mediaControlConfig.convertSkipToSeek,
204
- !self.isLive,
205
- !self.inAd {
206
- player.currentTime = player.currentTime - Double(self.mediaControlConfig.skipBackwardInterval)
207
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] previous track command handled as skip backward command.") }
291
+ guard self.mediaSessionEnabled else { return .commandFailed }
292
+ if self.executeAction(for: .SKIP_TO_PREVIOUS) {
293
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] previous track command handled.") }
208
294
  } else {
209
295
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] previous track command not handled.") }
210
296
  }
@@ -212,12 +298,9 @@ class THEOplayerRCTRemoteCommandsManager: NSObject {
212
298
  }
213
299
 
214
300
  @objc private func onNextTrackCommand(_ event: MPRemoteCommandEvent) -> MPRemoteCommandHandlerStatus {
215
- if let player = self.player,
216
- self.mediaControlConfig.convertSkipToSeek,
217
- !self.isLive,
218
- !self.inAd {
219
- player.currentTime = player.currentTime + Double(self.mediaControlConfig.skipForwardInterval)
220
- if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] next track command handled as skip forward command.") }
301
+ guard self.mediaSessionEnabled else { return .commandFailed }
302
+ if self.executeAction(for: .SKIP_TO_NEXT) {
303
+ if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] next track command handled.") }
221
304
  } else {
222
305
  if DEBUG_REMOTECOMMANDS { PrintUtils.printLog(logText: "[NATIVE] next track command not handled.") }
223
306
  }
@@ -1,35 +1,49 @@
1
- // THEOplayerRCTView+UIConfig.swift
1
+ // THEOplayerRCTView+MediaControlConfig.swift
2
2
 
3
3
  import Foundation
4
4
  import THEOplayerSDK
5
5
 
6
+ let DEFAULT_SKIP_INTERVAL = 15
7
+ let DEFAULT_CONVERT_SKIP_TO_SEEK = false
8
+ let DEFAULT_ALLOW_LIVE_PLAY_PAUSE = true
9
+ let DEFAULT_SEEK_TO_LIVE_ON_RESUME = false
10
+ let DEFAULT_MEDIA_SESSION_ENABLED = true
11
+
6
12
  struct MediaControlConfig {
7
- var skipForwardInterval: Int = 15
8
- var skipBackwardInterval: Int = 15
9
- var convertSkipToSeek: Bool = false
10
- var allowLivePlayPause: Bool = true
11
- var seekToLiveOnResume: Bool = false
13
+ var mediaSessionEnabled: Bool = DEFAULT_MEDIA_SESSION_ENABLED
14
+ var skipForwardInterval: Int = DEFAULT_SKIP_INTERVAL
15
+ var skipBackwardInterval: Int = DEFAULT_SKIP_INTERVAL
16
+ var convertSkipToSeek: Bool = DEFAULT_CONVERT_SKIP_TO_SEEK
17
+ var allowLivePlayPause: Bool = DEFAULT_ALLOW_LIVE_PLAY_PAUSE
18
+ var seekToLiveOnResume: Bool = DEFAULT_SEEK_TO_LIVE_ON_RESUME
12
19
  }
13
20
 
14
21
  extension THEOplayerRCTView {
15
22
 
16
23
  func parseMediaControlConfig(configDict: NSDictionary) {
17
24
  if let mediaControlConfig = configDict["mediaControl"] as? NSDictionary {
25
+ // Build the config locally and assign it once, so the didSet observer (and its
26
+ // remoteCommands/nowPlaying refresh) only fires a single time per parse.
27
+ var newConfig = self.mediaControlConfig
28
+ if let mediaSessionEnabled = mediaControlConfig["mediaSessionEnabled"] as? Bool {
29
+ newConfig.mediaSessionEnabled = mediaSessionEnabled
30
+ }
18
31
  if let skipForwardInterval = mediaControlConfig["skipForwardInterval"] as? Int {
19
- self.mediaControlConfig.skipForwardInterval = skipForwardInterval
32
+ newConfig.skipForwardInterval = skipForwardInterval
20
33
  }
21
34
  if let skipBackwardInterval = mediaControlConfig["skipBackwardInterval"] as? Int {
22
- self.mediaControlConfig.skipBackwardInterval = skipBackwardInterval
35
+ newConfig.skipBackwardInterval = skipBackwardInterval
23
36
  }
24
37
  if let convertSkipToSeek = mediaControlConfig["convertSkipToSeek"] as? Bool {
25
- self.mediaControlConfig.convertSkipToSeek = convertSkipToSeek
38
+ newConfig.convertSkipToSeek = convertSkipToSeek
26
39
  }
27
40
  if let allowLivePlayPause = mediaControlConfig["allowLivePlayPause"] as? Bool {
28
- self.mediaControlConfig.allowLivePlayPause = allowLivePlayPause
41
+ newConfig.allowLivePlayPause = allowLivePlayPause
29
42
  }
30
43
  if let seekToLiveOnResume = mediaControlConfig["seekToLiveOnResume"] as? Bool {
31
- self.mediaControlConfig.seekToLiveOnResume = seekToLiveOnResume
44
+ newConfig.seekToLiveOnResume = seekToLiveOnResume
32
45
  }
46
+ self.mediaControlConfig = newConfig
33
47
  }
34
48
  }
35
49
  }
@@ -0,0 +1,79 @@
1
+ //
2
+ // THEOplayerRCTMediaControlAPI.swift
3
+ //
4
+
5
+ import Foundation
6
+ import UIKit
7
+ import THEOplayerSDK
8
+
9
+ @objc(THEOplayerRCTMediaControlAPI)
10
+ class THEOplayerRCTMediaControlAPI: RCTEventEmitter {
11
+
12
+ override static func moduleName() -> String! {
13
+ return "THEOplayerRCTMediaControlAPI"
14
+ }
15
+
16
+ override static func requiresMainQueueSetup() -> Bool {
17
+ return false
18
+ }
19
+
20
+ override func supportedEvents() -> [String]! {
21
+ return ["MediaControlEvent"]
22
+ }
23
+
24
+ @objc(setHandler:action:)
25
+ func setHandler(_ node: NSNumber, action: String) -> Void {
26
+ DispatchQueue.main.async {
27
+ if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView {
28
+ let mediaControlManager = theView.mediaControlManager
29
+ let mediaControlAction = THEOplayerRCTTypeUtils.mediaControlActionFromString(action)
30
+ mediaControlManager.setMediaControlActionHandler(action: mediaControlAction, handler: self.handlerForAction(action, node: node))
31
+ // Refresh the shared command center so the enabled state of the previous/next track and
32
+ // seek commands reflects the newly registered handler immediately.
33
+ theView.remoteCommandsManager.updateRemoteCommands()
34
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Handler set for \(action) action") }
35
+ }
36
+ }
37
+ }
38
+
39
+ @objc(removeHandler:action:)
40
+ func removeHandler(_ node: NSNumber, action: String) -> Void {
41
+ DispatchQueue.main.async {
42
+ if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView {
43
+ let mediaControlManager = theView.mediaControlManager
44
+ let mediaControlAction = THEOplayerRCTTypeUtils.mediaControlActionFromString(action)
45
+ mediaControlManager.removeMediaControlActionHandler(action: mediaControlAction)
46
+ // Refresh the shared command center so the enabled state of the previous/next track and
47
+ // seek commands reflects the removed handler immediately.
48
+ theView.remoteCommandsManager.updateRemoteCommands()
49
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Handler removed for \(action) action") }
50
+ }
51
+ }
52
+ }
53
+
54
+ @objc(setEnabled:enabled:)
55
+ func setEnabled(_ node: NSNumber, enabled: Bool) -> Void {
56
+ DispatchQueue.main.async {
57
+ if let theView = self.bridge.uiManager.view(forReactTag: node) as? THEOplayerRCTView {
58
+ theView.mediaControlConfig.mediaSessionEnabled = enabled
59
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Media session \(enabled ? "enabled" : "disabled")") }
60
+ }
61
+ }
62
+ }
63
+
64
+ private func handlerForAction(_ action: String, node: NSNumber) -> (() -> Void) {
65
+ return { [weak self] in
66
+ if let self = self {
67
+ self.sendEvent(
68
+ withName: "MediaControlEvent",
69
+ body: [
70
+ "action": action,
71
+ "tag": node
72
+ ]
73
+ )
74
+ }
75
+ if DEBUG_MEDIA_CONTROL_API { PrintUtils.printLog(logText: "[NATIVE] Handler triggered for \(action) action") }
76
+ }
77
+ }
78
+
79
+ }
@@ -0,0 +1,38 @@
1
+ // THEOplayerRCTMediaControlManager.swift
2
+
3
+ import Foundation
4
+
5
+ enum MediaControlAction: String {
6
+ case PLAY = "play"
7
+ case PAUSE = "pause"
8
+ case SKIP_TO_PREVIOUS = "skipToPrevious"
9
+ case SKIP_TO_NEXT = "skipToNext"
10
+ }
11
+
12
+ public class THEOplayerRCTMediaControlManager {
13
+ private var actionHandlers: [MediaControlAction: (() -> Void)] = [:]
14
+
15
+ func setMediaControlActionHandler(action: MediaControlAction, handler: @escaping (() -> Void)) {
16
+ self.actionHandlers[action] = handler
17
+ }
18
+
19
+ func removeMediaControlActionHandler(action: MediaControlAction) {
20
+ self.actionHandlers.removeValue(forKey: action)
21
+ }
22
+
23
+ func hasMediaControlActionHandler(for action: MediaControlAction) -> Bool {
24
+ return self.actionHandlers[action] != nil
25
+ }
26
+
27
+ func executeMediaControlAction(action: MediaControlAction) -> Bool {
28
+ if let handler = self.actionHandlers[action] {
29
+ handler()
30
+ return true
31
+ }
32
+ return false
33
+ }
34
+
35
+ func destroy() {
36
+ self.actionHandlers.removeAll()
37
+ }
38
+ }