react-native-theoplayer 11.6.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 (193) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +69 -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 +2 -2
  6. package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +37 -8
  7. package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +3 -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/metrics/MetricsModule.kt +37 -0
  20. package/android/src/main/java/com/theoplayer/theoads/THEOadsModule.kt +1 -1
  21. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeAdsBridgeTest.kt +250 -0
  22. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeConfigurationTest.kt +30 -0
  23. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTest.kt +507 -0
  24. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTestHost.kt +104 -0
  25. package/ios/THEOplayerRCTBridge.m +19 -0
  26. package/ios/THEOplayerRCTPlayerAPI.swift +31 -0
  27. package/ios/Theoplayer-Bridging-Header.h +0 -1
  28. package/ios/metrics/THEOplayerRCTMetricsAPI.swift +31 -0
  29. package/lib/commonjs/api/barrel.js +31 -20
  30. package/lib/commonjs/api/barrel.js.map +1 -1
  31. package/lib/commonjs/api/metrics/MetricsAPI.js +2 -0
  32. package/lib/commonjs/api/metrics/MetricsAPI.js.map +1 -0
  33. package/lib/commonjs/api/metrics/barrel.js +17 -0
  34. package/lib/commonjs/api/metrics/barrel.js.map +1 -0
  35. package/lib/commonjs/api/player/Integration.js +2 -0
  36. package/lib/commonjs/api/player/Integration.js.map +1 -0
  37. package/lib/commonjs/api/player/THEOplayer.js.map +1 -1
  38. package/lib/commonjs/api/player/barrel.js +11 -0
  39. package/lib/commonjs/api/player/barrel.js.map +1 -1
  40. package/lib/commonjs/api/track/MediaTrack.js +16 -0
  41. package/lib/commonjs/api/track/MediaTrack.js.map +1 -1
  42. package/lib/commonjs/internal/THEOplayerView.js +2 -0
  43. package/lib/commonjs/internal/THEOplayerView.js.map +1 -1
  44. package/lib/commonjs/internal/THEOplayerView.web.js +3 -1
  45. package/lib/commonjs/internal/THEOplayerView.web.js.map +1 -1
  46. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js +1 -0
  47. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  48. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js +18 -0
  49. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
  50. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +21 -4
  51. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  52. package/lib/commonjs/internal/adapter/WebEventForwarder.js +1 -1
  53. package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
  54. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js +18 -0
  55. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  56. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js +16 -0
  57. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  58. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js +6 -0
  59. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  60. package/lib/commonjs/internal/adapter/web/PlayerFacade.js +258 -0
  61. package/lib/commonjs/internal/adapter/web/PlayerFacade.js.map +1 -0
  62. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js +6 -0
  63. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  64. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js +114 -0
  65. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  66. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js +6 -0
  67. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  68. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js +6 -0
  69. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  70. package/lib/commonjs/manifest.json +1 -1
  71. package/lib/module/api/barrel.js +1 -0
  72. package/lib/module/api/barrel.js.map +1 -1
  73. package/lib/module/api/metrics/MetricsAPI.js +2 -0
  74. package/lib/module/api/metrics/MetricsAPI.js.map +1 -0
  75. package/lib/module/api/metrics/barrel.js +4 -0
  76. package/lib/module/api/metrics/barrel.js.map +1 -0
  77. package/lib/module/api/player/Integration.js +2 -0
  78. package/lib/module/api/player/Integration.js.map +1 -0
  79. package/lib/module/api/player/THEOplayer.js.map +1 -1
  80. package/lib/module/api/player/barrel.js +1 -0
  81. package/lib/module/api/player/barrel.js.map +1 -1
  82. package/lib/module/api/track/MediaTrack.js +16 -0
  83. package/lib/module/api/track/MediaTrack.js.map +1 -1
  84. package/lib/module/internal/THEOplayerView.js +2 -0
  85. package/lib/module/internal/THEOplayerView.js.map +1 -1
  86. package/lib/module/internal/THEOplayerView.web.js +3 -1
  87. package/lib/module/internal/THEOplayerView.web.js.map +1 -1
  88. package/lib/module/internal/adapter/DefaultNativePlayerState.js +1 -0
  89. package/lib/module/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  90. package/lib/module/internal/adapter/THEOplayerAdapter.js +18 -0
  91. package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
  92. package/lib/module/internal/adapter/THEOplayerWebAdapter.js +21 -4
  93. package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  94. package/lib/module/internal/adapter/WebEventForwarder.js +1 -1
  95. package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
  96. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js +13 -0
  97. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  98. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js +11 -0
  99. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  100. package/lib/module/internal/adapter/web/IntegrationRegistration.js +4 -0
  101. package/lib/module/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  102. package/lib/module/internal/adapter/web/PlayerFacade.js +253 -0
  103. package/lib/module/internal/adapter/web/PlayerFacade.js.map +1 -0
  104. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js +4 -0
  105. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  106. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js +109 -0
  107. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  108. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js +4 -0
  109. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  110. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js +4 -0
  111. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  112. package/lib/module/manifest.json +1 -1
  113. package/lib/typescript/__tests__/PlayerFacade.test.d.ts +2 -0
  114. package/lib/typescript/__tests__/PlayerFacade.test.d.ts.map +1 -0
  115. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts +2 -0
  116. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts.map +1 -0
  117. package/lib/typescript/__tests__/index.test.d.ts +13 -0
  118. package/lib/typescript/__tests__/index.test.d.ts.map +1 -1
  119. package/lib/typescript/api/THEOplayerView.d.ts +4 -0
  120. package/lib/typescript/api/THEOplayerView.d.ts.map +1 -1
  121. package/lib/typescript/api/barrel.d.ts +1 -0
  122. package/lib/typescript/api/barrel.d.ts.map +1 -1
  123. package/lib/typescript/api/config/PlayerConfiguration.d.ts +15 -0
  124. package/lib/typescript/api/config/PlayerConfiguration.d.ts.map +1 -1
  125. package/lib/typescript/api/event/AdEvent.d.ts +1 -1
  126. package/lib/typescript/api/metrics/MetricsAPI.d.ts +21 -0
  127. package/lib/typescript/api/metrics/MetricsAPI.d.ts.map +1 -0
  128. package/lib/typescript/api/metrics/barrel.d.ts +2 -0
  129. package/lib/typescript/api/metrics/barrel.d.ts.map +1 -0
  130. package/lib/typescript/api/player/Integration.d.ts +88 -0
  131. package/lib/typescript/api/player/Integration.d.ts.map +1 -0
  132. package/lib/typescript/api/player/THEOplayer.d.ts +19 -0
  133. package/lib/typescript/api/player/THEOplayer.d.ts.map +1 -1
  134. package/lib/typescript/api/player/barrel.d.ts +1 -0
  135. package/lib/typescript/api/player/barrel.d.ts.map +1 -1
  136. package/lib/typescript/api/track/MediaTrack.d.ts +21 -4
  137. package/lib/typescript/api/track/MediaTrack.d.ts.map +1 -1
  138. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts +1 -0
  139. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts.map +1 -1
  140. package/lib/typescript/internal/adapter/NativePlayerState.d.ts +1 -0
  141. package/lib/typescript/internal/adapter/NativePlayerState.d.ts.map +1 -1
  142. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts +6 -1
  143. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
  144. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +6 -1
  145. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
  146. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
  147. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts +7 -0
  148. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts.map +1 -0
  149. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts +8 -0
  150. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts.map +1 -0
  151. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts +53 -0
  152. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts.map +1 -0
  153. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts +26 -0
  154. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts.map +1 -0
  155. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts +33 -0
  156. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts.map +1 -0
  157. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts +21 -0
  158. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts.map +1 -0
  159. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts +43 -0
  160. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts.map +1 -0
  161. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts +13 -0
  162. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts.map +1 -0
  163. package/package.json +1 -1
  164. package/react-native-theoplayer.podspec +7 -7
  165. package/src/__tests__/PlayerFacade.test.ts +579 -0
  166. package/src/__tests__/PlayerFacadeWebAdapter.test.ts +193 -0
  167. package/src/__tests__/index.test.tsx +15 -1
  168. package/src/api/THEOplayerView.ts +5 -0
  169. package/src/api/barrel.ts +1 -0
  170. package/src/api/config/PlayerConfiguration.ts +16 -0
  171. package/src/api/event/AdEvent.ts +1 -1
  172. package/src/api/metrics/MetricsAPI.ts +20 -0
  173. package/src/api/metrics/barrel.ts +1 -0
  174. package/src/api/player/Integration.ts +97 -0
  175. package/src/api/player/THEOplayer.ts +21 -0
  176. package/src/api/player/barrel.ts +1 -0
  177. package/src/api/track/MediaTrack.ts +21 -4
  178. package/src/internal/THEOplayerView.tsx +2 -2
  179. package/src/internal/THEOplayerView.web.tsx +2 -2
  180. package/src/internal/adapter/DefaultNativePlayerState.ts +1 -0
  181. package/src/internal/adapter/NativePlayerState.ts +1 -0
  182. package/src/internal/adapter/THEOplayerAdapter.ts +24 -0
  183. package/src/internal/adapter/THEOplayerWebAdapter.ts +27 -4
  184. package/src/internal/adapter/WebEventForwarder.ts +5 -3
  185. package/src/internal/adapter/metrics/MetricsNativeAdapter.ts +12 -0
  186. package/src/internal/adapter/metrics/MetricsWebAdapter.ts +14 -0
  187. package/src/internal/adapter/web/IntegrationRegistration.ts +57 -0
  188. package/src/internal/adapter/web/PlayerFacade.ts +281 -0
  189. package/src/internal/adapter/web/PlayerFacadeAPI.ts +35 -0
  190. package/src/internal/adapter/web/PlayerFacadeAdsEvents.ts +119 -0
  191. package/src/internal/adapter/web/PlayerFacadeIntegration.ts +45 -0
  192. package/src/internal/adapter/web/PlayerFacadeTypes.ts +14 -0
  193. package/src/manifest.json +1 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.1.0/)
6
6
  and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [11.7.0] - 18-09-26
9
+
10
+ ### Added
11
+
12
+ - Added the `Metrics` API, accessible through `player.metrics`, with `currentBandwidthEstimate` returning the player's estimated available bandwidth in bits per second. On iOS/tvOS this value is only reported for THEOlive/HESP streams.
13
+ - Added `THEOplayer.manageContentMatching` to let the player match the display mode (frame rate and dynamic range) of the TV to the content before playback starts on tvOS.
14
+ - Added a `testID` property on `THEOplayerView` to allow locating the player view from UI automation tools.
15
+
16
+ ### Fixed
17
+
18
+ - Fixed media track kind typings to accept audio descriptions and other stream- or platform-specific values without type overrides.
19
+ - Fixed an issue on Android where destroying the player during a pending `MediaPlaybackService` bind could cause a crash.
20
+ - Fixed an issue on Android where the player could remain black when its view was attached after React Native had already assigned the layout.
21
+ - Fixed an issue where `player.paused` remained `true` between the `play` and `playing` events.
22
+
23
+ ### Changed
24
+
25
+ - Removed the `RCTRootContentView` import from the iOS bridging header, as it is removed in React Native 0.87.
26
+ - Upgraded example app to support React Native v0.87.1.
27
+
8
28
  ## [11.6.0]
9
29
 
10
30
  ### Added
package/README.md CHANGED
@@ -33,6 +33,73 @@ by the `@theoplayer/react-native-ui` package.
33
33
  It also gives a description of the properties of the `THEOplayerView` component, and
34
34
  a list of features and known limitations.
35
35
 
36
+ ### Player facade (Web and Android)
37
+
38
+ Set `usePlayerFacade: true` in the player configuration at creation to enable the facade.
39
+ The default is `false`; iOS and tvOS do not support this option.
40
+ On Web, the facade is available at `player.nativeHandle`.
41
+ Integrations can register through `registerIntegration`, dispatch THEOplayer player
42
+ and ad events (including `adclicked`), and supply a clock through `getCurrentTime()` in
43
+ seconds. The wrapper forwards `adclicked` to React Native's ad-event stream.
44
+ Close the registration before replacing an integration. Playback engines and ad
45
+ schedulers should use `facade.contentPlayer`, not the facade's overridden ad clock.
46
+
47
+ Integrations can provide an `ads` object implementing the Ads API and its event
48
+ subscriptions. The stable public `player.ads` delegates to that object, including
49
+ scheduling queries and controls. Existing listeners migrate when an integration
50
+ registers or closes; native Ads behavior returns after removal. The earlier
51
+ `getAdState()` and `shouldConsumeAdEvent(event)` hooks remain available for
52
+ integrations without an Ads object. The facade never reconstructs ad lifecycle.
53
+
54
+ `getMuted()` / `setMuted(value)` and `getVolume()` / `setVolume(value)` route audio
55
+ through an integration. Setters return `true` when handled; otherwise the facade
56
+ falls back to content. Nullish getter results also fall back to content.
57
+ `registration.dispatchEvent(event)` accepts typed THEOplayer player and ad events.
58
+ Ad events route to `player.ads` listeners; player events such as `playing`, `waiting`,
59
+ and `volumechange` route to `player` listeners. Dispatch does not emit on the content
60
+ player or pass through backing-event interceptors. Closed registrations cannot emit.
61
+ `registration.dispatchPlayerEvent(event)` remains a compatible player-event entry point.
62
+ Playback ownership and audio synchronization remain integration responsibilities.
63
+
64
+ `registration.interceptPlayerEvent(type, callback)` lets an integration inspect a
65
+ backing player event once before facade listeners receive it. Return `true` to
66
+ consume the event, or `false` to forward it. Raw player listeners are unaffected.
67
+ The returned disposer removes the interceptor. Existing interceptors remain until
68
+ disposed or the facade is destroyed, allowing an integration to drain already-queued
69
+ events after unregistering; a closed registration cannot install new interceptors.
70
+ `registration.interceptPlayerEvents(callback)` applies the same policy to every
71
+ subscribed backing-player event, including subscriptions added later. Type-specific
72
+ interceptors run first; integration-dispatched events bypass both kinds. Use a
73
+ type-specific interceptor when an event must be observed even without consumers.
74
+ An optional `isSeeking()` integration hook overrides the public seeking state;
75
+ nullish results fall back to the backing player.
76
+ Pause/seek ownership, pending transitions, lifecycle exceptions and ad lifecycle
77
+ decisions belong to the integration, not the facade.
78
+
79
+ On Android, implement `com.theoplayer.integration.Integration` and call
80
+ `ReactTHEOplayerView.registerIntegration(integration)` after the view is initialized.
81
+ The returned `IntegrationRegistration` supports the same dispatch and interception
82
+ semantics using native Android SDK events. Interceptor disposers implement `Closeable`;
83
+ call `close()` to remove them. Access the raw engine through
84
+ `(view.player as PlayerFacade).contentPlayer`. Time values are in seconds on both platforms.
85
+ Android's `getAdState()` returns a `PlayerFacadeAdState`; its nullable result delegates
86
+ to native Ads. The facade permits registration during native ads and does not infer
87
+ state or suppress native ad events merely because an integration is registered.
88
+ Native SDK extensions (`theoAds`, `ima`, `dai`) resolve against the raw player or Ads
89
+ object through the facade-aware extensions in `com.theoplayer.integration`.
90
+
91
+ Custom advertising must not overlap ongoing native IMA/DAI playback on Android.
92
+ Finish or reset native advertising before taking over. Replacing/filtering native
93
+ ad events can suspend the RN bridge's native DAI bookkeeping, so fresh native state
94
+ after hidden native playback is not guaranteed. `ReactTHEOplayerView.adsApi` remains
95
+ the native source-specific adapter/event sink; use `view.player.ads` for facade state.
96
+ React Native Ads queries and controls use a facade-aware bridge with native fallback.
97
+
98
+ Focused facade regression tests (Node 22.18+):
99
+ `node --test src/__tests__/PlayerFacade.test.ts`.
100
+ Android tests, from `example/android`:
101
+ `./gradlew :react-native-theoplayer:testDebugUnitTest --tests 'com.theoplayer.integration.PlayerFacade*Test' --console=plain`.
102
+
36
103
  ## Prerequisites
37
104
 
38
105
  For each platform, a dependency to the corresponding THEOplayer SDK is included through a dependency manager:
@@ -183,11 +250,13 @@ This section gives an overview of features, limitations and known issues:
183
250
  - [Background playback and notifications](./doc/background.md)
184
251
  - [Casting with Chromecast and Airplay](./doc/cast.md)
185
252
  - [Common Media Client Data (CMCD)](./doc/cmcd.md)
253
+ - [Content matching on tvOS](./doc/content-matching.md)
186
254
  - [Digital Rights Management (DRM)](./doc/drm.md)
187
255
  - [Expo](./doc/expo.md)
188
256
  - [Fullscreen presentation](./doc/fullscreen.md)
189
257
  - [Media Control](./doc/mediacontrol.md)
190
258
  - [Media Caching](./doc/media-caching.md)
259
+ - [Metrics](./doc/metrics.md)
191
260
  - [Migrating to THEOplayer 9.x](./doc/migrating-to-react-native-theoplayer-9.md)
192
261
  - [Migrating to THEOplayer 10.x🔥](./doc/migrating-to-react-native-theoplayer-10.md)
193
262
  - [Millicast](./doc/millicast.md)
@@ -167,6 +167,7 @@ dependencies {
167
167
  implementation("com.theoplayer.theoplayer-sdk-android:core:$theoVersion")
168
168
  implementation("com.theoplayer.theoplayer-sdk-android:ads-wrapper:$theoAdsWrapperVersion")
169
169
  implementation("com.theoplayer.android-connector:mediasession:$theoMediaSessionVersion")
170
+ testImplementation("junit:junit:4.13.2")
170
171
 
171
172
  addOptiViewIntegration(enabledGoogleIMA || enabledGoogleDAI || enabledTHEOads, 'integration-ads-ima')
172
173
  addOptiViewIntegration(enabledGoogleDAI || enabledTHEOads, 'integration-ads-dai')
@@ -47,6 +47,7 @@ private const val PROP_THEOLIVE_DISCOVERY_URL = "discoveryUrl"
47
47
  private const val PROP_HLS_DATERANGE = "hlsDateRange"
48
48
  private const val PROP_MULTIMEDIA_TUNNELING_ENABLED = "tunnelingEnabled"
49
49
  private const val PROP_DEBUG_LOGS_ENABLED = "debugLogsEnabled"
50
+ private const val PROP_USE_PLAYER_FACADE = "usePlayerFacade"
50
51
  private const val PROP_SYSTEM_CAPTION_STYLE = "useSystemCaptionStyle"
51
52
  private const val PROP_CMCD = "cmcd"
52
53
  private const val PROP_CMCD_EXTERNAL_SESSION_ID = "externalSessionId"
@@ -57,6 +58,11 @@ private const val PROP_CMCD_ENDPOINT_URL = "url"
57
58
 
58
59
  class PlayerConfigAdapter(private val configProps: ReadableMap?) {
59
60
 
61
+ /** Returns whether the player facade is enabled at creation. Missing or null values default to false. */
62
+ fun usePlayerFacade(): Boolean = configProps?.let {
63
+ it.hasKey(PROP_USE_PLAYER_FACADE) && !it.isNull(PROP_USE_PLAYER_FACADE) && it.getBoolean(PROP_USE_PLAYER_FACADE)
64
+ } ?: false
65
+
60
66
  /**
61
67
  * Whether debug logs from the native SDK should be enabled.
62
68
  */
@@ -12,7 +12,7 @@ import com.facebook.react.uimanager.common.UIManagerType
12
12
  import com.theoplayer.ads.AdEventAdapter
13
13
  import com.theoplayer.ads.AdEventAdapter.AdEventEmitter
14
14
  import com.theoplayer.android.api.THEOplayerGlobal
15
- import com.theoplayer.android.api.ads.theoads.theoAds
15
+ import com.theoplayer.integration.theoAds
16
16
  import com.theoplayer.android.api.error.THEOplayerException
17
17
  import com.theoplayer.android.api.event.EventListener
18
18
  import com.theoplayer.android.api.event.EventType
@@ -412,7 +412,7 @@ class PlayerEventEmitter internal constructor(
412
412
  private fun onPause() {
413
413
  val player = playerView.player
414
414
  // Do not forward the pause event in case the content player is paused because the ad player starts.
415
- if (player != null && (!playerView.adsApi.isPlaying || player.isPaused)) {
415
+ if (player != null && (!playerView.adBridge.isPlaying || player.isPaused)) {
416
416
  receiveEvent(EVENT_PAUSE, null)
417
417
  }
418
418
  }
@@ -37,6 +37,7 @@ import com.theoplayer.android.connector.mediasession.MediaSessionConnector
37
37
  import com.theoplayer.audio.AudioBecomingNoisyManager
38
38
  import com.theoplayer.audio.AudioFocusManager
39
39
  import com.theoplayer.audio.BackgroundAudioConfig
40
+ import com.theoplayer.integration.PlayerFacade
40
41
  import com.theoplayer.media.MediaControlProxy
41
42
  import com.theoplayer.media.MediaPlaybackService
42
43
  import com.theoplayer.media.MediaSessionConfig
@@ -51,6 +52,7 @@ class ReactTHEOplayerContext private constructor(
51
52
  private val mainHandler = Handler(Looper.getMainLooper())
52
53
  private var isBound = AtomicBoolean()
53
54
  private var binder: MediaPlaybackService.MediaPlaybackBinder? = null
55
+ private var isDestroyed = false
54
56
 
55
57
  private var audioBecomingNoisyManager = AudioBecomingNoisyManager(reactContext) {
56
58
  // Audio is about to become 'noisy' due to a change in audio outputs: pause the player
@@ -101,9 +103,11 @@ class ReactTHEOplayerContext private constructor(
101
103
  }
102
104
 
103
105
  lateinit var playerView: THEOplayerView
106
+ lateinit var player: Player
107
+ private set
104
108
 
105
- val player: Player
106
- get() = playerView.player
109
+ val playerFacade: PlayerFacade?
110
+ get() = player as? PlayerFacade
107
111
 
108
112
  private val uiModeManager by lazy {
109
113
  reactContext.getSystemService(Context.UI_MODE_SERVICE) as? UiModeManager
@@ -135,6 +139,17 @@ class ReactTHEOplayerContext private constructor(
135
139
 
136
140
  private val connection = object : ServiceConnection {
137
141
  override fun onServiceConnected(className: ComponentName, service: IBinder) {
142
+ // The context may have been destroyed while the bind was still pending.
143
+ // Do not attach the destroyed player/context to the service.
144
+ if (isDestroyed) {
145
+ try {
146
+ reactContext.unbindService(this)
147
+ } catch (e: IllegalArgumentException) {
148
+ // Connection was not registered or already unbound; ignore.
149
+ }
150
+ return
151
+ }
152
+
138
153
  binder = service as MediaPlaybackService.MediaPlaybackBinder
139
154
 
140
155
  // Get media session connector from service
@@ -202,11 +217,13 @@ class ReactTHEOplayerContext private constructor(
202
217
  }
203
218
 
204
219
  private fun unbindMediaPlaybackService() {
205
- // This client is done interacting with the service: unbind.
206
- // When there are no clients bound to the service, the system destroys the service.
207
- if (binder?.isBinderAlive == true) {
208
- if (isBound.getAndSet(false)) {
220
+ // Always unbind when isBound, regardless of whether the binder is alive yet: a pending
221
+ // bind must still be cancelled so a late callback cannot resurrect this.
222
+ if (isBound.getAndSet(false)) {
223
+ try {
209
224
  reactContext.unbindService(connection)
225
+ } catch (e: IllegalArgumentException) {
226
+ // Service was not registered or already unbound; ignore.
210
227
  }
211
228
  }
212
229
  binder = null
@@ -234,6 +251,7 @@ class ReactTHEOplayerContext private constructor(
234
251
  mainHandler.post { measureAndLayout() }
235
252
  }
236
253
  }
254
+ player = PlayerFacade.create(playerView.player, configAdapter.usePlayerFacade())
237
255
 
238
256
  // By default, choose SURFACE_CONTROL/SURFACE_VIEW rendering target, based on API level.
239
257
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
@@ -472,8 +490,13 @@ class ReactTHEOplayerContext private constructor(
472
490
  }
473
491
 
474
492
  fun destroy() {
493
+ isDestroyed = true
475
494
  removeListeners()
476
495
 
496
+ // The media session can be shared with other player contexts through the playback service.
497
+ // Determine ownership before unbinding, as that clears the binder needed to check it.
498
+ val ownedMediaSession = ownsMediaSession()
499
+
477
500
  if (BuildConfig.USE_PLAYBACK_SERVICE) {
478
501
  // Remove service from foreground
479
502
  binder?.stopForegroundService()
@@ -483,7 +506,13 @@ class ReactTHEOplayerContext private constructor(
483
506
  }
484
507
  audioFocusManager?.abandonAudioFocus()
485
508
  mediaControlProxy.destroy()
486
- mediaSessionConnector?.destroy()
487
- playerView.onDestroy()
509
+ if (ownedMediaSession) {
510
+ // Only tear down the session when another player did not take it over: a queued callback
511
+ // must never reach this destroyed player, but a newly-activated player must keep working.
512
+ mediaSessionConnector?.player = null
513
+ mediaSessionConnector?.destroy()
514
+ }
515
+ val facade = playerFacade
516
+ if (facade != null) facade.destroyContent { playerView.onDestroy() } else playerView.onDestroy()
488
517
  }
489
518
  }
@@ -11,6 +11,7 @@ import com.theoplayer.drm.ContentProtectionModule
11
11
  import com.theoplayer.cast.CastModule
12
12
  import com.theoplayer.broadcast.EventBroadcastModule
13
13
  import com.theoplayer.media.MediaControlModule
14
+ import com.theoplayer.metrics.MetricsModule
14
15
  import com.theoplayer.player.PlayerModule
15
16
  import com.theoplayer.theolive.THEOliveModule
16
17
  import com.theoplayer.theoads.THEOadsModule
@@ -28,6 +29,7 @@ class ReactTHEOplayerPackage : BaseReactPackage() {
28
29
  THEOliveModule.NAME -> THEOliveModule(reactContext)
29
30
  THEOadsModule.NAME -> THEOadsModule(reactContext)
30
31
  MediaControlModule.NAME -> MediaControlModule(reactContext)
32
+ MetricsModule.NAME -> MetricsModule(reactContext)
31
33
  else -> null
32
34
  }
33
35
  }
@@ -48,6 +50,7 @@ class ReactTHEOplayerPackage : BaseReactPackage() {
48
50
  THEOliveModule.NAME to THEOliveModule.INFO,
49
51
  THEOadsModule.NAME to THEOadsModule.INFO,
50
52
  MediaControlModule.NAME to MediaControlModule.INFO,
53
+ MetricsModule.NAME to MetricsModule.INFO,
51
54
  )
52
55
  }
53
56
  }
@@ -2,8 +2,10 @@ package com.theoplayer
2
2
 
3
3
  import android.annotation.SuppressLint
4
4
  import android.util.Log
5
+ import android.view.View
5
6
  import android.view.ViewGroup
6
7
  import android.widget.FrameLayout
8
+ import androidx.annotation.MainThread
7
9
  import com.facebook.react.bridge.*
8
10
  import com.facebook.react.uimanager.ThemedReactContext
9
11
  import com.theoplayer.android.api.ads.wrapper.AdsApiWrapper
@@ -11,6 +13,9 @@ import com.theoplayer.android.api.cast.Cast
11
13
  import com.theoplayer.android.api.error.THEOplayerException
12
14
  import com.theoplayer.android.api.player.Player
13
15
  import com.theoplayer.broadcast.EventBroadcastAdapter
16
+ import com.theoplayer.integration.Integration
17
+ import com.theoplayer.integration.IntegrationRegistration
18
+ import com.theoplayer.integration.PlayerFacadeAdsBridge
14
19
  import com.theoplayer.presentation.PresentationManager
15
20
  import com.theoplayer.source.SourceAdapter
16
21
 
@@ -31,7 +36,9 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
31
36
  private set
32
37
  private var config: PlayerConfigAdapter? = null
33
38
 
39
+ /** Native source-specific Ads adapter and event sink. Use [player]'s Ads API for integration-owned state. */
34
40
  val adsApi: AdsApiWrapper
41
+ internal val adBridge: PlayerFacadeAdsBridge
35
42
 
36
43
  val castApi: Cast?
37
44
  get() = playerContext?.playerView?.cast
@@ -39,9 +46,31 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
39
46
  val player: Player?
40
47
  get() = playerContext?.player
41
48
 
49
+ /**
50
+ * Registers playback and advertising overrides on the player facade.
51
+ *
52
+ * Experimental API: subject to change or removal without notice.
53
+ *
54
+ * Enable `config.usePlayerFacade` before creating the player and wait until this view is initialized.
55
+ * Only one integration can be registered at a time; close its registration before replacing it.
56
+ *
57
+ * @param integration The hooks and optional Ads API to use until registration closes.
58
+ * @return The registration used to dispatch events, intercept native events, and unregister.
59
+ * @throws IllegalStateException if the view is uninitialized, the facade is disabled or closed,
60
+ * or another integration is already registered.
61
+ */
62
+ @MainThread
63
+ fun registerIntegration(integration: Integration): IntegrationRegistration {
64
+ val context = checkNotNull(playerContext) { "The player view has not been initialized." }
65
+ return checkNotNull(context.playerFacade) {
66
+ "Set config.usePlayerFacade to true at player creation before registering an integration."
67
+ }.registerIntegration(integration)
68
+ }
69
+
42
70
  init {
43
71
  reactContext.addLifecycleEventListener(this)
44
72
  adsApi = AdsApiWrapper()
73
+ adBridge = PlayerFacadeAdsBridge(adsApi)
45
74
  }
46
75
 
47
76
  fun initialize(config: PlayerConfigAdapter) {
@@ -63,11 +92,12 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
63
92
  config
64
93
  )
65
94
  playerContext?.apply {
66
- adsApi.initialize(player, imaIntegration, daiIntegration)
95
+ adBridge.initialize(player, imaIntegration, daiIntegration)
67
96
  val layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
68
97
  playerView.layoutParams = layoutParams
69
98
  (playerView.parent as? ViewGroup)?.removeView(playerView)
70
99
  addView(playerView, 0, layoutParams)
100
+ measureAndLayoutPlayerView()
71
101
  presentationManager = PresentationManager(
72
102
  this,
73
103
  reactContext,
@@ -82,6 +112,24 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
82
112
  if (!isInitialized && BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
83
113
  config?.let { initialize(it) }
84
114
  }
115
+ measureAndLayoutPlayerView()
116
+ }
117
+
118
+ override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) {
119
+ super.onSizeChanged(w, h, oldw, oldh)
120
+ measureAndLayoutPlayerView()
121
+ }
122
+
123
+ private fun measureAndLayoutPlayerView() {
124
+ val playerView = playerContext?.playerView ?: return
125
+ if (width == 0 || height == 0) return
126
+ if (playerView.width == width && playerView.height == height) return
127
+
128
+ playerView.measure(
129
+ View.MeasureSpec.makeMeasureSpec(width, View.MeasureSpec.EXACTLY),
130
+ View.MeasureSpec.makeMeasureSpec(height, View.MeasureSpec.EXACTLY)
131
+ )
132
+ playerView.layout(0, 0, width, height)
85
133
  }
86
134
 
87
135
  override fun setId(id: Int) {
@@ -128,7 +176,7 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
128
176
  Log.d(TAG, "releasePlayer")
129
177
  }
130
178
  reactContext.removeLifecycleEventListener(this)
131
- adsApi.destroy()
179
+ adBridge.destroy()
132
180
 
133
181
  if (isInitialized) {
134
182
  eventEmitter.removeListeners(player)
@@ -141,7 +189,7 @@ class ReactTHEOplayerView(private val reactContext: ThemedReactContext) :
141
189
  fun setSource(source: ReadableMap?) {
142
190
  try {
143
191
  val sourceDescription = SourceAdapter().parseSourceFromJS(source)
144
- adsApi.setSource(sourceDescription)
192
+ adBridge.setSource(sourceDescription)
145
193
  player?.source = sourceDescription
146
194
  } catch (exception: THEOplayerException) {
147
195
  Log.e(TAG, exception.message ?: "")
@@ -51,6 +51,8 @@ class AdEventAdapter(private val adsApi: AdsApiWrapper, eventEmitter: AdEventEmi
51
51
 
52
52
  init {
53
53
  adsApi.addAllEventsListener(eventListener)
54
+ adsApi.addEventListener(AdsEventTypes.AD_CLICKED, eventListener)
55
+ adsApi.addEventListener(AdsEventTypes.AD_TAPPED, eventListener)
54
56
  }
55
57
 
56
58
  companion object {
@@ -131,5 +133,7 @@ class AdEventAdapter(private val adsApi: AdsApiWrapper, eventEmitter: AdEventEmi
131
133
 
132
134
  fun destroy() {
133
135
  adsApi.removeAllEventsListener(eventListener)
136
+ adsApi.removeEventListener(AdsEventTypes.AD_CLICKED, eventListener)
137
+ adsApi.removeEventListener(AdsEventTypes.AD_TAPPED, eventListener)
134
138
  }
135
139
  }
@@ -45,7 +45,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
45
45
  fun schedule(tag: Int, ad: ReadableMap) {
46
46
  viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
47
47
  try {
48
- view?.adsApi?.schedule(sourceHelper.parseAdDescriptionFromJS(ad))
48
+ view?.adBridge?.schedule(sourceHelper.parseAdDescriptionFromJS(ad))
49
49
  } catch (exception: THEOplayerException) {
50
50
  Log.e(NAME, exception.message ?: ERR_SCHEDULE_AD)
51
51
  }
@@ -56,7 +56,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
56
56
  @ReactMethod
57
57
  fun currentAdBreak(tag: Int, promise: Promise) {
58
58
  viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
59
- promise.resolve(if (view == null) Arguments.createMap() else AdAdapter.fromAdBreak(view.adsApi.currentAdBreak))
59
+ promise.resolve(if (view == null) Arguments.createMap() else AdAdapter.fromAdBreak(view.adBridge.currentAdBreak))
60
60
  }
61
61
  }
62
62
 
@@ -64,7 +64,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
64
64
  @ReactMethod
65
65
  fun currentAds(tag: Int, promise: Promise) {
66
66
  viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
67
- promise.resolve(if (view == null) Arguments.createArray() else AdAdapter.fromAds(view.adsApi.currentAds))
67
+ promise.resolve(if (view == null) Arguments.createArray() else AdAdapter.fromAds(view.adBridge.currentAds))
68
68
  }
69
69
  }
70
70
 
@@ -72,7 +72,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
72
72
  @ReactMethod
73
73
  fun scheduledAdBreaks(tag: Int, promise: Promise) {
74
74
  viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
75
- promise.resolve(if (view == null) Arguments.createArray() else AdAdapter.fromAdBreaks(view.adsApi.scheduledAdBreaks))
75
+ promise.resolve(if (view == null) Arguments.createArray() else AdAdapter.fromAdBreaks(view.adBridge.scheduledAdBreaks))
76
76
  }
77
77
  }
78
78
 
@@ -80,7 +80,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
80
80
  @ReactMethod
81
81
  fun playing(tag: Int, promise: Promise) {
82
82
  viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
83
- promise.resolve(view?.adsApi?.isPlaying ?: false)
83
+ promise.resolve(view?.adBridge?.isPlaying ?: false)
84
84
  }
85
85
  }
86
86
 
@@ -88,7 +88,7 @@ class AdsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(c
88
88
  // NOTE: This will have no effect when the current linear ad is not (yet) skippable.
89
89
  @ReactMethod
90
90
  fun skip(tag: Int) {
91
- viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? -> view?.adsApi?.skip() }
91
+ viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? -> view?.adBridge?.skip() }
92
92
  }
93
93
 
94
94
  @ReactMethod
@@ -0,0 +1,72 @@
1
+ package com.theoplayer.integration
2
+
3
+ import androidx.annotation.MainThread
4
+ import com.theoplayer.android.api.ads.Ads
5
+ import com.theoplayer.android.api.event.ads.AdEvent
6
+
7
+ /**
8
+ * Optional playback and advertising overrides for [PlayerFacade].
9
+ *
10
+ * Experimental API: subject to change or removal without notice.
11
+ *
12
+ * Enable `usePlayerFacade` at player creation and register through [com.theoplayer.ReactTHEOplayerView.registerIntegration].
13
+ * Unimplemented hooks delegate to the content player. The integration owns playback synchronization,
14
+ * advertising lifecycle, and events describing its public state. All hooks run on the main thread.
15
+ *
16
+ * Custom advertising must not overlap ongoing native IMA/DAI playback. Replacing or filtering native
17
+ * advertising events can suspend the React Native bridge's native DAI bookkeeping; fresh native state
18
+ * after hidden native playback is not guaranteed. Finish or reset native advertising before taking over.
19
+ */
20
+ @MainThread
21
+ interface Integration {
22
+ /** Returns a finite, non-negative time in seconds, or null to delegate. Invalid times also delegate. */
23
+ fun getCurrentTime(): Double? = null
24
+
25
+ /** Seeks to [currentTime] in seconds. Returns true if handled, or false to seek the content player. */
26
+ fun setCurrentTime(currentTime: Double): Boolean = false
27
+
28
+ /** Starts or resumes playback. Returns true if handled, or false to play the content player. */
29
+ fun play(): Boolean = false
30
+
31
+ /** Pauses playback. Returns true if handled, or false to pause the content player. */
32
+ fun pause(): Boolean = false
33
+
34
+ /** Returns the paused state, or null to use the content player's state. */
35
+ fun isPaused(): Boolean? = null
36
+
37
+ /** Returns the seeking state, or null to use the content player's state. */
38
+ fun isSeeking(): Boolean? = null
39
+
40
+ /** Returns the duration in seconds, or null to delegate. Infinity and NaN are preserved. */
41
+ fun getDuration(): Double? = null
42
+
43
+ /** Returns the muted state, or null to use the content player's state. */
44
+ fun getMuted(): Boolean? = null
45
+
46
+ /** Sets [muted]. Returns true if handled, or false to update the content player. */
47
+ fun setMuted(muted: Boolean): Boolean = false
48
+
49
+ /** Returns the volume between 0 and 1, or null to use the content player's volume. */
50
+ fun getVolume(): Double? = null
51
+
52
+ /** Sets [volume] between 0 and 1. Returns true if handled, or false to update the content player. */
53
+ fun setVolume(volume: Double): Boolean = false
54
+
55
+ /**
56
+ * The Ads API and event source behind the stable facade Ads object, or null to retain native Ads.
57
+ * Keep this object stable until registration closes. Existing listeners migrate on registration and close.
58
+ */
59
+ val ads: Ads? get() = null
60
+
61
+ /**
62
+ * Returns advertising state without replacing the native Ads API, or null to delegate.
63
+ * Ignored when [ads] is supplied. State is never derived from dispatched events.
64
+ */
65
+ fun getAdState(): PlayerFacadeAdState? = null
66
+
67
+ /**
68
+ * Returns true to consume a native Ads [event] for all facade listeners, or false to forward it.
69
+ * Called once per subscribed event. Integration-generated events bypass this hook.
70
+ */
71
+ fun shouldConsumeAdEvent(event: AdEvent<*>): Boolean = false
72
+ }
@@ -0,0 +1,68 @@
1
+ package com.theoplayer.integration
2
+
3
+ import androidx.annotation.MainThread
4
+ import com.theoplayer.android.api.event.EventType
5
+ import com.theoplayer.android.api.event.ads.AdEvent
6
+ import com.theoplayer.android.api.event.player.PlayerEvent
7
+ import java.io.Closeable
8
+
9
+ /**
10
+ * Controls event delivery and the lifetime of an Android facade integration.
11
+ *
12
+ * Experimental API: subject to change or removal without notice.
13
+ *
14
+ * Only the active registration can dispatch events or install interceptors. All operations run on the main thread.
15
+ * Closing a registration restores native delegation without destroying either playback engine.
16
+ */
17
+ @MainThread
18
+ class IntegrationRegistration internal constructor(
19
+ private val facade: PlayerFacade,
20
+ integration: Integration,
21
+ ) : Closeable {
22
+ internal var integration: Integration? = integration
23
+ private set
24
+
25
+ /**
26
+ * Delivers [event] only to facade player listeners, bypassing native-event interceptors.
27
+ * Does not emit on the raw content player. Calls after this registration closes have no effect.
28
+ */
29
+ fun dispatchEvent(event: PlayerEvent<*>) = facade.dispatchPlayerEvent(this, event)
30
+
31
+ /**
32
+ * Delivers [event] only to facade Ads listeners without deriving advertising state from it.
33
+ * Bypasses native-ad filtering. Calls after this registration closes have no effect.
34
+ */
35
+ fun dispatchEvent(event: AdEvent<*>) = facade.dispatchAdEvent(this, event)
36
+
37
+ /** Compatibility entry point for player events, equivalent to [dispatchEvent]. */
38
+ fun dispatchPlayerEvent(event: PlayerEvent<*>) = dispatchEvent(event)
39
+
40
+ /**
41
+ * Intercepts native events of [type], even without facade listeners, before catch-all interceptors.
42
+ * [interceptor] runs once per event; return true to consume it or false to continue delivery.
43
+ *
44
+ * The returned [Closeable] removes the interceptor. It must be closed explicitly: interception survives
45
+ * unregistering so queued native events can drain. Closed registrations return a no-op disposer.
46
+ */
47
+ fun <T : PlayerEvent<*>> interceptPlayerEvent(type: EventType<T>, interceptor: (T) -> Boolean): Closeable =
48
+ if (facade.isCurrent(this)) facade.playerEvents.intercept(type, interceptor) else Closeable {}
49
+
50
+ /**
51
+ * Intercepts all subscribed native player events after type-specific interceptors, including future subscriptions.
52
+ * Return true from [interceptor] to consume the event. Does not subscribe to otherwise unobserved event types.
53
+ *
54
+ * The returned [Closeable] has the same explicit lifetime as [interceptPlayerEvent].
55
+ * Integration-dispatched events bypass interception. Consuming native destruction never prevents facade cleanup.
56
+ */
57
+ fun interceptPlayerEvents(interceptor: (PlayerEvent<*>) -> Boolean): Closeable =
58
+ if (facade.isCurrent(this)) facade.playerEvents.interceptAll(interceptor) else Closeable {}
59
+
60
+ /**
61
+ * Restores native playback and Ads delegation without destroying the content player. Idempotent.
62
+ * Existing player-event interceptors remain until their disposers or the facade are closed.
63
+ */
64
+ override fun close() {
65
+ integration = null
66
+ facade.unregister(this)
67
+ }
68
+ }