react-native-theoplayer 11.5.0 → 11.7.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 (282) hide show
  1. package/CHANGELOG.md +32 -1
  2. package/README.md +70 -0
  3. package/android/build.gradle +1 -0
  4. package/android/src/main/java/com/theoplayer/PlayerConfigAdapter.kt +6 -0
  5. package/android/src/main/java/com/theoplayer/PlayerEventEmitter.kt +11 -2
  6. package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +95 -93
  7. package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +6 -0
  8. package/android/src/main/java/com/theoplayer/ReactTHEOplayerView.kt +51 -3
  9. package/android/src/main/java/com/theoplayer/ads/AdEventAdapter.kt +4 -0
  10. package/android/src/main/java/com/theoplayer/ads/AdsModule.kt +6 -6
  11. package/android/src/main/java/com/theoplayer/integration/Integration.kt +72 -0
  12. package/android/src/main/java/com/theoplayer/integration/IntegrationRegistration.kt +68 -0
  13. package/android/src/main/java/com/theoplayer/integration/PlayerFacade.kt +187 -0
  14. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdState.kt +19 -0
  15. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAds.kt +73 -0
  16. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdsBridge.kt +112 -0
  17. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEventSubscription.kt +11 -0
  18. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEvents.kt +139 -0
  19. package/android/src/main/java/com/theoplayer/media/MediaControlModule.kt +102 -0
  20. package/android/src/main/java/com/theoplayer/media/MediaControlProxy.kt +376 -0
  21. package/android/src/main/java/com/theoplayer/media/MediaNotificationBuilder.kt +78 -34
  22. package/android/src/main/java/com/theoplayer/media/MediaPlaybackService.kt +53 -20
  23. package/android/src/main/java/com/theoplayer/media/MediaSessionConfig.kt +6 -6
  24. package/android/src/main/java/com/theoplayer/media/MediaSessionConfigAdapter.kt +23 -20
  25. package/android/src/main/java/com/theoplayer/metrics/MetricsModule.kt +37 -0
  26. package/android/src/main/java/com/theoplayer/player/PlayerModule.kt +0 -1
  27. package/android/src/main/java/com/theoplayer/presentation/PipUtils.kt +98 -93
  28. package/android/src/main/java/com/theoplayer/theoads/THEOadsModule.kt +1 -1
  29. package/android/src/main/java/com/theoplayer/util/ReadableExtension.kt +14 -0
  30. package/android/src/main/res/drawable/ic_next.xml +9 -0
  31. package/android/src/main/res/drawable/ic_prev.xml +9 -0
  32. package/android/src/main/res/values/strings.xml +4 -0
  33. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeAdsBridgeTest.kt +250 -0
  34. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeConfigurationTest.kt +30 -0
  35. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTest.kt +507 -0
  36. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTestHost.kt +104 -0
  37. package/ios/THEOplayerRCTBridge.m +35 -0
  38. package/ios/THEOplayerRCTDebug.swift +3 -0
  39. package/ios/THEOplayerRCTMainEventHandler.swift +17 -0
  40. package/ios/THEOplayerRCTPlayerAPI.swift +31 -0
  41. package/ios/THEOplayerRCTTypeUtils.swift +30 -0
  42. package/ios/THEOplayerRCTView.swift +15 -5
  43. package/ios/Theoplayer-Bridging-Header.h +0 -1
  44. package/ios/backgroundAudio/THEOplayerRCTBackgroundAudioManager.swift +1 -1
  45. package/ios/backgroundAudio/THEOplayerRCTNowPlayingManager.swift +49 -3
  46. package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift +151 -68
  47. package/ios/backgroundAudio/THEOplayerRCTView+MediaControlConfig.swift +25 -11
  48. package/ios/mediaControl/THEOplayerRCTMediaControlAPI.swift +79 -0
  49. package/ios/mediaControl/THEOplayerRCTMediaControlManager.swift +38 -0
  50. package/ios/metrics/THEOplayerRCTMetricsAPI.swift +31 -0
  51. package/ios/pip/THEOplayerRCTPipControlsManager.swift +9 -12
  52. package/lib/commonjs/api/barrel.js +31 -20
  53. package/lib/commonjs/api/barrel.js.map +1 -1
  54. package/lib/commonjs/api/event/PlayerEvent.js +8 -0
  55. package/lib/commonjs/api/event/PlayerEvent.js.map +1 -1
  56. package/lib/commonjs/api/media/MediaControlAPI.js +14 -0
  57. package/lib/commonjs/api/media/MediaControlAPI.js.map +1 -0
  58. package/lib/commonjs/api/media/barrel.js +11 -0
  59. package/lib/commonjs/api/media/barrel.js.map +1 -1
  60. package/lib/commonjs/api/metrics/MetricsAPI.js +2 -0
  61. package/lib/commonjs/api/metrics/MetricsAPI.js.map +1 -0
  62. package/lib/commonjs/api/metrics/barrel.js +17 -0
  63. package/lib/commonjs/api/metrics/barrel.js.map +1 -0
  64. package/lib/commonjs/api/player/Integration.js +2 -0
  65. package/lib/commonjs/api/player/Integration.js.map +1 -0
  66. package/lib/commonjs/api/player/PlayerEventMap.js +1 -0
  67. package/lib/commonjs/api/player/PlayerEventMap.js.map +1 -1
  68. package/lib/commonjs/api/player/THEOplayer.js.map +1 -1
  69. package/lib/commonjs/api/player/barrel.js +11 -0
  70. package/lib/commonjs/api/player/barrel.js.map +1 -1
  71. package/lib/commonjs/api/track/MediaTrack.js +16 -0
  72. package/lib/commonjs/api/track/MediaTrack.js.map +1 -1
  73. package/lib/commonjs/internal/THEOplayerView.js +6 -0
  74. package/lib/commonjs/internal/THEOplayerView.js.map +1 -1
  75. package/lib/commonjs/internal/THEOplayerView.web.js +3 -1
  76. package/lib/commonjs/internal/THEOplayerView.web.js.map +1 -1
  77. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js +1 -0
  78. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  79. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js +24 -0
  80. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
  81. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +29 -12
  82. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  83. package/lib/commonjs/internal/adapter/WebEventForwarder.js +6 -1
  84. package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
  85. package/lib/commonjs/internal/adapter/event/PlayerEvents.js +7 -1
  86. package/lib/commonjs/internal/adapter/event/PlayerEvents.js.map +1 -1
  87. package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js +42 -0
  88. package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
  89. package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js +32 -0
  90. package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
  91. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js +18 -0
  92. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  93. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js +16 -0
  94. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  95. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js +6 -0
  96. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  97. package/lib/commonjs/internal/adapter/web/PlayerFacade.js +258 -0
  98. package/lib/commonjs/internal/adapter/web/PlayerFacade.js.map +1 -0
  99. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js +6 -0
  100. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  101. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js +114 -0
  102. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  103. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js +6 -0
  104. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  105. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js +6 -0
  106. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  107. package/lib/commonjs/internal/adapter/web/WebMediaSession.js +78 -16
  108. package/lib/commonjs/internal/adapter/web/WebMediaSession.js.map +1 -1
  109. package/lib/commonjs/manifest.json +1 -1
  110. package/lib/module/api/barrel.js +1 -0
  111. package/lib/module/api/barrel.js.map +1 -1
  112. package/lib/module/api/event/PlayerEvent.js +9 -0
  113. package/lib/module/api/event/PlayerEvent.js.map +1 -1
  114. package/lib/module/api/media/MediaControlAPI.js +10 -0
  115. package/lib/module/api/media/MediaControlAPI.js.map +1 -0
  116. package/lib/module/api/media/barrel.js +1 -0
  117. package/lib/module/api/media/barrel.js.map +1 -1
  118. package/lib/module/api/metrics/MetricsAPI.js +2 -0
  119. package/lib/module/api/metrics/MetricsAPI.js.map +1 -0
  120. package/lib/module/api/metrics/barrel.js +4 -0
  121. package/lib/module/api/metrics/barrel.js.map +1 -0
  122. package/lib/module/api/player/Integration.js +2 -0
  123. package/lib/module/api/player/Integration.js.map +1 -0
  124. package/lib/module/api/player/PlayerEventMap.js +1 -0
  125. package/lib/module/api/player/PlayerEventMap.js.map +1 -1
  126. package/lib/module/api/player/THEOplayer.js.map +1 -1
  127. package/lib/module/api/player/barrel.js +1 -0
  128. package/lib/module/api/player/barrel.js.map +1 -1
  129. package/lib/module/api/track/MediaTrack.js +16 -0
  130. package/lib/module/api/track/MediaTrack.js.map +1 -1
  131. package/lib/module/internal/THEOplayerView.js +7 -1
  132. package/lib/module/internal/THEOplayerView.js.map +1 -1
  133. package/lib/module/internal/THEOplayerView.web.js +3 -1
  134. package/lib/module/internal/THEOplayerView.web.js.map +1 -1
  135. package/lib/module/internal/adapter/DefaultNativePlayerState.js +1 -0
  136. package/lib/module/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  137. package/lib/module/internal/adapter/THEOplayerAdapter.js +24 -0
  138. package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
  139. package/lib/module/internal/adapter/THEOplayerWebAdapter.js +29 -12
  140. package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  141. package/lib/module/internal/adapter/WebEventForwarder.js +7 -2
  142. package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
  143. package/lib/module/internal/adapter/event/PlayerEvents.js +5 -0
  144. package/lib/module/internal/adapter/event/PlayerEvents.js.map +1 -1
  145. package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js +37 -0
  146. package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
  147. package/lib/module/internal/adapter/media/MediaControlWebAdapter.js +27 -0
  148. package/lib/module/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
  149. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js +13 -0
  150. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  151. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js +11 -0
  152. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  153. package/lib/module/internal/adapter/web/IntegrationRegistration.js +4 -0
  154. package/lib/module/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  155. package/lib/module/internal/adapter/web/PlayerFacade.js +253 -0
  156. package/lib/module/internal/adapter/web/PlayerFacade.js.map +1 -0
  157. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js +4 -0
  158. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  159. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js +109 -0
  160. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  161. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js +4 -0
  162. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  163. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js +4 -0
  164. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  165. package/lib/module/internal/adapter/web/WebMediaSession.js +78 -16
  166. package/lib/module/internal/adapter/web/WebMediaSession.js.map +1 -1
  167. package/lib/module/manifest.json +1 -1
  168. package/lib/typescript/__tests__/PlayerFacade.test.d.ts +2 -0
  169. package/lib/typescript/__tests__/PlayerFacade.test.d.ts.map +1 -0
  170. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts +2 -0
  171. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts.map +1 -0
  172. package/lib/typescript/__tests__/index.test.d.ts +13 -0
  173. package/lib/typescript/__tests__/index.test.d.ts.map +1 -1
  174. package/lib/typescript/api/THEOplayerView.d.ts +4 -0
  175. package/lib/typescript/api/THEOplayerView.d.ts.map +1 -1
  176. package/lib/typescript/api/barrel.d.ts +1 -0
  177. package/lib/typescript/api/barrel.d.ts.map +1 -1
  178. package/lib/typescript/api/config/PlayerConfiguration.d.ts +15 -0
  179. package/lib/typescript/api/config/PlayerConfiguration.d.ts.map +1 -1
  180. package/lib/typescript/api/event/AdEvent.d.ts +1 -1
  181. package/lib/typescript/api/event/PlayerEvent.d.ts +9 -0
  182. package/lib/typescript/api/event/PlayerEvent.d.ts.map +1 -1
  183. package/lib/typescript/api/media/MediaControlAPI.d.ts +30 -0
  184. package/lib/typescript/api/media/MediaControlAPI.d.ts.map +1 -0
  185. package/lib/typescript/api/media/MediaControlConfiguration.d.ts +5 -1
  186. package/lib/typescript/api/media/MediaControlConfiguration.d.ts.map +1 -1
  187. package/lib/typescript/api/media/barrel.d.ts +1 -0
  188. package/lib/typescript/api/media/barrel.d.ts.map +1 -1
  189. package/lib/typescript/api/metrics/MetricsAPI.d.ts +21 -0
  190. package/lib/typescript/api/metrics/MetricsAPI.d.ts.map +1 -0
  191. package/lib/typescript/api/metrics/barrel.d.ts +2 -0
  192. package/lib/typescript/api/metrics/barrel.d.ts.map +1 -0
  193. package/lib/typescript/api/player/Integration.d.ts +88 -0
  194. package/lib/typescript/api/player/Integration.d.ts.map +1 -0
  195. package/lib/typescript/api/player/PlayerEventMap.d.ts +7 -2
  196. package/lib/typescript/api/player/PlayerEventMap.d.ts.map +1 -1
  197. package/lib/typescript/api/player/THEOplayer.d.ts +24 -0
  198. package/lib/typescript/api/player/THEOplayer.d.ts.map +1 -1
  199. package/lib/typescript/api/player/barrel.d.ts +1 -0
  200. package/lib/typescript/api/player/barrel.d.ts.map +1 -1
  201. package/lib/typescript/api/track/MediaTrack.d.ts +21 -4
  202. package/lib/typescript/api/track/MediaTrack.d.ts.map +1 -1
  203. package/lib/typescript/internal/THEOplayerView.d.ts +1 -0
  204. package/lib/typescript/internal/THEOplayerView.d.ts.map +1 -1
  205. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts +1 -0
  206. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts.map +1 -1
  207. package/lib/typescript/internal/adapter/NativePlayerState.d.ts +1 -0
  208. package/lib/typescript/internal/adapter/NativePlayerState.d.ts.map +1 -1
  209. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts +8 -1
  210. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
  211. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +8 -2
  212. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
  213. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts +1 -0
  214. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
  215. package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts +4 -1
  216. package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts.map +1 -1
  217. package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts +1 -0
  218. package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts.map +1 -1
  219. package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts +12 -0
  220. package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts.map +1 -0
  221. package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts +14 -0
  222. package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts.map +1 -0
  223. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts +7 -0
  224. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts.map +1 -0
  225. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts +8 -0
  226. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts.map +1 -0
  227. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts +53 -0
  228. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts.map +1 -0
  229. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts +26 -0
  230. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts.map +1 -0
  231. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts +33 -0
  232. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts.map +1 -0
  233. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts +21 -0
  234. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts.map +1 -0
  235. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts +43 -0
  236. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts.map +1 -0
  237. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts +13 -0
  238. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts.map +1 -0
  239. package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts +10 -3
  240. package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts.map +1 -1
  241. package/package.json +3 -3
  242. package/react-native-theoplayer.podspec +7 -7
  243. package/src/__tests__/PlayerFacade.test.ts +579 -0
  244. package/src/__tests__/PlayerFacadeWebAdapter.test.ts +193 -0
  245. package/src/__tests__/index.test.tsx +15 -1
  246. package/src/api/THEOplayerView.ts +5 -0
  247. package/src/api/barrel.ts +1 -0
  248. package/src/api/config/PlayerConfiguration.ts +16 -0
  249. package/src/api/event/AdEvent.ts +1 -1
  250. package/src/api/event/PlayerEvent.ts +10 -0
  251. package/src/api/media/MediaControlAPI.ts +33 -0
  252. package/src/api/media/MediaControlConfiguration.ts +5 -1
  253. package/src/api/media/barrel.ts +1 -0
  254. package/src/api/metrics/MetricsAPI.ts +20 -0
  255. package/src/api/metrics/barrel.ts +1 -0
  256. package/src/api/player/Integration.ts +97 -0
  257. package/src/api/player/PlayerEventMap.ts +7 -0
  258. package/src/api/player/THEOplayer.ts +27 -0
  259. package/src/api/player/barrel.ts +1 -0
  260. package/src/api/track/MediaTrack.ts +21 -4
  261. package/src/internal/THEOplayerView.tsx +10 -2
  262. package/src/internal/THEOplayerView.web.tsx +2 -2
  263. package/src/internal/adapter/DefaultNativePlayerState.ts +1 -0
  264. package/src/internal/adapter/NativePlayerState.ts +1 -0
  265. package/src/internal/adapter/THEOplayerAdapter.ts +33 -0
  266. package/src/internal/adapter/THEOplayerWebAdapter.ts +38 -12
  267. package/src/internal/adapter/WebEventForwarder.ts +12 -3
  268. package/src/internal/adapter/event/PlayerEvents.ts +10 -0
  269. package/src/internal/adapter/event/native/NativePlayerEvent.ts +2 -0
  270. package/src/internal/adapter/media/MediaControlNativeAdapter.ts +38 -0
  271. package/src/internal/adapter/media/MediaControlWebAdapter.ts +28 -0
  272. package/src/internal/adapter/metrics/MetricsNativeAdapter.ts +12 -0
  273. package/src/internal/adapter/metrics/MetricsWebAdapter.ts +14 -0
  274. package/src/internal/adapter/web/IntegrationRegistration.ts +57 -0
  275. package/src/internal/adapter/web/PlayerFacade.ts +281 -0
  276. package/src/internal/adapter/web/PlayerFacadeAPI.ts +35 -0
  277. package/src/internal/adapter/web/PlayerFacadeAdsEvents.ts +119 -0
  278. package/src/internal/adapter/web/PlayerFacadeIntegration.ts +45 -0
  279. package/src/internal/adapter/web/PlayerFacadeTypes.ts +14 -0
  280. package/src/internal/adapter/web/WebMediaSession.ts +85 -21
  281. package/src/manifest.json +1 -1
  282. package/android/src/main/java/com/theoplayer/media/MediaQueueNavigator.kt +0 -33
@@ -0,0 +1,281 @@
1
+ import type { ChromelessPlayer, EventListener, PlayerEventMap } from 'theoplayer';
2
+ import { PlayerFacadeAdsEvents } from './PlayerFacadeAdsEvents';
3
+ import type { IntegrationRegistration, PlayerFacade as PlayerFacadeAPI, PlayerFacadeEvent, PlayerFacadeIntegration } from './PlayerFacadeTypes';
4
+
5
+ type Registration = IntegrationRegistration & { integration?: PlayerFacadeIntegration };
6
+ type PlayerEvent = PlayerEventMap[keyof PlayerEventMap];
7
+ type PlayerEventSubscription = {
8
+ listeners: Set<EventListener<PlayerEvent>>;
9
+ interceptors: Set<(event: PlayerEvent) => boolean>;
10
+ forward: EventListener<PlayerEvent>;
11
+ };
12
+
13
+ // Resolve the current backing object on every access while preserving its method receiver and identity.
14
+ function delegate<T extends object, TOverrides extends object>(backing: () => T, overrides: TOverrides): T & TOverrides {
15
+ const methods = new Map<PropertyKey, { original: unknown; receiver: object; bound: unknown }>();
16
+ return new Proxy(Object.create(Object.getPrototypeOf(backing())) as T & TOverrides, {
17
+ get: (_target, property) => {
18
+ const receiver = Object.prototype.hasOwnProperty.call(overrides, property) ? overrides : backing();
19
+ const value: unknown = Reflect.get(receiver, property, receiver);
20
+ if (typeof value !== 'function' || property === 'constructor') return value;
21
+ const cached = methods.get(property);
22
+ if (cached?.original !== value || cached.receiver !== receiver)
23
+ methods.set(property, { original: value, receiver, bound: value.bind(receiver) });
24
+ return methods.get(property)!.bound;
25
+ },
26
+ set: (_target, property, value) => {
27
+ const receiver = Reflect.getOwnPropertyDescriptor(overrides, property)?.set ? overrides : backing();
28
+ return Reflect.set(receiver, property, value, receiver);
29
+ },
30
+ has: (_target, property) => property in overrides || property in backing(),
31
+ ownKeys: () => [...new Set([...Reflect.ownKeys(backing()), ...Reflect.ownKeys(overrides)])],
32
+ getOwnPropertyDescriptor: (_target, property) => {
33
+ const descriptor = Reflect.getOwnPropertyDescriptor(overrides, property) ?? Reflect.getOwnPropertyDescriptor(backing(), property);
34
+ return descriptor && { ...descriptor, configurable: true };
35
+ },
36
+ preventExtensions: () => false,
37
+ });
38
+ }
39
+
40
+ /**
41
+ * Stable player surface with generic integration hooks; no playback or ad-lifecycle policy lives here.
42
+ *
43
+ * @internal
44
+ */
45
+ export class PlayerFacade {
46
+ readonly player: PlayerFacadeAPI;
47
+ private readonly nativeAds: PlayerFacadeAPI['ads'] | undefined;
48
+ private readonly adsEvents: PlayerFacadeAdsEvents;
49
+ private readonly playerSubscriptions = new Map<keyof PlayerEventMap, PlayerEventSubscription>();
50
+ private readonly playerInterceptors = new Set<(event: PlayerEvent) => boolean>();
51
+ private registration?: Registration;
52
+ private closed = false;
53
+
54
+ constructor(readonly contentPlayer: ChromelessPlayer) {
55
+ this.nativeAds = contentPlayer.ads as PlayerFacadeAPI['ads'];
56
+ this.adsEvents = new PlayerFacadeAdsEvents(this.nativeAds, () => this.registration?.integration);
57
+ const readAdState = () => this.registration?.integration?.ads ?? this.registration?.integration?.getAdState?.();
58
+ const readPlaying = () => readAdState()?.playing ?? this.nativeAds?.playing ?? false;
59
+ const readAds = () => readAdState()?.currentAds ?? this.nativeAds?.currentAds ?? [];
60
+ const readBreak = () => {
61
+ const state = readAdState();
62
+ return state ? state.currentAdBreak : this.nativeAds?.currentAdBreak;
63
+ };
64
+ const readTime = () => {
65
+ const value = this.registration?.integration?.getCurrentTime?.();
66
+ return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : contentPlayer.currentTime;
67
+ };
68
+ const writeTime = (value: number) => {
69
+ if (this.registration?.integration?.setCurrentTime?.(value) !== true) contentPlayer.currentTime = value;
70
+ };
71
+ const readPaused = () => this.registration?.integration?.isPaused?.() ?? contentPlayer.paused;
72
+ const readSeeking = () => this.registration?.integration?.isSeeking?.() ?? contentPlayer.seeking;
73
+ const readDuration = () => this.registration?.integration?.getDuration?.() ?? contentPlayer.duration;
74
+ const emptyAds = {} as PlayerFacadeAPI['ads'];
75
+ // Consumers may retain player.ads before registration; only its backing source should change.
76
+ const ads = delegate(() => this.registration?.integration?.ads ?? this.nativeAds ?? emptyAds, {
77
+ get playing() {
78
+ return readPlaying();
79
+ },
80
+ get currentAds() {
81
+ return readAds();
82
+ },
83
+ get currentAdBreak() {
84
+ return readBreak();
85
+ },
86
+ addEventListener: this.adsEvents.addEventListener,
87
+ removeEventListener: this.adsEvents.removeEventListener,
88
+ });
89
+ const readMuted = () => this.registration?.integration?.getMuted?.() ?? contentPlayer.muted;
90
+ const writeMuted = (value: boolean) => {
91
+ if (this.registration?.integration?.setMuted?.(value) !== true) contentPlayer.muted = value;
92
+ };
93
+ const readVolume = () => this.registration?.integration?.getVolume?.() ?? contentPlayer.volume;
94
+ const writeVolume = (value: number) => {
95
+ if (this.registration?.integration?.setVolume?.(value) !== true) contentPlayer.volume = value;
96
+ };
97
+ this.player = delegate(() => contentPlayer, {
98
+ get muted() {
99
+ return readMuted();
100
+ },
101
+ set muted(value: boolean) {
102
+ writeMuted(value);
103
+ },
104
+ get volume() {
105
+ return readVolume();
106
+ },
107
+ set volume(value: number) {
108
+ writeVolume(value);
109
+ },
110
+ ads,
111
+ contentPlayer,
112
+ registerIntegration: this.registerIntegration.bind(this),
113
+ addEventListener: this.addPlayerEventListener,
114
+ removeEventListener: this.removePlayerEventListener,
115
+ get currentTime() {
116
+ return readTime();
117
+ },
118
+ set currentTime(value: number) {
119
+ writeTime(value);
120
+ },
121
+ get paused() {
122
+ return readPaused();
123
+ },
124
+ get seeking() {
125
+ return readSeeking();
126
+ },
127
+ get duration() {
128
+ return readDuration();
129
+ },
130
+ play: () => {
131
+ if (this.registration?.integration?.play?.() !== true) contentPlayer.play();
132
+ },
133
+ pause: () => {
134
+ if (this.registration?.integration?.pause?.() !== true) contentPlayer.pause();
135
+ },
136
+ });
137
+ this.getPlayerSubscription('destroy');
138
+ }
139
+
140
+ registerIntegration(integration: PlayerFacadeIntegration): IntegrationRegistration {
141
+ if (this.closed) throw new Error('The player facade has been closed.');
142
+ if (this.registration) throw new Error('Unregister the previous integration first.');
143
+ if (!integration || typeof integration !== 'object') throw new Error('An integration must be an object implementing Integration.');
144
+ for (const method of [
145
+ 'getCurrentTime',
146
+ 'setCurrentTime',
147
+ 'play',
148
+ 'pause',
149
+ 'isPaused',
150
+ 'isSeeking',
151
+ 'getDuration',
152
+ 'getMuted',
153
+ 'setMuted',
154
+ 'getVolume',
155
+ 'setVolume',
156
+ 'getAdState',
157
+ 'shouldConsumeAdEvent',
158
+ ] as const) {
159
+ if (integration[method] !== undefined && typeof integration[method] !== 'function') {
160
+ throw new Error(`Integration.${method} must be a function.`);
161
+ }
162
+ }
163
+ const registration: Registration = {
164
+ integration,
165
+ dispatchPlayerEvent: (event) => this.dispatchEvent(registration, event),
166
+ dispatchEvent: (event) => this.dispatchEvent(registration, event),
167
+ interceptPlayerEvent: (type, callback) => {
168
+ if (this.closed || this.registration !== registration) return () => undefined;
169
+ const subscription = this.getPlayerSubscription(type);
170
+ const interceptor = callback as (event: PlayerEvent) => boolean;
171
+ subscription.interceptors.add(interceptor);
172
+ return () => {
173
+ subscription.interceptors.delete(interceptor);
174
+ this.releasePlayerSubscription(type, subscription);
175
+ };
176
+ },
177
+ interceptPlayerEvents: (interceptor) => {
178
+ if (this.closed || this.registration !== registration) return () => undefined;
179
+ this.playerInterceptors.add(interceptor);
180
+ return () => {
181
+ this.playerInterceptors.delete(interceptor);
182
+ };
183
+ },
184
+ close: () => {
185
+ registration.integration = undefined;
186
+ if (this.registration !== registration) return;
187
+ this.registration = undefined;
188
+ // Interceptors have explicit disposers so queued backing events can drain after unregistering.
189
+ if (!this.closed) this.adsEvents.rebind();
190
+ },
191
+ };
192
+ this.registration = registration;
193
+ try {
194
+ this.adsEvents.rebind();
195
+ } catch (error) {
196
+ registration.close();
197
+ throw error;
198
+ }
199
+ return registration;
200
+ }
201
+
202
+ private getPlayerSubscription(type: keyof PlayerEventMap): PlayerEventSubscription {
203
+ const existing = this.playerSubscriptions.get(type);
204
+ if (existing) return existing;
205
+ // One backing listener per type lets interceptors decide once for all facade consumers.
206
+ const subscription: PlayerEventSubscription = {
207
+ listeners: new Set(),
208
+ interceptors: new Set(),
209
+ forward: (event) => {
210
+ try {
211
+ for (const interceptor of [...subscription.interceptors]) {
212
+ if (subscription.interceptors.has(interceptor) && interceptor(event)) return;
213
+ }
214
+ for (const interceptor of [...this.playerInterceptors]) {
215
+ if (this.playerInterceptors.has(interceptor) && interceptor(event)) return;
216
+ }
217
+ for (const listener of [...subscription.listeners]) {
218
+ if (subscription.listeners.has(listener)) listener(event);
219
+ }
220
+ } finally {
221
+ if (type === 'destroy') this.close();
222
+ }
223
+ },
224
+ };
225
+ this.playerSubscriptions.set(type, subscription);
226
+ this.contentPlayer.addEventListener(type, subscription.forward);
227
+ return subscription;
228
+ }
229
+
230
+ private releasePlayerSubscription(type: keyof PlayerEventMap, subscription: PlayerEventSubscription): void {
231
+ if (type === 'destroy' || subscription.listeners.size || subscription.interceptors.size || this.playerSubscriptions.get(type) !== subscription)
232
+ return;
233
+ this.contentPlayer.removeEventListener(type, subscription.forward);
234
+ this.playerSubscriptions.delete(type);
235
+ }
236
+
237
+ private readonly addPlayerEventListener: ChromelessPlayer['addEventListener'] = (types, listener) => {
238
+ if (this.closed) throw new Error('The player facade has been closed.');
239
+ for (const type of typeof types === 'string' ? [types] : types) {
240
+ this.getPlayerSubscription(type).listeners.add(listener as EventListener<PlayerEvent>);
241
+ }
242
+ };
243
+
244
+ private readonly removePlayerEventListener: ChromelessPlayer['removeEventListener'] = (types, listener) => {
245
+ for (const type of typeof types === 'string' ? [types] : types) {
246
+ const subscription = this.playerSubscriptions.get(type);
247
+ if (!subscription) continue;
248
+ subscription.listeners.delete(listener as EventListener<PlayerEvent>);
249
+ this.releasePlayerSubscription(type, subscription);
250
+ }
251
+ };
252
+
253
+ private dispatchEvent(registration: Registration, event: PlayerFacadeEvent): void {
254
+ const isCurrentRegistration = () => !this.closed && this.registration === registration;
255
+ if (!isCurrentRegistration()) return;
256
+ if (!event || typeof event.type !== 'string') throw new Error('A THEOplayer event with a type is required.');
257
+ if (PlayerFacadeAdsEvents.isAdEvent(event)) {
258
+ this.adsEvents.dispatch(event, isCurrentRegistration);
259
+ return;
260
+ }
261
+ // Integration events already represent public playback state; backing-player filters must not consume them.
262
+ const listeners = this.playerSubscriptions.get(event.type)?.listeners;
263
+ for (const listener of [...(listeners ?? [])]) {
264
+ if (isCurrentRegistration() && listeners?.has(listener)) listener(event);
265
+ }
266
+ }
267
+
268
+ close = (): void => {
269
+ if (this.closed) return;
270
+ this.closed = true;
271
+ this.registration?.close();
272
+ this.playerInterceptors.clear();
273
+ for (const [type, subscription] of this.playerSubscriptions) {
274
+ subscription.listeners.clear();
275
+ subscription.interceptors.clear();
276
+ this.contentPlayer.removeEventListener(type, subscription.forward);
277
+ }
278
+ this.playerSubscriptions.clear();
279
+ this.adsEvents.close();
280
+ };
281
+ }
@@ -0,0 +1,35 @@
1
+ import type { Ads, ChromelessPlayer, EventDispatcher } from 'theoplayer';
2
+ import type { IntegrationRegistration } from './IntegrationRegistration';
3
+ import type { PlayerFacadeIntegration } from './PlayerFacadeIntegration';
4
+ import type { PlayerFacadeAdsEventMap } from './PlayerFacadeTypes';
5
+
6
+ /**
7
+ * Describes the stable native Web player handle when the player facade is enabled.
8
+ *
9
+ * @category Player
10
+ * @platform web
11
+ * @internal
12
+ */
13
+ export interface PlayerFacadeAPI extends ChromelessPlayer {
14
+ /**
15
+ * The stable advertising API, including integration-generated `adclicked` events.
16
+ * Delegates to the registered integration's Ads API or the content player's Ads API.
17
+ */
18
+ readonly ads: Ads & EventDispatcher<PlayerFacadeAdsEventMap>;
19
+
20
+ /**
21
+ * Raw playback engine, unaffected by integration overrides or event interception.
22
+ * Use this player for playback engines and ad schedulers that require the content timeline.
23
+ */
24
+ readonly contentPlayer: ChromelessPlayer;
25
+
26
+ /**
27
+ * Registers an integration that optionally overrides playback and advertising behavior.
28
+ * Only one integration may be registered at a time.
29
+ *
30
+ * @param integration - The hooks and optional Ads API to use until the registration closes.
31
+ * @returns The registration used to dispatch events, install interceptors, and unregister.
32
+ * @throws If the facade is closed, an integration is already registered, or a hook is not a function.
33
+ */
34
+ registerIntegration(integration: PlayerFacadeIntegration): IntegrationRegistration;
35
+ }
@@ -0,0 +1,119 @@
1
+ import type { EventListener } from 'theoplayer';
2
+ import type { PlayerFacadeAds, PlayerFacadeAdsEventMap as AdsEventMap, PlayerFacadeEvent, PlayerFacadeIntegration } from './PlayerFacadeTypes';
3
+
4
+ type AdEventType = keyof AdsEventMap;
5
+ type AdEvent = AdsEventMap[AdEventType];
6
+ type Listener = EventListener<AdEvent>;
7
+ type Subscription = { listeners: Set<Listener>; remove: () => void };
8
+
9
+ // This table selects the Ads event surface; it does not restrict player event dispatch.
10
+ const AD_EVENTS: Record<AdEventType, true> = {
11
+ addadbreak: true,
12
+ removeadbreak: true,
13
+ adbreakbegin: true,
14
+ adbreakend: true,
15
+ adbreakchange: true,
16
+ addad: true,
17
+ updatead: true,
18
+ updateadbreak: true,
19
+ adloaded: true,
20
+ adbegin: true,
21
+ adend: true,
22
+ adskip: true,
23
+ aderror: true,
24
+ adimpression: true,
25
+ adclicked: true,
26
+ adfirstquartile: true,
27
+ admidpoint: true,
28
+ adthirdquartile: true,
29
+ adbuffering: true,
30
+ admetadata: true,
31
+ adsmanagerloaded: true,
32
+ };
33
+
34
+ /** Keeps public Ads listeners stable while their backing event source changes. */
35
+ export class PlayerFacadeAdsEvents {
36
+ private readonly subscriptions = new Map<AdEventType, Subscription>();
37
+ private closed = false;
38
+
39
+ constructor(
40
+ private readonly nativeAds: PlayerFacadeAds | undefined,
41
+ private readonly getIntegration: () => PlayerFacadeIntegration | undefined,
42
+ ) {}
43
+
44
+ static isAdEvent(event: PlayerFacadeEvent): event is AdEvent {
45
+ return Object.prototype.hasOwnProperty.call(AD_EVENTS, event.type);
46
+ }
47
+
48
+ readonly addEventListener = <TType extends AdEventType>(types: TType | readonly TType[], listener: EventListener<AdsEventMap[TType]>): void => {
49
+ if (this.closed) throw new Error('The player facade has been closed.');
50
+ for (const type of typeof types === 'string' ? [types] : types) {
51
+ let subscription = this.subscriptions.get(type);
52
+ if (!subscription) {
53
+ subscription = { listeners: new Set(), remove: () => undefined };
54
+ subscription.remove = this.bindListener(type, subscription);
55
+ this.subscriptions.set(type, subscription);
56
+ }
57
+ subscription.listeners.add(listener as Listener);
58
+ }
59
+ };
60
+
61
+ readonly removeEventListener = <TType extends AdEventType>(types: TType | readonly TType[], listener: EventListener<AdsEventMap[TType]>): void => {
62
+ for (const type of typeof types === 'string' ? [types] : types) {
63
+ const subscription = this.subscriptions.get(type);
64
+ if (!subscription) continue;
65
+ subscription.listeners.delete(listener as Listener);
66
+ if (!subscription.listeners.size) {
67
+ subscription.remove();
68
+ this.subscriptions.delete(type);
69
+ }
70
+ }
71
+ };
72
+
73
+ private bindListener(type: AdEventType, subscription: Subscription): () => void {
74
+ const integration = this.getIntegration();
75
+ const ads = integration?.ads ?? this.nativeAds;
76
+ let attached = true;
77
+ const isCurrentSource = () => attached && this.getIntegration() === integration && this.subscriptions.get(type) === subscription;
78
+ const forward: Listener = (event) => {
79
+ // A detached source may still deliver an event queued before the integration changed.
80
+ if (!isCurrentSource() || this.closed) return;
81
+ if (ads === this.nativeAds && integration?.shouldConsumeAdEvent?.(event) === true) return;
82
+ this.dispatch(event, isCurrentSource);
83
+ };
84
+ try {
85
+ ads?.addEventListener(type, forward);
86
+ } catch (error) {
87
+ attached = false;
88
+ ads?.removeEventListener(type, forward);
89
+ throw error;
90
+ }
91
+ return () => {
92
+ attached = false;
93
+ ads?.removeEventListener(type, forward);
94
+ };
95
+ }
96
+
97
+ rebind(): void {
98
+ for (const [type, subscription] of this.subscriptions) {
99
+ subscription.remove();
100
+ subscription.remove = this.bindListener(type, subscription);
101
+ }
102
+ }
103
+
104
+ dispatch(event: AdEvent, isCurrentRegistration: () => boolean): void {
105
+ const listeners = this.subscriptions.get(event.type)?.listeners;
106
+ for (const listener of [...(listeners ?? [])]) {
107
+ // Listeners can remove each other or unregister the integration during delivery.
108
+ if (!this.closed && isCurrentRegistration() && listeners?.has(listener)) listener(event);
109
+ }
110
+ }
111
+
112
+ close(): void {
113
+ if (this.closed) return;
114
+ this.closed = true;
115
+ const subscriptions = [...this.subscriptions.values()];
116
+ this.subscriptions.clear();
117
+ for (const subscription of subscriptions) subscription.remove();
118
+ }
119
+ }
@@ -0,0 +1,45 @@
1
+ import type { Ads } from 'theoplayer';
2
+ import type { Integration } from '../../../api/player/Integration';
3
+ import type { PlayerFacadeAds, PlayerFacadeAdsEventMap } from './PlayerFacadeTypes';
4
+
5
+ /**
6
+ * Describes Web-specific advertising overrides for a player facade integration.
7
+ * Optional overrides leave playback ownership and synchronization policy with the integration.
8
+ *
9
+ * @category Player
10
+ * @platform web
11
+ * @internal
12
+ */
13
+ export interface PlayerFacadeIntegration extends Integration {
14
+ /**
15
+ * Supplies the Ads API and event source behind the stable public `player.ads` object.
16
+ *
17
+ * @remarks
18
+ * Keep this object stable until the registration closes. Existing listeners migrate on registration and close.
19
+ * Omit it to retain the content player's Ads API and optionally override only its state through {@link getAdState}.
20
+ */
21
+ readonly ads?: PlayerFacadeAds;
22
+
23
+ /**
24
+ * Returns the advertising state for integrations that do not supply an Ads object.
25
+ *
26
+ * @remarks
27
+ * Legacy state override for integrations that do not supply an Ads object.
28
+ * The facade never derives state from dispatched events. Update state before dispatching corresponding events.
29
+ * An explicitly absent current ad break does not fall back to the content player's ad break.
30
+ *
31
+ * @returns The integration's ad state. Ignored when {@link ads} is supplied.
32
+ */
33
+ getAdState?(): Pick<Ads, 'playing' | 'currentAds' | 'currentAdBreak'>;
34
+
35
+ /**
36
+ * Consumes backing Ads events only; integration-generated events bypass this hook.
37
+ *
38
+ * @param event - The content player's advertising event.
39
+ * @returns `true` to hide the event from all facade Ads listeners, or `false` to forward it.
40
+ *
41
+ * @remarks
42
+ * Called once per subscribed event, not once per listener. Events from {@link ads} bypass this hook.
43
+ */
44
+ shouldConsumeAdEvent?(event: PlayerFacadeAdsEventMap[keyof PlayerFacadeAdsEventMap]): boolean;
45
+ }
@@ -0,0 +1,14 @@
1
+ import type { AdEvent, Ads, AdsEventMap, EventDispatcher, PlayerEventMap } from 'theoplayer';
2
+
3
+ export type { IntegrationRegistration } from './IntegrationRegistration';
4
+ export type { PlayerFacadeAPI as PlayerFacade } from './PlayerFacadeAPI';
5
+ export type { PlayerFacadeIntegration } from './PlayerFacadeIntegration';
6
+
7
+ /** Advertising events supported by the facade, including integration-generated clicks. */
8
+ export type PlayerFacadeAdsEventMap = AdsEventMap & { adclicked: AdEvent<'adclicked'> };
9
+
10
+ /** The Web Ads API with event subscriptions extended to support facade advertising events. */
11
+ export type PlayerFacadeAds = Omit<Ads, 'addEventListener' | 'removeEventListener'> & EventDispatcher<PlayerFacadeAdsEventMap>;
12
+
13
+ /** A native Web player or advertising event that an integration can dispatch through its registration. */
14
+ export type PlayerFacadeEvent = PlayerEventMap[keyof PlayerEventMap] | PlayerFacadeAdsEventMap[keyof PlayerFacadeAdsEventMap];
@@ -1,7 +1,8 @@
1
1
  /* eslint-disable @typescript-eslint/no-empty-function */
2
2
  import type { ChromelessPlayer } from 'theoplayer';
3
3
  import type { THEOplayerWebAdapter } from '../THEOplayerWebAdapter';
4
- import { MediaControlConfiguration } from 'react-native-theoplayer';
4
+ import { MediaControlAction, MediaControlConfiguration } from 'react-native-theoplayer';
5
+ import { MediaControlWebAdapter } from '../media/MediaControlWebAdapter';
5
6
 
6
7
  const DEFAULT_SKIP_FORWARD_INTERVAL = 5;
7
8
  const DEFAULT_SKIP_BACKWARD_INTERVAL = 5;
@@ -30,19 +31,50 @@ const mediaSession = (function () {
30
31
  * @link https://w3c.github.io/mediasession
31
32
  */
32
33
  export class WebMediaSession {
33
- private readonly _config: MediaControlConfiguration;
34
- private readonly _player: ChromelessPlayer;
35
- private readonly _webAdapter: THEOplayerWebAdapter;
36
-
37
- constructor(adapter: THEOplayerWebAdapter, player: ChromelessPlayer, config: MediaControlConfiguration = defaultMediaControlConfiguration) {
38
- this._player = player;
39
- this._webAdapter = adapter;
40
- this._config = config;
34
+ // The session that most recently published to the process-wide navigator.mediaSession.
35
+ // Used to scope clearing so a disabled/destroyed player only clears its own session and never
36
+ // clobbers another (newly-active) owner during a multi-player hand-off.
37
+ private static _currentOwner: WebMediaSession | undefined;
38
+ private readonly _mediaControlAdapter: MediaControlWebAdapter;
39
+ private _enabled: boolean;
40
+
41
+ constructor(
42
+ private readonly _webAdapter: THEOplayerWebAdapter,
43
+ private readonly _player: ChromelessPlayer,
44
+ private readonly _config: MediaControlConfiguration = defaultMediaControlConfiguration,
45
+ ) {
46
+ this._enabled = this._config.mediaSessionEnabled !== false;
41
47
  this._player.addEventListener('sourcechange', this.onSourceChange);
48
+ this._mediaControlAdapter = new MediaControlWebAdapter(this);
49
+ }
50
+
51
+ get mediaControlAdapter() {
52
+ return this._mediaControlAdapter;
53
+ }
54
+
55
+ setEnabled(enabled: boolean) {
56
+ if (this._enabled === enabled) {
57
+ return;
58
+ }
59
+ this._enabled = enabled;
60
+ if (enabled) {
61
+ this.updateMetadata();
62
+ this.updateMediaSession();
63
+ } else {
64
+ this.clearMediaSession();
65
+ }
42
66
  }
43
67
 
44
68
  updateMediaSession() {
45
- // update trickplay capabilities
69
+ if (!this._enabled) {
70
+ // A disabled session must not touch the shared navigator.mediaSession on routine events, as this
71
+ // would clobber the state of another player that currently owns the session. Explicit clearing
72
+ // only happens on the setEnabled(false)/destroy() transitions.
73
+ return;
74
+ }
75
+ // This session is now publishing to the shared media session: claim ownership.
76
+ WebMediaSession._currentOwner = this;
77
+ // Update trick-play capabilities
46
78
  if (this.isTrickPlayEnabled()) {
47
79
  mediaSession.setActionHandler('seekbackward', (event) => {
48
80
  const skipTime = event.seekOffset || this._config.skipBackwardInterval || DEFAULT_SKIP_BACKWARD_INTERVAL;
@@ -67,23 +99,33 @@ export class WebMediaSession {
67
99
  mediaSession.setActionHandler('seekto', NoOp);
68
100
  }
69
101
 
70
- // update play/pause capabilities
102
+ // Update play/pause capabilities
103
+ // Prefer a user-registered PLAY/PAUSE handler (called with the THEOplayer instance), and fall back to
104
+ // the default player action when none is set, matching the iOS/Android behavior.
71
105
  if (this.isPlayPauseEnabled()) {
72
- mediaSession.setActionHandler('play', () => {
73
- this._player?.play();
74
- });
75
- mediaSession?.setActionHandler('pause', () => {
76
- this._player?.pause();
77
- });
106
+ const playHandler = this.mediaControlAdapter.getHandler(MediaControlAction.PLAY);
107
+ mediaSession.setActionHandler('play', () => (playHandler ? playHandler(this._webAdapter) : this._player?.play()));
108
+ const pauseHandler = this.mediaControlAdapter.getHandler(MediaControlAction.PAUSE);
109
+ mediaSession.setActionHandler('pause', () => (pauseHandler ? pauseHandler(this._webAdapter) : this._player?.pause()));
78
110
  } else {
79
111
  mediaSession.setActionHandler('play', NoOp);
80
112
  mediaSession.setActionHandler('pause', NoOp);
81
113
  }
82
114
 
83
- // update playbackState
115
+ // Update queue actions
116
+ // There is no default behaviour for these: reset the action handler when the user removed theirs, or
117
+ // the browser keeps presenting the button and dispatching to the removed handler.
118
+ // Note: the browser invokes media session action handlers with a MediaSessionActionDetails argument.
119
+ // Wrap the user handler so it is called with the THEOplayer instance, matching the MediaControlHandler contract.
120
+ const previousTrackHandler = this.mediaControlAdapter.getHandler(MediaControlAction.SKIP_TO_PREVIOUS);
121
+ mediaSession.setActionHandler('previoustrack', previousTrackHandler ? () => previousTrackHandler(this._webAdapter) : NoOp);
122
+ const nextTrackHandler = this.mediaControlAdapter.getHandler(MediaControlAction.SKIP_TO_NEXT);
123
+ mediaSession.setActionHandler('nexttrack', nextTrackHandler ? () => nextTrackHandler(this._webAdapter) : NoOp);
124
+
125
+ // Update playbackState
84
126
  mediaSession.playbackState = this._player.paused ? 'paused' : 'playing';
85
127
 
86
- // update position
128
+ // Update position
87
129
  this.updatePositionState();
88
130
  }
89
131
 
@@ -91,11 +133,28 @@ export class WebMediaSession {
91
133
  this._player.removeEventListener(['play', 'playing'], this.onFirstPlaying);
92
134
  this._player.removeEventListener(['play', 'pause', 'loadedmetadata', 'durationchange', 'ratechange'], this.update);
93
135
  this._player.ads?.removeEventListener(['adbreakbegin', 'adbreakend'], this.update);
136
+ this.clearMediaSession();
137
+ // Make sure a late updateMediaSession() call, e.g. from a configuration setter, does not
138
+ // republish state for a destroyed player.
139
+ this._enabled = false;
140
+ }
141
+
142
+ private clearMediaSession() {
143
+ // Only clear the shared media session if this player owns it (or nobody does), so a disabled or
144
+ // destroyed player never wipes another (newly-active) owner's session during a hand-off.
145
+ if (WebMediaSession._currentOwner !== undefined && WebMediaSession._currentOwner !== this) {
146
+ return;
147
+ }
148
+ WebMediaSession._currentOwner = undefined;
94
149
  mediaSession.setActionHandler('play', NoOp);
95
150
  mediaSession.setActionHandler('pause', NoOp);
96
151
  mediaSession.setActionHandler('seekbackward', NoOp);
97
152
  mediaSession.setActionHandler('seekforward', NoOp);
98
153
  mediaSession.setActionHandler('seekto', NoOp);
154
+ mediaSession.setActionHandler('previoustrack', NoOp);
155
+ mediaSession.setActionHandler('nexttrack', NoOp);
156
+ mediaSession.metadata = null;
157
+ mediaSession.playbackState = 'none';
99
158
  }
100
159
 
101
160
  private update = () => {
@@ -113,12 +172,17 @@ export class WebMediaSession {
113
172
  this._player.removeEventListener(['play', 'playing'], this.onFirstPlaying);
114
173
  this._player.removeEventListener(['play', 'pause', 'loadedmetadata', 'durationchange', 'ratechange'], this.update);
115
174
  this._player.ads?.removeEventListener(['adbreakbegin', 'adbreakend'], this.update);
116
- mediaSession.metadata = null;
117
- mediaSession.playbackState = 'none';
175
+ if (this._enabled) {
176
+ mediaSession.metadata = null;
177
+ mediaSession.playbackState = 'none';
178
+ }
118
179
  this._player.addEventListener(['play', 'playing'], this.onFirstPlaying);
119
180
  };
120
181
 
121
182
  private updateMetadata = () => {
183
+ if (!this._enabled) {
184
+ return;
185
+ }
122
186
  const source = this._player.source;
123
187
  const metadata = source?.metadata;
124
188
  const artwork = [metadata?.displayIconUri, source?.poster, ...(metadata?.images ? metadata.images : [])]
package/src/manifest.json CHANGED
@@ -1 +1 @@
1
- {"version":"11.5.0","buildDate":"2026-08-04T11:29:00.061Z"}
1
+ {"version":"11.7.0","buildDate":"2026-09-19T14:43:33.039Z"}