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
@@ -0,0 +1,187 @@
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.ads.dai.GoogleDaiIntegration
6
+ import com.theoplayer.android.api.ads.dai.dai as sdkDai
7
+ import com.theoplayer.android.api.ads.ima.GoogleImaIntegration
8
+ import com.theoplayer.android.api.ads.ima.ima as sdkIma
9
+ import com.theoplayer.android.api.ads.theoads.TheoAdsIntegration
10
+ import com.theoplayer.android.api.ads.theoads.theoAds as sdkTheoAds
11
+ import com.theoplayer.android.api.event.EventListener
12
+ import com.theoplayer.android.api.event.EventType
13
+ import com.theoplayer.android.api.event.ads.AdEvent
14
+ import com.theoplayer.android.api.event.player.PlayerEvent
15
+ import com.theoplayer.android.api.event.player.PlayerEventTypes
16
+ import com.theoplayer.android.api.player.Player
17
+ import java.io.Closeable
18
+
19
+ /**
20
+ * Stable player surface with integration-owned playback, advertising state, and event interception.
21
+ *
22
+ * Experimental API: subject to change or removal without notice.
23
+ *
24
+ * Enable `usePlayerFacade` at player creation to expose this surface through [com.theoplayer.ReactTHEOplayerView.player].
25
+ * Unhandled operations delegate to [contentPlayer]; the facade never owns playback or advertising lifecycle.
26
+ *
27
+ * @property contentPlayer Raw playback engine, unaffected by integration overrides or event interception.
28
+ */
29
+ @MainThread
30
+ class PlayerFacade internal constructor(val contentPlayer: Player) : Player by contentPlayer, Closeable {
31
+ companion object {
32
+ internal fun create(contentPlayer: Player, enabled: Boolean): Player =
33
+ if (enabled) PlayerFacade(contentPlayer) else contentPlayer
34
+ }
35
+
36
+ private val nativeAds = contentPlayer.ads
37
+ private var registration: IntegrationRegistration? = null
38
+ private var closed = false
39
+ private val integration: Integration? get() = registration?.integration
40
+ internal val playerEvents = PlayerFacadeEvents(
41
+ source = { contentPlayer },
42
+ after = { event -> if (event.type == PlayerEventTypes.DESTROY) close() },
43
+ )
44
+ internal val adEvents = PlayerFacadeEvents(
45
+ source = { integration?.ads ?: nativeAds },
46
+ isIntegrationSource = { integration?.ads?.let { it !== nativeAds } == true },
47
+ consume = { event ->
48
+ val current = integration
49
+ (current?.ads == null || current.ads === nativeAds) && current?.shouldConsumeAdEvent(event) == true
50
+ },
51
+ )
52
+ private val adsFacade = PlayerFacadeAds(nativeAds, { integration }, adEvents)
53
+
54
+ init {
55
+ playerEvents.retain(PlayerEventTypes.DESTROY)
56
+ }
57
+
58
+ /** Native THEOads integration, resolved on the raw content player rather than this facade. */
59
+ val theoAds: TheoAdsIntegration get() = contentPlayer.sdkTheoAds
60
+
61
+ /** Returns the stable Ads facade. Existing references survive integration registration and removal. */
62
+ override fun getAds(): PlayerFacadeAds = adsFacade
63
+
64
+ /** Returns integration time in seconds when finite and non-negative, or the content player's time. */
65
+ override fun getCurrentTime(): Double = integration?.getCurrentTime()?.takeIf { it.isFinite() && it >= 0 } ?: contentPlayer.currentTime
66
+
67
+ /** Seeks to [currentTime] in seconds, delegating to the content player unless the integration handles it. */
68
+ override fun setCurrentTime(currentTime: Double) {
69
+ if (integration?.setCurrentTime(currentTime) != true) contentPlayer.currentTime = currentTime
70
+ }
71
+
72
+ /** Starts or resumes playback, delegating to the content player unless the integration handles it. */
73
+ override fun play() {
74
+ if (integration?.play() != true) contentPlayer.play()
75
+ }
76
+
77
+ /** Pauses playback, delegating to the content player unless the integration handles it. */
78
+ override fun pause() {
79
+ if (integration?.pause() != true) contentPlayer.pause()
80
+ }
81
+
82
+ /** Returns the integration's paused state, or the native state when the hook returns null. */
83
+ override fun isPaused(): Boolean = integration?.isPaused() ?: contentPlayer.isPaused
84
+
85
+ /** Returns the integration's seeking state, or the native state when the hook returns null. */
86
+ override fun isSeeking(): Boolean = integration?.isSeeking() ?: contentPlayer.isSeeking
87
+
88
+ /** Returns duration in seconds, delegating on null. Infinity and NaN remain unchanged. */
89
+ override fun getDuration(): Double = integration?.getDuration() ?: contentPlayer.duration
90
+
91
+ /** Returns the integration's muted state, or the native state when the hook returns null. */
92
+ override fun isMuted(): Boolean = integration?.getMuted() ?: contentPlayer.isMuted
93
+
94
+ /** Sets [muted], delegating to the content player unless the integration handles it. */
95
+ override fun setMuted(muted: Boolean) {
96
+ if (integration?.setMuted(muted) != true) contentPlayer.isMuted = muted
97
+ }
98
+
99
+ /** Returns the integration's volume between 0 and 1, or the native volume when the hook returns null. */
100
+ override fun getVolume(): Double = integration?.getVolume() ?: contentPlayer.volume
101
+
102
+ /** Sets [volume] between 0 and 1, delegating unless the integration handles it. */
103
+ override fun setVolume(volume: Double) {
104
+ if (integration?.setVolume(volume) != true) contentPlayer.volume = volume
105
+ }
106
+
107
+ /** Adds [listener] for [type] after integration interception. Duplicate listeners are ignored. */
108
+ override fun <T : PlayerEvent<*>> addEventListener(type: EventType<T>, listener: EventListener<in T>) = playerEvents.addEventListener(type, listener)
109
+
110
+ /** Removes [listener] for [type]. Removing an absent listener has no effect. */
111
+ override fun <T : PlayerEvent<*>> removeEventListener(type: EventType<T>, listener: EventListener<in T>) = playerEvents.removeEventListener(type, listener)
112
+
113
+ /**
114
+ * Registers [integration] and migrates existing Ads listeners to its optional Ads API.
115
+ *
116
+ * @return The registration used to dispatch events, intercept native events, and unregister.
117
+ * @throws IllegalStateException if the facade is closed or another integration is registered.
118
+ */
119
+ fun registerIntegration(integration: Integration): IntegrationRegistration {
120
+ check(!closed) { "The player facade has been closed." }
121
+ check(registration == null) { "Unregister the previous integration first." }
122
+ val current = IntegrationRegistration(this, integration)
123
+ registration = current
124
+ try {
125
+ adEvents.rebind()
126
+ } catch (error: Exception) {
127
+ current.close()
128
+ throw error
129
+ }
130
+ return current
131
+ }
132
+
133
+ internal val integrationAds: Ads? get() = integration?.ads
134
+
135
+ internal fun adStateOverride(): PlayerFacadeAdState? {
136
+ val current = integration
137
+ return current?.ads?.let { PlayerFacadeAdState(it.isPlaying, it.currentAds, it.currentAdBreak) } ?: current?.getAdState()
138
+ }
139
+
140
+ internal fun destroyContent(destroy: () -> Unit) {
141
+ try {
142
+ destroy()
143
+ } finally {
144
+ close()
145
+ }
146
+ }
147
+
148
+ internal fun isCurrent(current: IntegrationRegistration): Boolean = !closed && registration === current
149
+
150
+ internal fun dispatchPlayerEvent(current: IntegrationRegistration, event: PlayerEvent<*>) {
151
+ if (isCurrent(current)) playerEvents.dispatch(event) { isCurrent(current) }
152
+ }
153
+
154
+ internal fun dispatchAdEvent(current: IntegrationRegistration, event: AdEvent<*>) {
155
+ if (isCurrent(current)) adEvents.dispatch(event, true) { isCurrent(current) }
156
+ }
157
+
158
+ internal fun unregister(current: IntegrationRegistration) {
159
+ if (registration !== current) return
160
+ registration = null
161
+ if (!closed) adEvents.rebind()
162
+ }
163
+
164
+ /**
165
+ * Releases facade listeners, interceptors, and the active registration. Idempotent.
166
+ * Does not destroy the content player. Native destruction also closes the facade, even when intercepted.
167
+ */
168
+ override fun close() {
169
+ if (closed) return
170
+ closed = true
171
+ registration?.close()
172
+ playerEvents.close()
173
+ adEvents.close()
174
+ }
175
+ }
176
+
177
+ /** Resolves THEOads on the native content player when this player is a facade. */
178
+ val Player.theoAds: TheoAdsIntegration
179
+ get() = if (this is PlayerFacade) this.theoAds else this.sdkTheoAds
180
+
181
+ /** Resolves IMA on the native Ads API when this object is a facade. */
182
+ val Ads.ima: GoogleImaIntegration
183
+ get() = if (this is PlayerFacadeAds) this.ima else this.sdkIma
184
+
185
+ /** Resolves DAI on the native Ads API when this object is a facade. */
186
+ val Ads.dai: GoogleDaiIntegration
187
+ get() = if (this is PlayerFacadeAds) this.dai else this.sdkDai
@@ -0,0 +1,19 @@
1
+ package com.theoplayer.integration
2
+
3
+ import com.theoplayer.android.api.ads.Ad
4
+ import com.theoplayer.android.api.ads.AdBreak
5
+
6
+ /**
7
+ * Advertising state supplied by [Integration.getAdState], independent of dispatched events.
8
+ *
9
+ * Experimental API: subject to change or removal without notice.
10
+ *
11
+ * @property playing Whether a linear advertisement is playing.
12
+ * @property currentAds The currently active advertisements.
13
+ * @property currentAdBreak The active ad break, or null. Null does not fall back to the native ad break.
14
+ */
15
+ data class PlayerFacadeAdState(
16
+ val playing: Boolean,
17
+ val currentAds: List<Ad>,
18
+ val currentAdBreak: AdBreak?,
19
+ )
@@ -0,0 +1,73 @@
1
+ package com.theoplayer.integration
2
+
3
+ import androidx.annotation.MainThread
4
+ import com.theoplayer.android.api.ads.Ad
5
+ import com.theoplayer.android.api.ads.AdBreak
6
+ import com.theoplayer.android.api.ads.Ads
7
+ import com.theoplayer.android.api.ads.Omid
8
+ import com.theoplayer.android.api.ads.ServerSideAdIntegrationFactory
9
+ import com.theoplayer.android.api.ads.dai.GoogleDaiIntegration
10
+ import com.theoplayer.android.api.ads.dai.dai as sdkDai
11
+ import com.theoplayer.android.api.ads.ima.GoogleImaIntegration
12
+ import com.theoplayer.android.api.ads.ima.ima as sdkIma
13
+ import com.theoplayer.android.api.event.EventListener
14
+ import com.theoplayer.android.api.event.EventType
15
+ import com.theoplayer.android.api.event.ads.AdEvent
16
+ import com.theoplayer.android.api.source.addescription.AdDescription
17
+
18
+ /**
19
+ * Stable advertising API whose state, controls, and event source follow the current [Integration].
20
+ * Advertising lifecycle is owned by the integration, never inferred from dispatched events.
21
+ *
22
+ * Experimental API: subject to change or removal without notice.
23
+ */
24
+ @MainThread
25
+ class PlayerFacadeAds internal constructor(
26
+ private val nativeAds: Ads,
27
+ private val integration: () -> Integration?,
28
+ private val events: PlayerFacadeEvents<AdEvent<*>>,
29
+ ) : Ads {
30
+ private val backing: Ads get() = integration()?.ads ?: nativeAds
31
+
32
+ /** Native IMA integration, resolved on the raw Ads API rather than this facade. */
33
+ val ima: GoogleImaIntegration get() = nativeAds.sdkIma
34
+
35
+ /** Native DAI integration, resolved on the raw Ads API rather than this facade. */
36
+ val dai: GoogleDaiIntegration get() = nativeAds.sdkDai
37
+
38
+ /** Returns whether the integration or native Ads API is playing a linear advertisement. */
39
+ override fun isPlaying(): Boolean = integration()?.let { it.ads?.isPlaying ?: it.getAdState()?.playing } ?: nativeAds.isPlaying
40
+
41
+ /** Returns the current advertisements from the integration or native Ads API. */
42
+ override fun getCurrentAds(): List<Ad> = integration()?.let { it.ads?.currentAds ?: it.getAdState()?.currentAds } ?: nativeAds.currentAds
43
+
44
+ /** Returns the active ad break. An integration's explicit null does not fall back to native Ads. */
45
+ override fun getCurrentAdBreak(): AdBreak? {
46
+ val current = integration()
47
+ current?.ads?.let { return it.currentAdBreak }
48
+ current?.getAdState()?.let { return it.currentAdBreak }
49
+ return nativeAds.currentAdBreak
50
+ }
51
+
52
+ /** Returns advertisements scheduled by the currently delegated Ads API. */
53
+ override fun getScheduledAds(): List<Ad> = backing.scheduledAds
54
+
55
+ /** Schedules [adDescription] through the currently delegated Ads API. */
56
+ override fun schedule(adDescription: AdDescription) = backing.schedule(adDescription)
57
+
58
+ /** Skips the current advertisement through the currently delegated Ads API. */
59
+ override fun skip() = backing.skip()
60
+
61
+ /** Returns the Open Measurement API of the currently delegated Ads API. */
62
+ override fun getOmid(): Omid = backing.omid
63
+
64
+ /** Registers [factory] for [integrationId] on the currently delegated Ads API. */
65
+ override fun registerServerSideIntegration(integrationId: String, factory: ServerSideAdIntegrationFactory) =
66
+ backing.registerServerSideIntegration(integrationId, factory)
67
+
68
+ /** Adds [listener] for [type], preserving the subscription across integration changes. Duplicate listeners are ignored. */
69
+ override fun <T : AdEvent<*>> addEventListener(type: EventType<T>, listener: EventListener<in T>) = events.addEventListener(type, listener)
70
+
71
+ /** Removes [listener] for [type]. Removing an absent listener has no effect. */
72
+ override fun <T : AdEvent<*>> removeEventListener(type: EventType<T>, listener: EventListener<in T>) = events.removeEventListener(type, listener)
73
+ }
@@ -0,0 +1,112 @@
1
+ package com.theoplayer.integration
2
+
3
+ import com.theoplayer.android.api.ads.Ad
4
+ import com.theoplayer.android.api.ads.AdBreak
5
+ import com.theoplayer.android.api.ads.Ads
6
+ import com.theoplayer.android.api.ads.dai.GoogleDaiIntegration
7
+ import com.theoplayer.android.api.ads.ima.GoogleImaAdErrorEvent
8
+ import com.theoplayer.android.api.ads.ima.GoogleImaAdEvent
9
+ import com.theoplayer.android.api.ads.ima.GoogleImaAdEventType
10
+ import com.theoplayer.android.api.ads.ima.GoogleImaIntegration
11
+ import com.theoplayer.android.api.ads.wrapper.AdsApiWrapper
12
+ import com.theoplayer.android.api.event.EventListener
13
+ import com.theoplayer.android.api.event.EventType
14
+ import com.theoplayer.android.api.event.ads.AdBreakEvent
15
+ import com.theoplayer.android.api.event.ads.AdEvent
16
+ import com.theoplayer.android.api.event.ads.AdsEventTypes
17
+ import com.theoplayer.android.api.event.ads.SingleAdEvent
18
+ import com.theoplayer.android.api.player.Player
19
+ import com.theoplayer.android.api.source.SourceDescription
20
+ import com.theoplayer.android.api.source.addescription.AdDescription
21
+
22
+ internal class PlayerFacadeAdsBridge(private val nativeApi: AdsApiWrapper) {
23
+ private var facade: PlayerFacade? = null
24
+ private val relay = EventListener<AdEvent<*>> { event ->
25
+ when (event) {
26
+ is GoogleImaAdEvent -> nativeApi.dispatchAdEvent(event.type, event.ad, event.adData, (event as? GoogleImaAdErrorEvent)?.adError)
27
+ is SingleAdEvent<*> -> nativeApi.dispatchAdEvent(event.type, event.ad, null, null)
28
+ is AdBreakEvent<*> -> nativeApi.dispatchAdBreakEvent(event.type, event.adBreak, null, null)
29
+ }
30
+ }
31
+
32
+ val isPlaying: Boolean get() = facade?.adStateOverride()?.playing ?: nativeApi.isPlaying
33
+ val currentAds: List<Ad> get() = facade?.adStateOverride()?.currentAds ?: nativeApi.currentAds
34
+ val currentAdBreak: AdBreak?
35
+ get() {
36
+ val state = facade?.adStateOverride()
37
+ return if (state != null) state.currentAdBreak else nativeApi.currentAdBreak
38
+ }
39
+ val scheduledAdBreaks: List<AdBreak>
40
+ get() = facade?.integrationAds?.scheduledAds?.mapNotNull { it.adBreak }?.distinct() ?: nativeApi.scheduledAdBreaks
41
+
42
+ fun initialize(player: Player, ima: GoogleImaIntegration?, dai: GoogleDaiIntegration?) {
43
+ destroy()
44
+ val current = player as? PlayerFacade
45
+ facade = current
46
+ val nativePlayer = if (current == null) player else {
47
+ val nativeAds = object : Ads by current.contentPlayer.ads {
48
+ override fun <T : AdEvent<*>> addEventListener(type: EventType<T>, listener: EventListener<in T>) =
49
+ current.adEvents.addEventListener(type, listener, false)
50
+
51
+ override fun <T : AdEvent<*>> removeEventListener(type: EventType<T>, listener: EventListener<in T>) =
52
+ current.adEvents.removeEventListener(type, listener)
53
+ }
54
+ object : Player by current.contentPlayer {
55
+ override fun getAds(): Ads = nativeAds
56
+ }
57
+ }
58
+ nativeApi.initialize(nativePlayer, ima, dai)
59
+ if (current != null) {
60
+ try {
61
+ for (type in eventTypes) current.adEvents.addEventListener(type, relay, true)
62
+ } catch (error: Exception) {
63
+ destroy()
64
+ throw error
65
+ }
66
+ }
67
+ }
68
+
69
+ fun setSource(source: SourceDescription?) = nativeApi.setSource(source)
70
+
71
+ fun schedule(ad: AdDescription?) {
72
+ if (ad == null) return
73
+ val ads = facade?.integrationAds
74
+ if (ads != null) ads.schedule(ad) else nativeApi.schedule(ad)
75
+ }
76
+
77
+ fun skip() {
78
+ val ads = facade?.integrationAds
79
+ if (ads != null) ads.skip() else nativeApi.skip()
80
+ }
81
+
82
+ fun destroy() {
83
+ facade?.let { current ->
84
+ for (type in eventTypes) current.adEvents.removeEventListener(type, relay)
85
+ }
86
+ facade = null
87
+ nativeApi.destroy()
88
+ }
89
+
90
+ companion object {
91
+ @Suppress("UNCHECKED_CAST")
92
+ private val eventTypes = (listOf(
93
+ AdsEventTypes.AD_BEGIN,
94
+ AdsEventTypes.AD_END,
95
+ AdsEventTypes.AD_SKIP,
96
+ AdsEventTypes.AD_ERROR,
97
+ AdsEventTypes.AD_BREAK_BEGIN,
98
+ AdsEventTypes.AD_BREAK_END,
99
+ AdsEventTypes.AD_LOADED,
100
+ AdsEventTypes.AD_IMPRESSION,
101
+ AdsEventTypes.AD_FIRST_QUARTILE,
102
+ AdsEventTypes.AD_THIRD_QUARTILE,
103
+ AdsEventTypes.AD_MIDPOINT,
104
+ AdsEventTypes.ADD_AD,
105
+ AdsEventTypes.ADD_AD_BREAK,
106
+ AdsEventTypes.AD_BREAK_CHANGE,
107
+ AdsEventTypes.REMOVE_AD_BREAK,
108
+ AdsEventTypes.AD_CLICKED,
109
+ AdsEventTypes.AD_TAPPED,
110
+ ) + GoogleImaAdEventType.values()).map { it as EventType<AdEvent<*>> }
111
+ }
112
+ }
@@ -0,0 +1,11 @@
1
+ package com.theoplayer.integration
2
+
3
+ import com.theoplayer.android.api.event.Event
4
+ import com.theoplayer.android.api.event.EventListener
5
+
6
+ @Suppress("FINITE_BOUNDS_VIOLATION_IN_JAVA")
7
+ internal class PlayerFacadeEventSubscription<E : Event<*>> {
8
+ val listeners = linkedMapOf<EventListener<*>, (E, Boolean) -> Unit>()
9
+ val interceptors = linkedSetOf<(E) -> Boolean>()
10
+ var remove: () -> Unit = {}
11
+ }
@@ -0,0 +1,139 @@
1
+ package com.theoplayer.integration
2
+
3
+ import com.theoplayer.android.api.event.Event
4
+ import com.theoplayer.android.api.event.EventDispatcher
5
+ import com.theoplayer.android.api.event.EventListener
6
+ import com.theoplayer.android.api.event.EventType
7
+ import java.io.Closeable
8
+
9
+ @Suppress("FINITE_BOUNDS_VIOLATION_IN_JAVA")
10
+ internal class PlayerFacadeEvents<E : Event<*>>(
11
+ private val source: () -> EventDispatcher<E>,
12
+ private val consume: (E) -> Boolean = { false },
13
+ private val after: (E) -> Unit = {},
14
+ private val isIntegrationSource: () -> Boolean = { false },
15
+ ) : EventDispatcher<E>, Closeable {
16
+ private val subscriptions = linkedMapOf<EventType<*>, PlayerFacadeEventSubscription<E>>()
17
+ private val interceptors = linkedSetOf<(E) -> Boolean>()
18
+ private val retainedTypes = mutableSetOf<EventType<*>>()
19
+ private var closed = false
20
+
21
+ override fun <T : E> addEventListener(type: EventType<T>, listener: EventListener<in T>) = addEventListener(type, listener, null)
22
+
23
+ fun <T : E> addEventListener(type: EventType<T>, listener: EventListener<in T>, integrationEvents: Boolean?) {
24
+ check(!closed) { "The player facade has been closed." }
25
+ val subscription = subscription(type)
26
+ if (subscription.listeners.containsKey(listener)) return
27
+ @Suppress("UNCHECKED_CAST")
28
+ subscription.listeners[listener] = { event, integrationEvent ->
29
+ if (integrationEvents == null || integrationEvents == integrationEvent) listener.handleEvent(event as T)
30
+ }
31
+ }
32
+
33
+ override fun <T : E> removeEventListener(type: EventType<T>, listener: EventListener<in T>) {
34
+ val subscription = subscriptions[type] ?: return
35
+ subscription.listeners.remove(listener)
36
+ release(type, subscription)
37
+ }
38
+
39
+ fun <T : E> retain(type: EventType<T>) {
40
+ retainedTypes.add(type)
41
+ subscription(type)
42
+ }
43
+
44
+ fun <T : E> intercept(type: EventType<T>, interceptor: (T) -> Boolean): Closeable {
45
+ val subscription = subscription(type)
46
+ @Suppress("UNCHECKED_CAST")
47
+ val callback = interceptor as (E) -> Boolean
48
+ subscription.interceptors.add(callback)
49
+ return Closeable {
50
+ subscription.interceptors.remove(callback)
51
+ release(type, subscription)
52
+ }
53
+ }
54
+
55
+ fun interceptAll(interceptor: (E) -> Boolean): Closeable {
56
+ interceptors.add(interceptor)
57
+ return Closeable { interceptors.remove(interceptor) }
58
+ }
59
+
60
+ fun dispatch(event: E, integrationEvent: Boolean = false, isCurrent: () -> Boolean) {
61
+ val subscription = subscriptions[event.type] ?: return
62
+ for ((listener, emit) in subscription.listeners.toMap()) {
63
+ if (!closed && isCurrent() && subscription.listeners.containsKey(listener)) emit(event, integrationEvent)
64
+ }
65
+ }
66
+
67
+ fun rebind() {
68
+ for ((type, subscription) in subscriptions) {
69
+ subscription.remove()
70
+ subscription.remove = bind(type, subscription)
71
+ }
72
+ }
73
+
74
+ private fun <T : E> subscription(type: EventType<T>): PlayerFacadeEventSubscription<E> {
75
+ subscriptions[type]?.let { return it }
76
+ val subscription = PlayerFacadeEventSubscription<E>()
77
+ subscriptions[type] = subscription
78
+ try {
79
+ subscription.remove = bind(type, subscription)
80
+ } catch (error: Exception) {
81
+ subscriptions.remove(type)
82
+ throw error
83
+ }
84
+ return subscription
85
+ }
86
+
87
+ @Suppress("UNCHECKED_CAST")
88
+ private fun bind(type: EventType<*>, subscription: PlayerFacadeEventSubscription<E>): () -> Unit {
89
+ val backing = source()
90
+ val integrationEvent = isIntegrationSource()
91
+ val eventType = type as EventType<E>
92
+ var attached = true
93
+ val isCurrent = { attached && subscriptions[type] === subscription && source() === backing }
94
+ val forward = EventListener<E> { event ->
95
+ if (closed || !isCurrent()) return@EventListener
96
+ try {
97
+ for (interceptor in subscription.interceptors.toList()) {
98
+ if (interceptor in subscription.interceptors && interceptor(event)) return@EventListener
99
+ }
100
+ for (interceptor in interceptors.toList()) {
101
+ if (interceptor in interceptors && interceptor(event)) return@EventListener
102
+ }
103
+ if (!consume(event)) dispatch(event, integrationEvent, isCurrent)
104
+ } finally {
105
+ after(event)
106
+ }
107
+ }
108
+ try {
109
+ backing.addEventListener(eventType, forward)
110
+ } catch (error: Exception) {
111
+ attached = false
112
+ backing.removeEventListener(eventType, forward)
113
+ throw error
114
+ }
115
+ return {
116
+ attached = false
117
+ backing.removeEventListener(eventType, forward)
118
+ }
119
+ }
120
+
121
+ private fun release(type: EventType<*>, subscription: PlayerFacadeEventSubscription<E>) {
122
+ if (type in retainedTypes || subscription.listeners.isNotEmpty() || subscription.interceptors.isNotEmpty() || subscriptions[type] !== subscription) return
123
+ subscription.remove()
124
+ subscriptions.remove(type)
125
+ }
126
+
127
+ override fun close() {
128
+ if (closed) return
129
+ closed = true
130
+ interceptors.clear()
131
+ val detached = subscriptions.values.toList()
132
+ subscriptions.clear()
133
+ for (subscription in detached) {
134
+ subscription.listeners.clear()
135
+ subscription.interceptors.clear()
136
+ subscription.remove()
137
+ }
138
+ }
139
+ }
@@ -0,0 +1,37 @@
1
+ package com.theoplayer.metrics
2
+
3
+ import com.facebook.react.bridge.*
4
+ import com.facebook.react.module.annotations.ReactModule
5
+ import com.facebook.react.module.model.ReactModuleInfo
6
+ import com.theoplayer.ReactTHEOplayerView
7
+ import com.theoplayer.util.ViewResolver
8
+
9
+ @Suppress("unused")
10
+ @ReactModule(name = MetricsModule.NAME)
11
+ class MetricsModule(context: ReactApplicationContext) : ReactContextBaseJavaModule(context) {
12
+ companion object {
13
+ const val NAME = "THEORCTMetricsModule"
14
+ val INFO = ReactModuleInfo(
15
+ name = NAME,
16
+ className = NAME,
17
+ canOverrideExistingModule = false,
18
+ needsEagerInit = false,
19
+ isCxxModule = false,
20
+ isTurboModule = false,
21
+ )
22
+ }
23
+
24
+ private val viewResolver: ViewResolver = ViewResolver(context)
25
+
26
+ override fun getName(): String {
27
+ return NAME
28
+ }
29
+
30
+ // The bandwidth, in bits per second, that the player estimates is currently available.
31
+ @ReactMethod
32
+ fun currentBandwidthEstimate(tag: Int, promise: Promise) {
33
+ viewResolver.resolveViewByTag(tag) { view: ReactTHEOplayerView? ->
34
+ promise.resolve(view?.player?.metrics?.currentBandwidthEstimate ?: 0.0)
35
+ }
36
+ }
37
+ }
@@ -4,7 +4,7 @@ import com.facebook.react.bridge.*
4
4
  import com.facebook.react.module.annotations.ReactModule
5
5
  import com.facebook.react.module.model.ReactModuleInfo
6
6
  import com.theoplayer.*
7
- import com.theoplayer.android.api.ads.theoads.theoAds
7
+ import com.theoplayer.integration.theoAds
8
8
  import com.theoplayer.theoads.THEOadsAdapter.fromInterstitialList
9
9
  import com.theoplayer.util.ViewResolver
10
10