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
@@ -24,6 +24,7 @@ export interface PlaybackState {
24
24
  buffered: TimeRange[];
25
25
  presentationMode: PresentationMode;
26
26
  aspectRatio: AspectRatio;
27
+ manageContentMatching: boolean;
27
28
  renderingTarget: RenderingTarget;
28
29
  }
29
30
 
@@ -12,11 +12,13 @@ import {
12
12
  findMediaTrackByUid,
13
13
  isVideoQuality,
14
14
  LoadedMetadataEvent,
15
+ MediaControlAPI,
15
16
  MediaTrack,
16
17
  MediaTrackEvent,
17
18
  MediaTrackEventType,
18
19
  MediaTrackListEvent,
19
20
  MediaTrackType,
21
+ MetricsAPI,
20
22
  NativeHandleType,
21
23
  PiPConfiguration,
22
24
  PlayerEventMap,
@@ -52,6 +54,8 @@ import { EventBroadcastAdapter } from './broadcast/EventBroadcastAdapter';
52
54
  import { DefaultNativePlayerState } from './DefaultNativePlayerState';
53
55
  import { THEOAdsNativeAdapter } from './theoads/THEOAdsNativeAdapter';
54
56
  import { TheoLiveNativeAdapter } from './theolive/TheoLiveNativeAdapter';
57
+ import { MediaControlNativeAdapter } from './media/MediaControlNativeAdapter';
58
+ import { MetricsNativeAdapter } from './metrics/MetricsNativeAdapter';
55
59
 
56
60
  const NativePlayerModule = NativeModules.THEORCTPlayerModule;
57
61
 
@@ -64,6 +68,8 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
64
68
  private readonly _abrAdapter: AbrAdapter;
65
69
  private readonly _textTrackStyleAdapter: TextTrackStyleAdapter;
66
70
  private readonly _theoliveAdapter: TheoLiveNativeAdapter;
71
+ private readonly _mediaControlAdapter: MediaControlNativeAdapter;
72
+ private readonly _metricsAdapter: MetricsNativeAdapter;
67
73
  private _externalEventRouter: EventBroadcastAPI | undefined = undefined;
68
74
  private _playerVersion!: PlayerVersion;
69
75
 
@@ -77,12 +83,15 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
77
83
  this._abrAdapter = new AbrAdapter(this._view);
78
84
  this._textTrackStyleAdapter = new TextTrackStyleAdapter(this._view);
79
85
  this._theoliveAdapter = new TheoLiveNativeAdapter(this._view);
86
+ this._mediaControlAdapter = new MediaControlNativeAdapter(this);
87
+ this._metricsAdapter = new MetricsNativeAdapter(this._view);
80
88
  this.addEventListeners();
81
89
  }
82
90
 
83
91
  private addEventListeners() {
84
92
  this.addEventListener(PlayerEventType.LOADED_METADATA, this.onLoadedMetadata);
85
93
  this.addEventListener(PlayerEventType.PAUSE, this.onPause);
94
+ this.addEventListener(PlayerEventType.PLAY, this.onPlay);
86
95
  this.addEventListener(PlayerEventType.PLAYING, this.onPlaying);
87
96
  this.addEventListener(PlayerEventType.TIME_UPDATE, this.onTimeupdate);
88
97
  this.addEventListener(PlayerEventType.DURATION_CHANGE, this.onDurationChange);
@@ -98,6 +107,7 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
98
107
  }
99
108
 
100
109
  public destroy() {
110
+ this._mediaControlAdapter.destroy();
101
111
  this.clearEventListeners();
102
112
  }
103
113
 
@@ -109,6 +119,10 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
109
119
  this._state.paused = true;
110
120
  };
111
121
 
122
+ private onPlay = () => {
123
+ this._state.paused = false;
124
+ };
125
+
112
126
  private onPlaying = () => {
113
127
  this._state.paused = false;
114
128
  };
@@ -243,6 +257,14 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
243
257
  return this._theoliveAdapter;
244
258
  }
245
259
 
260
+ get mediaControl(): MediaControlAPI {
261
+ return this._mediaControlAdapter;
262
+ }
263
+
264
+ get metrics(): MetricsAPI {
265
+ return this._metricsAdapter;
266
+ }
267
+
246
268
  set autoplay(autoplay: boolean) {
247
269
  this._state.autoplay = autoplay;
248
270
  NativePlayerModule.setAutoplay(this._view.nativeHandle, autoplay);
@@ -470,6 +492,17 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
470
492
  NativePlayerModule.setAspectRatio(this._view.nativeHandle, ratio);
471
493
  }
472
494
 
495
+ get manageContentMatching(): boolean {
496
+ return this._state.manageContentMatching;
497
+ }
498
+
499
+ set manageContentMatching(enable: boolean) {
500
+ if (Platform.OS === 'ios') {
501
+ this._state.manageContentMatching = enable;
502
+ NativePlayerModule.setManageContentMatching(this._view.nativeHandle, enable);
503
+ }
504
+ }
505
+
473
506
  get renderingTarget(): RenderingTarget {
474
507
  return this._state.renderingTarget;
475
508
  }
@@ -7,7 +7,9 @@ import {
7
7
  CmcdConfiguration,
8
8
  CmcdTransmissionMode,
9
9
  EventBroadcastAPI,
10
+ MediaControlAPI,
10
11
  MediaTrack,
12
+ MetricsAPI,
11
13
  NativeHandleType,
12
14
  PlayerConfiguration,
13
15
  PlayerEventMap,
@@ -38,6 +40,8 @@ import { DefaultTextTrackState } from './DefaultTextTrackState';
38
40
  import { THEOAdsWebAdapter } from './theoads/THEOAdsWebAdapter';
39
41
  import { CMCDConnector, Configuration, createCMCDConnector, TransmissionMode } from '@theoplayer/cmcd-connector-web';
40
42
  import { TheoLiveWebAdapter } from './theolive/TheoLiveWebAdapter';
43
+ import { MetricsWebAdapter } from './metrics/MetricsWebAdapter';
44
+ import { PlayerFacade } from './web/PlayerFacade';
41
45
 
42
46
  const defaultBackgroundAudioConfiguration: BackgroundAudioConfiguration = {
43
47
  enabled: false,
@@ -54,9 +58,11 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
54
58
  private readonly _textTrackState: TextTrackState;
55
59
  private readonly _presentationModeManager: WebPresentationModeManager;
56
60
  private readonly _theoliveAdapter: TheoLiveWebAdapter;
61
+ private readonly _metricsAdapter: MetricsWebAdapter;
62
+ private readonly _playerFacade: PlayerFacade | undefined;
57
63
  private _player: NativeChromelessPlayer | undefined;
58
64
  private _eventForwarder: WebEventForwarder | undefined;
59
- private _mediaSession: WebMediaSession | undefined = undefined;
65
+ private readonly _mediaSession: WebMediaSession;
60
66
  private _targetVideoQuality: number | number[] | undefined = undefined;
61
67
  private _backgroundAudioConfiguration: BackgroundAudioConfiguration = defaultBackgroundAudioConfiguration;
62
68
  private _pipConfiguration: PiPConfiguration = defaultPipConfiguration;
@@ -67,21 +73,30 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
67
73
 
68
74
  constructor(player: NativeChromelessPlayer, config?: PlayerConfiguration) {
69
75
  super();
70
- this._player = player;
76
+ this._playerFacade = config?.usePlayerFacade === true ? new PlayerFacade(player) : undefined;
77
+ this._player = this._playerFacade?.player ?? player;
71
78
  this._adsAdapter = new THEOplayerWebAdsAdapter(this._player);
72
79
  this._castAdapter = new THEOplayerWebCastAdapter(this._player);
73
80
  this._theoAdsAdapter = new THEOAdsWebAdapter(this._player);
74
81
  this._theoliveAdapter = new TheoLiveWebAdapter(this._player);
82
+ this._metricsAdapter = new MetricsWebAdapter(this._player);
75
83
  this._textTrackState = new DefaultTextTrackState(this);
76
84
  this._eventForwarder = new WebEventForwarder(this._player, this);
77
85
  this._presentationModeManager = new WebPresentationModeManager(this._player, this);
78
86
  document.addEventListener('visibilitychange', this.onVisibilityChange);
79
87
  this._player.addEventListener('dimensionchange', this.onPlayerDimensionChange);
80
88
 
81
- // Optionally create a media session connector
82
- if (config?.mediaControl?.mediaSessionEnabled !== false) {
83
- this._mediaSession = new WebMediaSession(this, player, config?.mediaControl);
84
- }
89
+ // Always create a media session connector so it can be toggled at runtime via mediaControl.setEnabled().
90
+ // The initial enabled state is derived from config.mediaControl.mediaSessionEnabled.
91
+ this._mediaSession = new WebMediaSession(this, this._player, config?.mediaControl);
92
+ }
93
+
94
+ get mediaControl(): MediaControlAPI {
95
+ return this._mediaSession.mediaControlAdapter;
96
+ }
97
+
98
+ get metrics(): MetricsAPI {
99
+ return this._metricsAdapter;
85
100
  }
86
101
 
87
102
  get abr(): ABRConfiguration | undefined {
@@ -206,7 +221,7 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
206
221
  this._backgroundAudioConfiguration = config;
207
222
 
208
223
  // Notify media session
209
- this._mediaSession?.updateMediaSession();
224
+ this._mediaSession.updateMediaSession();
210
225
  }
211
226
 
212
227
  get volume(): number {
@@ -351,6 +366,14 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
351
366
  // unused
352
367
  }
353
368
 
369
+ get manageContentMatching(): boolean {
370
+ return false;
371
+ }
372
+
373
+ set manageContentMatching(_enable: boolean) {
374
+ // unused
375
+ }
376
+
354
377
  get keepScreenOn(): boolean {
355
378
  return false;
356
379
  }
@@ -389,15 +412,18 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
389
412
  destroy(): void {
390
413
  this.dispatchEvent(new BaseEvent(PlayerEventType.DESTROY));
391
414
  this._eventForwarder?.unload();
392
- this._mediaSession?.destroy();
415
+ this._mediaSession.destroy();
393
416
  document.removeEventListener('visibilitychange', this.onVisibilityChange);
394
417
  this._eventForwarder = undefined;
395
- this._mediaSession = undefined;
396
418
  this._cmcdConnector?.destroy();
397
419
  this._cmcdConnector = undefined;
398
420
  this._player?.removeEventListener('dimensionchange', this.onPlayerDimensionChange);
399
- this._player?.destroy();
400
- this._player = undefined;
421
+ try {
422
+ this._player?.destroy();
423
+ } finally {
424
+ this._playerFacade?.close();
425
+ this._player = undefined;
426
+ }
401
427
  }
402
428
 
403
429
  private readonly onVisibilityChange = () => {
@@ -416,7 +442,7 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
416
442
  }
417
443
  }
418
444
  // Apply media session controls
419
- this._mediaSession?.updateMediaSession();
445
+ this._mediaSession.updateMediaSession();
420
446
  };
421
447
 
422
448
  private readonly onPlayerDimensionChange = (event: DimensionChangeEvent) => {
@@ -2,7 +2,7 @@ import type {
2
2
  AdBreakEvent as NativeAdBreakEvent,
3
3
  AddTrackEvent,
4
4
  AdEvent as NativeAdEvent,
5
- AdsEventMap as NativeAdsEventMap,
5
+ EventDispatcher,
6
6
  CastStateChangeEvent,
7
7
  ChromecastErrorEvent,
8
8
  ChromelessPlayer,
@@ -46,6 +46,7 @@ import {
46
46
  } from 'react-native-theoplayer';
47
47
  import type { Ad } from '../../api/ads/Ad';
48
48
  import type { AdBreak } from '../../api/ads/AdBreak';
49
+ import type { PlayerFacadeAdsEventMap as NativeAdsEventMap } from './web/PlayerFacadeTypes';
49
50
  import type { THEOplayerWebAdapter } from './THEOplayerWebAdapter';
50
51
  import { BaseEvent } from './event/BaseEvent';
51
52
  import {
@@ -54,6 +55,7 @@ import {
54
55
  DefaultChromecastChangeEvent,
55
56
  DefaultChromecastErrorEvent,
56
57
  DefaultContentProtectionErrorEvent,
58
+ DefaultContentProtectionSuccessEvent,
57
59
  DefaultCurrentSourceChangeEvent,
58
60
  DefaultDimensionChangeEvent,
59
61
  DefaultDurationChangeEvent,
@@ -115,6 +117,7 @@ export class WebEventForwarder {
115
117
  this._player.addEventListener('segmentnotfound', this.onSegmentNotFound);
116
118
  this._player.addEventListener('volumechange', this.onVolumeChangeEvent);
117
119
  this._player.addEventListener('contentprotectionerror', this.onContentProtectionError);
120
+ this._player.addEventListener('contentprotectionsuccess', this.onContentProtectionSuccess);
118
121
  this._player.addEventListener('dimensionchange', this.onDimensionChange);
119
122
  this._player.addEventListener('resize', this.onVideoResize);
120
123
 
@@ -134,7 +137,7 @@ export class WebEventForwarder {
134
137
  this._player.cast?.chromecast?.addEventListener('error', this.onChromecastError);
135
138
  this._player.cast?.airplay?.addEventListener('statechange', this.onAirplayStateChange);
136
139
 
137
- this._player.ads?.addEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
140
+ (this._player.ads as EventDispatcher<NativeAdsEventMap> | undefined)?.addEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
138
141
  this._player.ads?.addEventListener(FORWARDED_ADBREAK_EVENTS, this.onAdBreakEvent);
139
142
  this._player.theoads?.addEventListener(FORWARDED_THEOADS_EVENTS, this.onTheoAdsEvent);
140
143
  this._player.theoLive?.addEventListener(FORWARDED_THEOLIVE_EVENTS, this.onTheoLiveEvent);
@@ -167,6 +170,7 @@ export class WebEventForwarder {
167
170
  this._player.removeEventListener('segmentnotfound', this.onSegmentNotFound);
168
171
  this._player.removeEventListener('volumechange', this.onVolumeChangeEvent);
169
172
  this._player.removeEventListener('contentprotectionerror', this.onContentProtectionError);
173
+ this._player.removeEventListener('contentprotectionsuccess', this.onContentProtectionSuccess);
170
174
  this._player.removeEventListener('dimensionchange', this.onDimensionChange);
171
175
  this._player.removeEventListener('resize', this.onVideoResize);
172
176
 
@@ -186,7 +190,7 @@ export class WebEventForwarder {
186
190
  this._player.cast?.chromecast?.removeEventListener('error', this.onChromecastError);
187
191
  this._player.cast?.airplay?.removeEventListener('statechange', this.onAirplayStateChange);
188
192
 
189
- this._player.ads?.removeEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
193
+ (this._player.ads as EventDispatcher<NativeAdsEventMap> | undefined)?.removeEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
190
194
  this._player.ads?.removeEventListener(FORWARDED_ADBREAK_EVENTS, this.onAdBreakEvent);
191
195
  this._player.theoads?.removeEventListener(FORWARDED_THEOADS_EVENTS, this.onTheoAdsEvent);
192
196
  this._player.theoLive?.removeEventListener(FORWARDED_THEOLIVE_EVENTS, this.onTheoLiveEvent);
@@ -246,6 +250,10 @@ export class WebEventForwarder {
246
250
  );
247
251
  };
248
252
 
253
+ private readonly onContentProtectionSuccess = () => {
254
+ this._facade.dispatchEvent(new DefaultContentProtectionSuccessEvent());
255
+ };
256
+
249
257
  private readonly onProgress = () => {
250
258
  this._facade.dispatchEvent(new DefaultProgressEvent(fromTimeRanges(this._player.seekable), fromTimeRanges(this._player.buffered)));
251
259
  };
@@ -484,6 +492,7 @@ const FORWARDED_AD_EVENTS = [
484
492
  AdEventType.AD_THIRD_QUARTILE,
485
493
  AdEventType.AD_SKIP,
486
494
  AdEventType.AD_IMPRESSION,
495
+ AdEventType.AD_CLICKED,
487
496
  AdEventType.AD_ERROR,
488
497
  AdEventType.AD_METADATA,
489
498
  AdEventType.AD_BUFFERING,
@@ -12,6 +12,7 @@ import {
12
12
  ChromecastErrorEvent,
13
13
  ContentProtectionErrorEvent,
14
14
  ContentProtectionErrorObject,
15
+ ContentProtectionSuccessEvent,
15
16
  CurrentSourceChangeEvent,
16
17
  DimensionChangeEvent,
17
18
  DurationChangeEvent,
@@ -322,3 +323,12 @@ export class DefaultContentProtectionErrorEvent extends BaseEvent<PlayerEventTyp
322
323
  super(PlayerEventType.CONTENT_PROTECTION_ERROR);
323
324
  }
324
325
  }
326
+
327
+ export class DefaultContentProtectionSuccessEvent
328
+ extends BaseEvent<PlayerEventType.CONTENT_PROTECTION_SUCCESS>
329
+ implements ContentProtectionSuccessEvent
330
+ {
331
+ constructor() {
332
+ super(PlayerEventType.CONTENT_PROTECTION_SUCCESS);
333
+ }
334
+ }
@@ -167,6 +167,8 @@ export interface NativeContentProtectionErrorEvent {
167
167
  error: ContentProtectionErrorObject;
168
168
  }
169
169
 
170
+ export type NativeContentProtectionSuccessEvent = Record<string, never>;
171
+
170
172
  export interface NativePlayerStateEvent {
171
173
  readonly version: PlayerVersion;
172
174
 
@@ -0,0 +1,38 @@
1
+ import { THEOplayer, MediaControlAction, MediaControlAPI, MediaControlHandler } from 'react-native-theoplayer';
2
+ import { EmitterSubscription, NativeEventEmitter, NativeModules } from 'react-native';
3
+
4
+ const NativeMediaControlModule = NativeModules.THEORCTMediaControlModule;
5
+
6
+ export class MediaControlNativeAdapter implements MediaControlAPI {
7
+ private mediaControlEmitter = new NativeEventEmitter(NativeMediaControlModule);
8
+ private handlers: Map<MediaControlAction, MediaControlHandler> = new Map();
9
+ private readonly _subscription: EmitterSubscription;
10
+
11
+ constructor(private readonly _player: THEOplayer) {
12
+ this._subscription = this.mediaControlEmitter.addListener('MediaControlEvent', (event) => {
13
+ const { tag, action } = event;
14
+ if (tag === this._player.nativeHandle) {
15
+ this.handlers.get(action)?.(this._player);
16
+ }
17
+ });
18
+ }
19
+
20
+ setHandler(action: MediaControlAction, handler: MediaControlHandler | undefined): void {
21
+ if (handler === undefined) {
22
+ this.handlers.delete(action);
23
+ NativeMediaControlModule.removeHandler(this._player.nativeHandle || -1, action);
24
+ return;
25
+ }
26
+ this.handlers.set(action, handler);
27
+ NativeMediaControlModule.setHandler(this._player.nativeHandle || -1, action);
28
+ }
29
+
30
+ setEnabled(enabled: boolean): void {
31
+ NativeMediaControlModule.setEnabled(this._player.nativeHandle || -1, enabled);
32
+ }
33
+
34
+ destroy(): void {
35
+ this._subscription.remove();
36
+ this.handlers.clear();
37
+ }
38
+ }
@@ -0,0 +1,28 @@
1
+ import { MediaControlAction, MediaControlAPI, MediaControlHandler } from 'react-native-theoplayer';
2
+ import { WebMediaSession } from '../web/WebMediaSession';
3
+
4
+ export class MediaControlWebAdapter implements MediaControlAPI {
5
+ private handlers: Map<MediaControlAction, MediaControlHandler> = new Map();
6
+
7
+ constructor(private readonly mediaSession: WebMediaSession) {}
8
+
9
+ setHandler(action: MediaControlAction, handler: MediaControlHandler | undefined): void {
10
+ if (handler === undefined) {
11
+ this.handlers.delete(action);
12
+ } else {
13
+ this.handlers.set(action, handler);
14
+ }
15
+ this.mediaSession.updateMediaSession();
16
+ }
17
+
18
+ /**
19
+ * @internal Used by {@link WebMediaSession} to dispatch a media session action to the user's handler.
20
+ */
21
+ getHandler(action: MediaControlAction): MediaControlHandler | undefined {
22
+ return this.handlers.get(action);
23
+ }
24
+
25
+ setEnabled(enabled: boolean): void {
26
+ this.mediaSession.setEnabled(enabled);
27
+ }
28
+ }
@@ -0,0 +1,12 @@
1
+ import type { MetricsAPI, THEOplayerView } from 'react-native-theoplayer';
2
+ import { NativeModules } from 'react-native';
3
+
4
+ const NativeMetricsModule = NativeModules.THEORCTMetricsModule;
5
+
6
+ export class MetricsNativeAdapter implements MetricsAPI {
7
+ constructor(private readonly _view: THEOplayerView) {}
8
+
9
+ currentBandwidthEstimate(): Promise<number> {
10
+ return NativeMetricsModule.currentBandwidthEstimate(this._view.nativeHandle);
11
+ }
12
+ }
@@ -0,0 +1,14 @@
1
+ import type { MetricsAPI } from 'react-native-theoplayer';
2
+ import type { ChromelessPlayer } from 'theoplayer';
3
+
4
+ export class MetricsWebAdapter implements MetricsAPI {
5
+ private readonly _player: ChromelessPlayer;
6
+
7
+ constructor(player: ChromelessPlayer) {
8
+ this._player = player;
9
+ }
10
+
11
+ currentBandwidthEstimate(): Promise<number> {
12
+ return Promise.resolve(this._player.metrics?.currentBandwidthEstimate ?? 0);
13
+ }
14
+ }
@@ -0,0 +1,57 @@
1
+ import type { PlayerEventMap } from 'theoplayer';
2
+ import type { PlayerFacadeEvent } from './PlayerFacadeTypes';
3
+
4
+ /**
5
+ * Controls event delivery and the lifetime of a registered Web integration.
6
+ *
7
+ * @category Player
8
+ * @platform web
9
+ * @internal
10
+ */
11
+ export interface IntegrationRegistration {
12
+ /**
13
+ * Compatibility entry point for player events; equivalent to dispatchEvent(event).
14
+ *
15
+ * @param event - The player event to deliver to facade listeners.
16
+ */
17
+ dispatchPlayerEvent<TEvent extends PlayerEventMap[keyof PlayerEventMap]>(event: TEvent): void;
18
+
19
+ /**
20
+ * Routes typed THEOplayer events to player or player.ads listeners without emitting on the content player.
21
+ * Bypasses backing-event interceptors and ignores calls after the registration closes.
22
+ *
23
+ * @param event - The player or advertising event to deliver. Advertising events go only to Ads listeners.
24
+ */
25
+ dispatchEvent<TEvent extends PlayerFacadeEvent>(event: TEvent): void;
26
+
27
+ /**
28
+ * Return true to consume a backing-player event before facade listeners receive it.
29
+ * Dispose explicitly: interceptors survive unregistering to allow already-queued events to drain.
30
+ *
31
+ * @param type - The event type to intercept, even when it has no facade listeners.
32
+ * @param interceptor - Called once per event; return `false` to continue delivery.
33
+ * @returns An idempotent disposer. Closed registrations return a no-op disposer.
34
+ */
35
+ interceptPlayerEvent<TType extends keyof PlayerEventMap>(type: TType, interceptor: (event: PlayerEventMap[TType]) => boolean): () => void;
36
+
37
+ /**
38
+ * Filters every subscribed backing-player event after type-specific interceptors, including future subscriptions.
39
+ * Uses the same explicit disposer lifetime; integration dispatch bypasses this filter.
40
+ *
41
+ * @param interceptor - Return `true` to consume the event, or `false` to continue delivery.
42
+ * @returns An idempotent disposer. Closed registrations return a no-op disposer.
43
+ *
44
+ * @remarks
45
+ * This does not subscribe to otherwise unobserved event types. Consuming a native destroy event does not prevent facade cleanup.
46
+ */
47
+ interceptPlayerEvents(interceptor: (event: PlayerEventMap[keyof PlayerEventMap]) => boolean): () => void;
48
+
49
+ /**
50
+ * Restores content-player delegation without destroying the content player.
51
+ *
52
+ * @remarks
53
+ * Idempotent. Stops integration dispatch and restores native Ads subscriptions.
54
+ * Existing player-event interceptors remain until explicitly disposed or the facade closes.
55
+ */
56
+ close(): void;
57
+ }