react-native-theoplayer 11.5.0 → 11.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (282) hide show
  1. package/CHANGELOG.md +32 -1
  2. package/README.md +70 -0
  3. package/android/build.gradle +1 -0
  4. package/android/src/main/java/com/theoplayer/PlayerConfigAdapter.kt +6 -0
  5. package/android/src/main/java/com/theoplayer/PlayerEventEmitter.kt +11 -2
  6. package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +95 -93
  7. package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +6 -0
  8. package/android/src/main/java/com/theoplayer/ReactTHEOplayerView.kt +51 -3
  9. package/android/src/main/java/com/theoplayer/ads/AdEventAdapter.kt +4 -0
  10. package/android/src/main/java/com/theoplayer/ads/AdsModule.kt +6 -6
  11. package/android/src/main/java/com/theoplayer/integration/Integration.kt +72 -0
  12. package/android/src/main/java/com/theoplayer/integration/IntegrationRegistration.kt +68 -0
  13. package/android/src/main/java/com/theoplayer/integration/PlayerFacade.kt +187 -0
  14. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdState.kt +19 -0
  15. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAds.kt +73 -0
  16. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdsBridge.kt +112 -0
  17. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEventSubscription.kt +11 -0
  18. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEvents.kt +139 -0
  19. package/android/src/main/java/com/theoplayer/media/MediaControlModule.kt +102 -0
  20. package/android/src/main/java/com/theoplayer/media/MediaControlProxy.kt +376 -0
  21. package/android/src/main/java/com/theoplayer/media/MediaNotificationBuilder.kt +78 -34
  22. package/android/src/main/java/com/theoplayer/media/MediaPlaybackService.kt +53 -20
  23. package/android/src/main/java/com/theoplayer/media/MediaSessionConfig.kt +6 -6
  24. package/android/src/main/java/com/theoplayer/media/MediaSessionConfigAdapter.kt +23 -20
  25. package/android/src/main/java/com/theoplayer/metrics/MetricsModule.kt +37 -0
  26. package/android/src/main/java/com/theoplayer/player/PlayerModule.kt +0 -1
  27. package/android/src/main/java/com/theoplayer/presentation/PipUtils.kt +98 -93
  28. package/android/src/main/java/com/theoplayer/theoads/THEOadsModule.kt +1 -1
  29. package/android/src/main/java/com/theoplayer/util/ReadableExtension.kt +14 -0
  30. package/android/src/main/res/drawable/ic_next.xml +9 -0
  31. package/android/src/main/res/drawable/ic_prev.xml +9 -0
  32. package/android/src/main/res/values/strings.xml +4 -0
  33. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeAdsBridgeTest.kt +250 -0
  34. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeConfigurationTest.kt +30 -0
  35. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTest.kt +507 -0
  36. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTestHost.kt +104 -0
  37. package/ios/THEOplayerRCTBridge.m +35 -0
  38. package/ios/THEOplayerRCTDebug.swift +3 -0
  39. package/ios/THEOplayerRCTMainEventHandler.swift +17 -0
  40. package/ios/THEOplayerRCTPlayerAPI.swift +31 -0
  41. package/ios/THEOplayerRCTTypeUtils.swift +30 -0
  42. package/ios/THEOplayerRCTView.swift +15 -5
  43. package/ios/Theoplayer-Bridging-Header.h +0 -1
  44. package/ios/backgroundAudio/THEOplayerRCTBackgroundAudioManager.swift +1 -1
  45. package/ios/backgroundAudio/THEOplayerRCTNowPlayingManager.swift +49 -3
  46. package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift +151 -68
  47. package/ios/backgroundAudio/THEOplayerRCTView+MediaControlConfig.swift +25 -11
  48. package/ios/mediaControl/THEOplayerRCTMediaControlAPI.swift +79 -0
  49. package/ios/mediaControl/THEOplayerRCTMediaControlManager.swift +38 -0
  50. package/ios/metrics/THEOplayerRCTMetricsAPI.swift +31 -0
  51. package/ios/pip/THEOplayerRCTPipControlsManager.swift +9 -12
  52. package/lib/commonjs/api/barrel.js +31 -20
  53. package/lib/commonjs/api/barrel.js.map +1 -1
  54. package/lib/commonjs/api/event/PlayerEvent.js +8 -0
  55. package/lib/commonjs/api/event/PlayerEvent.js.map +1 -1
  56. package/lib/commonjs/api/media/MediaControlAPI.js +14 -0
  57. package/lib/commonjs/api/media/MediaControlAPI.js.map +1 -0
  58. package/lib/commonjs/api/media/barrel.js +11 -0
  59. package/lib/commonjs/api/media/barrel.js.map +1 -1
  60. package/lib/commonjs/api/metrics/MetricsAPI.js +2 -0
  61. package/lib/commonjs/api/metrics/MetricsAPI.js.map +1 -0
  62. package/lib/commonjs/api/metrics/barrel.js +17 -0
  63. package/lib/commonjs/api/metrics/barrel.js.map +1 -0
  64. package/lib/commonjs/api/player/Integration.js +2 -0
  65. package/lib/commonjs/api/player/Integration.js.map +1 -0
  66. package/lib/commonjs/api/player/PlayerEventMap.js +1 -0
  67. package/lib/commonjs/api/player/PlayerEventMap.js.map +1 -1
  68. package/lib/commonjs/api/player/THEOplayer.js.map +1 -1
  69. package/lib/commonjs/api/player/barrel.js +11 -0
  70. package/lib/commonjs/api/player/barrel.js.map +1 -1
  71. package/lib/commonjs/api/track/MediaTrack.js +16 -0
  72. package/lib/commonjs/api/track/MediaTrack.js.map +1 -1
  73. package/lib/commonjs/internal/THEOplayerView.js +6 -0
  74. package/lib/commonjs/internal/THEOplayerView.js.map +1 -1
  75. package/lib/commonjs/internal/THEOplayerView.web.js +3 -1
  76. package/lib/commonjs/internal/THEOplayerView.web.js.map +1 -1
  77. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js +1 -0
  78. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  79. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js +24 -0
  80. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
  81. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +29 -12
  82. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  83. package/lib/commonjs/internal/adapter/WebEventForwarder.js +6 -1
  84. package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
  85. package/lib/commonjs/internal/adapter/event/PlayerEvents.js +7 -1
  86. package/lib/commonjs/internal/adapter/event/PlayerEvents.js.map +1 -1
  87. package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js +42 -0
  88. package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
  89. package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js +32 -0
  90. package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
  91. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js +18 -0
  92. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  93. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js +16 -0
  94. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  95. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js +6 -0
  96. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  97. package/lib/commonjs/internal/adapter/web/PlayerFacade.js +258 -0
  98. package/lib/commonjs/internal/adapter/web/PlayerFacade.js.map +1 -0
  99. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js +6 -0
  100. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  101. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js +114 -0
  102. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  103. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js +6 -0
  104. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  105. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js +6 -0
  106. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  107. package/lib/commonjs/internal/adapter/web/WebMediaSession.js +78 -16
  108. package/lib/commonjs/internal/adapter/web/WebMediaSession.js.map +1 -1
  109. package/lib/commonjs/manifest.json +1 -1
  110. package/lib/module/api/barrel.js +1 -0
  111. package/lib/module/api/barrel.js.map +1 -1
  112. package/lib/module/api/event/PlayerEvent.js +9 -0
  113. package/lib/module/api/event/PlayerEvent.js.map +1 -1
  114. package/lib/module/api/media/MediaControlAPI.js +10 -0
  115. package/lib/module/api/media/MediaControlAPI.js.map +1 -0
  116. package/lib/module/api/media/barrel.js +1 -0
  117. package/lib/module/api/media/barrel.js.map +1 -1
  118. package/lib/module/api/metrics/MetricsAPI.js +2 -0
  119. package/lib/module/api/metrics/MetricsAPI.js.map +1 -0
  120. package/lib/module/api/metrics/barrel.js +4 -0
  121. package/lib/module/api/metrics/barrel.js.map +1 -0
  122. package/lib/module/api/player/Integration.js +2 -0
  123. package/lib/module/api/player/Integration.js.map +1 -0
  124. package/lib/module/api/player/PlayerEventMap.js +1 -0
  125. package/lib/module/api/player/PlayerEventMap.js.map +1 -1
  126. package/lib/module/api/player/THEOplayer.js.map +1 -1
  127. package/lib/module/api/player/barrel.js +1 -0
  128. package/lib/module/api/player/barrel.js.map +1 -1
  129. package/lib/module/api/track/MediaTrack.js +16 -0
  130. package/lib/module/api/track/MediaTrack.js.map +1 -1
  131. package/lib/module/internal/THEOplayerView.js +7 -1
  132. package/lib/module/internal/THEOplayerView.js.map +1 -1
  133. package/lib/module/internal/THEOplayerView.web.js +3 -1
  134. package/lib/module/internal/THEOplayerView.web.js.map +1 -1
  135. package/lib/module/internal/adapter/DefaultNativePlayerState.js +1 -0
  136. package/lib/module/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  137. package/lib/module/internal/adapter/THEOplayerAdapter.js +24 -0
  138. package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
  139. package/lib/module/internal/adapter/THEOplayerWebAdapter.js +29 -12
  140. package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  141. package/lib/module/internal/adapter/WebEventForwarder.js +7 -2
  142. package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
  143. package/lib/module/internal/adapter/event/PlayerEvents.js +5 -0
  144. package/lib/module/internal/adapter/event/PlayerEvents.js.map +1 -1
  145. package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js +37 -0
  146. package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
  147. package/lib/module/internal/adapter/media/MediaControlWebAdapter.js +27 -0
  148. package/lib/module/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
  149. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js +13 -0
  150. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  151. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js +11 -0
  152. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  153. package/lib/module/internal/adapter/web/IntegrationRegistration.js +4 -0
  154. package/lib/module/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  155. package/lib/module/internal/adapter/web/PlayerFacade.js +253 -0
  156. package/lib/module/internal/adapter/web/PlayerFacade.js.map +1 -0
  157. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js +4 -0
  158. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  159. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js +109 -0
  160. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  161. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js +4 -0
  162. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  163. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js +4 -0
  164. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  165. package/lib/module/internal/adapter/web/WebMediaSession.js +78 -16
  166. package/lib/module/internal/adapter/web/WebMediaSession.js.map +1 -1
  167. package/lib/module/manifest.json +1 -1
  168. package/lib/typescript/__tests__/PlayerFacade.test.d.ts +2 -0
  169. package/lib/typescript/__tests__/PlayerFacade.test.d.ts.map +1 -0
  170. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts +2 -0
  171. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts.map +1 -0
  172. package/lib/typescript/__tests__/index.test.d.ts +13 -0
  173. package/lib/typescript/__tests__/index.test.d.ts.map +1 -1
  174. package/lib/typescript/api/THEOplayerView.d.ts +4 -0
  175. package/lib/typescript/api/THEOplayerView.d.ts.map +1 -1
  176. package/lib/typescript/api/barrel.d.ts +1 -0
  177. package/lib/typescript/api/barrel.d.ts.map +1 -1
  178. package/lib/typescript/api/config/PlayerConfiguration.d.ts +15 -0
  179. package/lib/typescript/api/config/PlayerConfiguration.d.ts.map +1 -1
  180. package/lib/typescript/api/event/AdEvent.d.ts +1 -1
  181. package/lib/typescript/api/event/PlayerEvent.d.ts +9 -0
  182. package/lib/typescript/api/event/PlayerEvent.d.ts.map +1 -1
  183. package/lib/typescript/api/media/MediaControlAPI.d.ts +30 -0
  184. package/lib/typescript/api/media/MediaControlAPI.d.ts.map +1 -0
  185. package/lib/typescript/api/media/MediaControlConfiguration.d.ts +5 -1
  186. package/lib/typescript/api/media/MediaControlConfiguration.d.ts.map +1 -1
  187. package/lib/typescript/api/media/barrel.d.ts +1 -0
  188. package/lib/typescript/api/media/barrel.d.ts.map +1 -1
  189. package/lib/typescript/api/metrics/MetricsAPI.d.ts +21 -0
  190. package/lib/typescript/api/metrics/MetricsAPI.d.ts.map +1 -0
  191. package/lib/typescript/api/metrics/barrel.d.ts +2 -0
  192. package/lib/typescript/api/metrics/barrel.d.ts.map +1 -0
  193. package/lib/typescript/api/player/Integration.d.ts +88 -0
  194. package/lib/typescript/api/player/Integration.d.ts.map +1 -0
  195. package/lib/typescript/api/player/PlayerEventMap.d.ts +7 -2
  196. package/lib/typescript/api/player/PlayerEventMap.d.ts.map +1 -1
  197. package/lib/typescript/api/player/THEOplayer.d.ts +24 -0
  198. package/lib/typescript/api/player/THEOplayer.d.ts.map +1 -1
  199. package/lib/typescript/api/player/barrel.d.ts +1 -0
  200. package/lib/typescript/api/player/barrel.d.ts.map +1 -1
  201. package/lib/typescript/api/track/MediaTrack.d.ts +21 -4
  202. package/lib/typescript/api/track/MediaTrack.d.ts.map +1 -1
  203. package/lib/typescript/internal/THEOplayerView.d.ts +1 -0
  204. package/lib/typescript/internal/THEOplayerView.d.ts.map +1 -1
  205. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts +1 -0
  206. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts.map +1 -1
  207. package/lib/typescript/internal/adapter/NativePlayerState.d.ts +1 -0
  208. package/lib/typescript/internal/adapter/NativePlayerState.d.ts.map +1 -1
  209. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts +8 -1
  210. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
  211. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +8 -2
  212. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
  213. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts +1 -0
  214. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
  215. package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts +4 -1
  216. package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts.map +1 -1
  217. package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts +1 -0
  218. package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts.map +1 -1
  219. package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts +12 -0
  220. package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts.map +1 -0
  221. package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts +14 -0
  222. package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts.map +1 -0
  223. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts +7 -0
  224. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts.map +1 -0
  225. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts +8 -0
  226. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts.map +1 -0
  227. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts +53 -0
  228. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts.map +1 -0
  229. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts +26 -0
  230. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts.map +1 -0
  231. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts +33 -0
  232. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts.map +1 -0
  233. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts +21 -0
  234. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts.map +1 -0
  235. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts +43 -0
  236. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts.map +1 -0
  237. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts +13 -0
  238. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts.map +1 -0
  239. package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts +10 -3
  240. package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts.map +1 -1
  241. package/package.json +3 -3
  242. package/react-native-theoplayer.podspec +7 -7
  243. package/src/__tests__/PlayerFacade.test.ts +579 -0
  244. package/src/__tests__/PlayerFacadeWebAdapter.test.ts +193 -0
  245. package/src/__tests__/index.test.tsx +15 -1
  246. package/src/api/THEOplayerView.ts +5 -0
  247. package/src/api/barrel.ts +1 -0
  248. package/src/api/config/PlayerConfiguration.ts +16 -0
  249. package/src/api/event/AdEvent.ts +1 -1
  250. package/src/api/event/PlayerEvent.ts +10 -0
  251. package/src/api/media/MediaControlAPI.ts +33 -0
  252. package/src/api/media/MediaControlConfiguration.ts +5 -1
  253. package/src/api/media/barrel.ts +1 -0
  254. package/src/api/metrics/MetricsAPI.ts +20 -0
  255. package/src/api/metrics/barrel.ts +1 -0
  256. package/src/api/player/Integration.ts +97 -0
  257. package/src/api/player/PlayerEventMap.ts +7 -0
  258. package/src/api/player/THEOplayer.ts +27 -0
  259. package/src/api/player/barrel.ts +1 -0
  260. package/src/api/track/MediaTrack.ts +21 -4
  261. package/src/internal/THEOplayerView.tsx +10 -2
  262. package/src/internal/THEOplayerView.web.tsx +2 -2
  263. package/src/internal/adapter/DefaultNativePlayerState.ts +1 -0
  264. package/src/internal/adapter/NativePlayerState.ts +1 -0
  265. package/src/internal/adapter/THEOplayerAdapter.ts +33 -0
  266. package/src/internal/adapter/THEOplayerWebAdapter.ts +38 -12
  267. package/src/internal/adapter/WebEventForwarder.ts +12 -3
  268. package/src/internal/adapter/event/PlayerEvents.ts +10 -0
  269. package/src/internal/adapter/event/native/NativePlayerEvent.ts +2 -0
  270. package/src/internal/adapter/media/MediaControlNativeAdapter.ts +38 -0
  271. package/src/internal/adapter/media/MediaControlWebAdapter.ts +28 -0
  272. package/src/internal/adapter/metrics/MetricsNativeAdapter.ts +12 -0
  273. package/src/internal/adapter/metrics/MetricsWebAdapter.ts +14 -0
  274. package/src/internal/adapter/web/IntegrationRegistration.ts +57 -0
  275. package/src/internal/adapter/web/PlayerFacade.ts +281 -0
  276. package/src/internal/adapter/web/PlayerFacadeAPI.ts +35 -0
  277. package/src/internal/adapter/web/PlayerFacadeAdsEvents.ts +119 -0
  278. package/src/internal/adapter/web/PlayerFacadeIntegration.ts +45 -0
  279. package/src/internal/adapter/web/PlayerFacadeTypes.ts +14 -0
  280. package/src/internal/adapter/web/WebMediaSession.ts +85 -21
  281. package/src/manifest.json +1 -1
  282. package/android/src/main/java/com/theoplayer/media/MediaQueueNavigator.kt +0 -33
@@ -0,0 +1,193 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readFileSync } from 'node:fs';
3
+ import path from 'node:path';
4
+ import { test } from 'node:test';
5
+ import type { AdBreak, ChromelessPlayer } from 'theoplayer';
6
+ import ts from 'typescript';
7
+ import type { PlayerFacade } from '../internal/adapter/web/PlayerFacadeTypes';
8
+
9
+ function setup(enabled = true) {
10
+ const actions = new Map<string, (event: { seekTime?: number }) => void>();
11
+ const session = {
12
+ position: undefined as MediaPositionState | undefined,
13
+ playbackState: 'none',
14
+ setActionHandler: (action: string, callback: (event: { seekTime?: number }) => void) => actions.set(action, callback),
15
+ setPositionState: (state: MediaPositionState) => {
16
+ session.position = state;
17
+ },
18
+ };
19
+ const document = { visibilityState: 'visible', addEventListener: () => undefined, removeEventListener: () => undefined };
20
+ const browser = { MediaMetadata: class {} };
21
+ const root = path.resolve('src/internal/adapter');
22
+ const actual = new Set([
23
+ 'THEOplayerWebAdapter.ts',
24
+ 'web/PlayerFacade.ts',
25
+ 'web/PlayerFacadeAdsEvents.ts',
26
+ 'web/WebMediaSession.ts',
27
+ 'media/MediaControlWebAdapter.ts',
28
+ ]);
29
+ const stubs = new Proxy(
30
+ {},
31
+ {
32
+ get: () =>
33
+ class {
34
+ addEventListener() {
35
+ return undefined;
36
+ }
37
+ dispatchEvent() {
38
+ return undefined;
39
+ }
40
+ unload() {
41
+ return undefined;
42
+ }
43
+ destroy() {
44
+ return undefined;
45
+ }
46
+ },
47
+ },
48
+ );
49
+ const api = { PlayerEventType: { DESTROY: 'destroy' }, MediaControlAction: { PLAY: 'play', PAUSE: 'pause' } };
50
+ const modules = new Map<string, object>();
51
+ const load = (file: string): object => {
52
+ const cached = modules.get(file);
53
+ if (cached) return cached;
54
+ const exports = {};
55
+ modules.set(file, exports);
56
+ const compiled = ts.transpileModule(readFileSync(file, 'utf8'), {
57
+ compilerOptions: { target: ts.ScriptTarget.ES2020, module: ts.ModuleKind.CommonJS },
58
+ });
59
+ new Function('exports', 'require', 'navigator', 'window', 'document', 'MediaMetadata', compiled.outputText)(
60
+ exports,
61
+ (specifier: string) => {
62
+ if (specifier === 'react-native-theoplayer') return api;
63
+ const target = path.resolve(path.dirname(file), `${specifier}.ts`);
64
+ return actual.has(path.relative(root, target)) ? load(target) : stubs;
65
+ },
66
+ { mediaSession: session },
67
+ browser,
68
+ document,
69
+ browser.MediaMetadata,
70
+ );
71
+ return exports;
72
+ };
73
+ const { THEOplayerWebAdapter } = load(path.join(root, 'THEOplayerWebAdapter.ts')) as typeof import('../internal/adapter/THEOplayerWebAdapter');
74
+ const listeners = new Map<string, Set<(event: unknown) => void>>();
75
+ const content = {
76
+ currentTime: 100,
77
+ duration: 600,
78
+ playbackRate: 1,
79
+ paused: false,
80
+ calls: [] as string[],
81
+ ads: { playing: false, addEventListener: () => undefined, removeEventListener: () => undefined },
82
+ addEventListener(types: string | string[], listener: (event: unknown) => void) {
83
+ for (const type of typeof types === 'string' ? [types] : types) {
84
+ if (!listeners.has(type)) listeners.set(type, new Set());
85
+ listeners.get(type)!.add(listener);
86
+ }
87
+ },
88
+ removeEventListener(types: string | string[], listener: (event: unknown) => void) {
89
+ for (const type of typeof types === 'string' ? [types] : types) listeners.get(type)?.delete(listener);
90
+ },
91
+ emit(type: string) {
92
+ for (const listener of [...(listeners.get(type) ?? [])]) listener({ type, date: new Date() });
93
+ },
94
+ pause() {
95
+ this.calls.push('pause');
96
+ this.paused = true;
97
+ },
98
+ play() {
99
+ this.calls.push('play');
100
+ this.paused = false;
101
+ },
102
+ destroy() {
103
+ this.calls.push('destroy');
104
+ this.emit('destroy');
105
+ },
106
+ };
107
+ const adapter = new THEOplayerWebAdapter(content as unknown as ChromelessPlayer, { usePlayerFacade: enabled });
108
+ const facade = adapter.nativeHandle as PlayerFacade;
109
+ return { adapter, facade, content, session, actions };
110
+ }
111
+
112
+ test('media session uses facade clocks, commands, synthetic updates, and advertising state', () => {
113
+ const { adapter, facade, content, session, actions } = setup();
114
+ const commands: Array<string | number> = [];
115
+ const state = { paused: false, currentTime: 2, playingAd: false };
116
+ const registration = facade.registerIntegration({
117
+ getCurrentTime: () => state.currentTime,
118
+ getDuration: () => 30,
119
+ isPaused: () => state.paused,
120
+ getAdState: () => ({ playing: state.playingAd, currentAds: [], currentAdBreak: null }),
121
+ pause: () => {
122
+ commands.push('pause');
123
+ return true;
124
+ },
125
+ play: () => {
126
+ commands.push('play');
127
+ return true;
128
+ },
129
+ setCurrentTime: (value) => {
130
+ commands.push(value);
131
+ state.currentTime = value;
132
+ return true;
133
+ },
134
+ });
135
+ content.emit('sourcechange');
136
+ registration.dispatchEvent({ type: 'playing', date: new Date(), currentTime: 2 });
137
+ registration.dispatchEvent({ type: 'durationchange', date: new Date(), duration: 30 });
138
+ assert.deepEqual(session.position, { duration: 30, position: 2, playbackRate: 1 });
139
+ actions.get('pause')!({});
140
+ actions.get('play')!({});
141
+ actions.get('seekto')!({ seekTime: 9 });
142
+ assert.deepEqual(commands, ['pause', 'play', 9]);
143
+ assert.deepEqual(content.calls, []);
144
+ assert.equal(content.currentTime, 100);
145
+ state.paused = true;
146
+ registration.dispatchEvent({ type: 'pause', date: new Date(), currentTime: 9 });
147
+ assert.equal(session.playbackState, 'paused');
148
+ state.playingAd = true;
149
+ registration.dispatchEvent({ type: 'adbreakbegin', date: new Date(), adBreak: {} as AdBreak });
150
+ actions.get('pause')!({});
151
+ actions.get('seekto')!({ seekTime: 10 });
152
+ assert.deepEqual(commands, ['pause', 'play', 9]);
153
+ registration.close();
154
+ content.emit('pause');
155
+ actions.get('pause')!({});
156
+ assert.deepEqual(content.calls, ['pause']);
157
+ adapter.destroy();
158
+ });
159
+
160
+ for (const enabled of [false, true]) {
161
+ test(`wrapper destruction reaches native-handle listeners (facade=${enabled})`, () => {
162
+ const { adapter, facade, content } = setup(enabled);
163
+ let native = 0;
164
+ let exposed = 0;
165
+ content.addEventListener('destroy', () => native++);
166
+ facade.addEventListener('destroy', () => exposed++);
167
+ adapter.destroy();
168
+ assert.equal(native, 1);
169
+ assert.equal(exposed, 1);
170
+ assert.equal(adapter.nativeHandle, undefined);
171
+ });
172
+ }
173
+
174
+ for (const mode of ['no-event', 'throw-before-event', 'throw-listener', 'consume'] as const) {
175
+ test(`wrapper destruction still closes facade when ${mode}`, () => {
176
+ const { adapter, facade, content } = setup();
177
+ const registration = facade.registerIntegration({});
178
+ if (mode === 'no-event') content.destroy = () => undefined;
179
+ if (mode === 'throw-before-event')
180
+ content.destroy = () => {
181
+ throw new Error('destroy failed');
182
+ };
183
+ if (mode === 'throw-listener')
184
+ facade.addEventListener('destroy', () => {
185
+ throw new Error('listener failed');
186
+ });
187
+ if (mode === 'consume') registration.interceptPlayerEvents(() => true);
188
+ if (mode === 'throw-before-event' || mode === 'throw-listener') assert.throws(() => adapter.destroy(), /failed/);
189
+ else adapter.destroy();
190
+ assert.throws(() => facade.registerIntegration({}), /closed/);
191
+ assert.equal(adapter.nativeHandle, undefined);
192
+ });
193
+ }
@@ -1 +1,15 @@
1
- export {};
1
+ import type { MediaTrack, MediaTrackKind } from '../index';
2
+
3
+ type Assert<T extends true> = T;
4
+
5
+ export type MediaTrackKindChecks = [
6
+ Assert<'main' | 'alternative' extends MediaTrackKind ? true : false>,
7
+ Assert<'descriptions' | 'description' | 'main-desc' extends MediaTrackKind ? true : false>,
8
+ Assert<'commentary' | 'translation' | 'captions' | 'sign' | 'subtitles' | '' extends MediaTrackKind ? true : false>,
9
+ Assert<'vendor-custom' extends MediaTrackKind ? true : false>,
10
+ Assert<string extends MediaTrackKind ? true : false>,
11
+ Assert<MediaTrackKind extends string ? true : false>,
12
+ Assert<string extends MediaTrack['kind'] ? true : false>,
13
+ Assert<MediaTrack['kind'] extends MediaTrackKind ? true : false>,
14
+ Assert<Extract<number | boolean | null | undefined | object, MediaTrackKind> extends never ? true : false>,
15
+ ];
@@ -23,6 +23,11 @@ export interface THEOplayerViewProps {
23
23
  */
24
24
  posterStyle?: StyleProp<ImageStyle> | undefined;
25
25
 
26
+ /**
27
+ * The testID applied to the player view, used to locate it from UI automation tools.
28
+ */
29
+ testID?: string;
30
+
26
31
  /**
27
32
  * Callback for when the internal THEOplayer is ready.
28
33
  */
package/src/api/barrel.ts CHANGED
@@ -10,6 +10,7 @@ export * from './config/barrel';
10
10
  export * from './error/barrel';
11
11
  export * from './event/barrel';
12
12
  export * from './media/barrel';
13
+ export * from './metrics/barrel';
13
14
  export * from './millicast/barrel';
14
15
  export * from './drm/barrel';
15
16
  export * from './source/barrel';
@@ -153,6 +153,22 @@ export interface PlayerConfiguration {
153
153
  * <br/> - Source-level configuration can override player-level values. See {@link CmcdSourceConfiguration}.
154
154
  */
155
155
  cmcd?: CmcdPlayerConfiguration;
156
+
157
+ /**
158
+ * Whether to expose a stable player facade for integration-owned playback and advertising.
159
+ *
160
+ * @remarks
161
+ * <br/> - Set this option at player creation, before registering an integration.
162
+ * <br/> - On Web, the facade is exposed through {@link THEOplayer.nativeHandle}.
163
+ * <br/> - On Android, integrations register through the native `ReactTHEOplayerView` API.
164
+ * <br/> - The content player remains available to integrations without facade overrides.
165
+ * <br/> - This option has no effect on iOS or tvOS.
166
+ *
167
+ * @experimental This API is subject to change or removal without notice.
168
+ * @defaultValue false
169
+ * @platform web,android
170
+ */
171
+ readonly usePlayerFacade?: boolean;
156
172
  }
157
173
 
158
174
  /**
@@ -126,7 +126,7 @@ export enum AdEventType {
126
126
  /**
127
127
  * Dispatched when an ad is clicked.
128
128
  *
129
- * @platform ios,android
129
+ * @platform ios,android,web
130
130
  */
131
131
  AD_CLICKED = 'adclicked',
132
132
 
@@ -312,3 +312,13 @@ export interface ContentProtectionErrorEvent extends Event<PlayerEventType.CONTE
312
312
  */
313
313
  readonly error: ContentProtectionErrorObject;
314
314
  }
315
+
316
+ /**
317
+ * Dispatched when content protection succeeds, i.e. when the key session for a media track was successfully set up.
318
+ *
319
+ * @category Events
320
+ * @category Player
321
+ * @category Content Protection
322
+ * @public
323
+ */
324
+ export type ContentProtectionSuccessEvent = Event<PlayerEventType.CONTENT_PROTECTION_SUCCESS>;
@@ -0,0 +1,33 @@
1
+ import { THEOplayer } from 'react-native-theoplayer';
2
+
3
+ export type MediaControlHandler = (player: THEOplayer) => void;
4
+
5
+ export enum MediaControlAction {
6
+ PLAY = 'play',
7
+ PAUSE = 'pause',
8
+ SKIP_TO_PREVIOUS = 'skipToPrevious',
9
+ SKIP_TO_NEXT = 'skipToNext',
10
+ }
11
+
12
+ export interface MediaControlAPI {
13
+ /**
14
+ * Sets a handler for a media control action.
15
+ *
16
+ * @param action The media control action to set the handler for.
17
+ * @param handler The handler function that will be called when the specified media control action is triggered. The handler receives the THEOplayer instance as an argument.
18
+ * Passing `undefined` removes any previously set handler for the action, restoring the player's default behaviour.
19
+ */
20
+ setHandler(action: MediaControlAction, handler: MediaControlHandler | undefined): void;
21
+
22
+ /**
23
+ * Enables or disables the media session for this player instance at runtime.
24
+ *
25
+ * @remarks
26
+ * <br/> - This overrides the {@link MediaControlConfiguration.mediaSessionEnabled} value passed at creation time.
27
+ * <br/> - When multiple players are active, this can be used to designate a single "active" player that publishes
28
+ * media metadata (e.g. Now Playing info) and responds to remote control commands, while disabling the others.
29
+ *
30
+ * @param enabled Whether the media session should be enabled for this player.
31
+ */
32
+ setEnabled(enabled: boolean): void;
33
+ }
@@ -19,7 +19,7 @@ export interface MediaControlConfiguration {
19
19
  *
20
20
  * @defaultValue `true`
21
21
  *
22
- * @platform web,android
22
+ * @platform web,android,ios
23
23
  */
24
24
  readonly mediaSessionEnabled?: boolean;
25
25
 
@@ -44,6 +44,8 @@ export interface MediaControlConfiguration {
44
44
  * @defaultValue `false`
45
45
  *
46
46
  * @platform ios,android
47
+ *
48
+ * @deprecated Use {@link MediaControlAPI} to handle `skipToPrevious` and `skipToNext` actions instead.
47
49
  */
48
50
  readonly convertSkipToSeek?: boolean;
49
51
 
@@ -63,6 +65,8 @@ export interface MediaControlConfiguration {
63
65
  * @defaultValue `false`
64
66
  *
65
67
  * @platform ios,android
68
+ *
69
+ * @deprecated Use {@link MediaControlAPI} to handle `play` action and seek to the live edge instead.
66
70
  */
67
71
  readonly seekToLiveOnResume?: boolean;
68
72
  }
@@ -1 +1,2 @@
1
1
  export * from './MediaControlConfiguration';
2
+ export * from './MediaControlAPI';
@@ -0,0 +1,20 @@
1
+ /**
2
+ * The API for player metrics.
3
+ *
4
+ * @category Player
5
+ * @public
6
+ */
7
+ export interface MetricsAPI {
8
+ /**
9
+ * The bandwidth, in bits per second, that the player estimates is currently available.
10
+ * This is the value used to make adaptive bitrate (ABR) decisions.
11
+ *
12
+ * @remarks
13
+ * <br/> - This value is poll-based: read it on demand, as there is no change event.
14
+ * <br/> - Resolves to `0` when no estimate is available yet (e.g. before playback or after a reset).
15
+ * A value of `0` means "not available/estimated", not literally zero bandwidth.
16
+ * <br/> - On Android and Web the estimate is reported for regular adaptive streams (HLS, DASH, ...).
17
+ * <br/> - On iOS/tvOS the estimate is only populated for THEOlive/HESP streams; it stays `0` for other playback (HLS, MP4).
18
+ */
19
+ currentBandwidthEstimate(): Promise<number>;
20
+ }
@@ -0,0 +1 @@
1
+ export * from './MetricsAPI';
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Describes optional playback overrides supplied by a player facade integration.
3
+ *
4
+ * @remarks
5
+ * <br/> - Requires {@link PlayerConfiguration.usePlayerFacade} when creating the player.
6
+ * <br/> - Registration takes place on the Web native handle or through the Android native API, not on the React Native player API.
7
+ * <br/> - Omitted hooks and nullish getter results delegate to the content player.
8
+ * <br/> - The integration owns playback synchronization and must dispatch events when its public state changes.
9
+ *
10
+ * @experimental This API is subject to change or removal without notice.
11
+ * @category Player
12
+ * @platform web,android
13
+ * @public
14
+ */
15
+ export interface Integration {
16
+ /**
17
+ * Returns the current playback time, in seconds.
18
+ *
19
+ * @returns A finite, non-negative time, or `null` or `undefined` to use the content player's time.
20
+ * Invalid times also fall back to the content player.
21
+ */
22
+ getCurrentTime?(): number | null | undefined;
23
+
24
+ /**
25
+ * Requests a seek to the given playback time.
26
+ *
27
+ * @param currentTime - The requested time, in seconds.
28
+ * @returns `true` if handled, or `false` to seek the content player instead.
29
+ */
30
+ setCurrentTime?(currentTime: number): boolean;
31
+
32
+ /**
33
+ * Requests playback to start or resume.
34
+ *
35
+ * @returns `true` if handled, or `false` to play the content player instead.
36
+ */
37
+ play?(): boolean;
38
+
39
+ /**
40
+ * Requests playback to pause.
41
+ *
42
+ * @returns `true` if handled, or `false` to pause the content player instead.
43
+ */
44
+ pause?(): boolean;
45
+
46
+ /**
47
+ * Returns whether playback is paused.
48
+ *
49
+ * @returns The paused state, or `null` or `undefined` to use the content player's state.
50
+ */
51
+ isPaused?(): boolean | null | undefined;
52
+
53
+ /**
54
+ * Returns whether a seek is in progress.
55
+ *
56
+ * @returns The seeking state, or `null` or `undefined` to use the content player's state.
57
+ */
58
+ isSeeking?(): boolean | null | undefined;
59
+
60
+ /**
61
+ * Returns the playback duration, in seconds.
62
+ *
63
+ * @returns The duration, or `null` or `undefined` to use the content player's duration.
64
+ * `Infinity` and `NaN` are preserved for live or unknown durations.
65
+ */
66
+ getDuration?(): number | null | undefined;
67
+
68
+ /**
69
+ * Returns whether audio is muted.
70
+ *
71
+ * @returns The muted state, or `null` or `undefined` to use the content player's state.
72
+ */
73
+ getMuted?(): boolean | null | undefined;
74
+
75
+ /**
76
+ * Requests a change to the muted state.
77
+ *
78
+ * @param muted - Whether audio should be muted.
79
+ * @returns `true` if handled, or `false` to update the content player instead.
80
+ */
81
+ setMuted?(muted: boolean): boolean;
82
+
83
+ /**
84
+ * Returns the audio volume.
85
+ *
86
+ * @returns A volume between `0` and `1`, or `null` or `undefined` to use the content player's volume.
87
+ */
88
+ getVolume?(): number | null | undefined;
89
+
90
+ /**
91
+ * Requests a change to the audio volume.
92
+ *
93
+ * @param volume - The requested volume, between `0` and `1`.
94
+ * @returns `true` if handled, or `false` to update the content player instead.
95
+ */
96
+ setVolume?(volume: number): boolean;
97
+ }
@@ -1,6 +1,7 @@
1
1
  import type { Event } from '../event/Event';
2
2
  import type {
3
3
  ContentProtectionErrorEvent,
4
+ ContentProtectionSuccessEvent,
4
5
  CurrentSourceChangeEvent,
5
6
  DimensionChangeEvent,
6
7
  DurationChangeEvent,
@@ -65,6 +66,7 @@ export enum PlayerEventType {
65
66
  DIMENSION_CHANGE = 'dimensionchange',
66
67
  VIDEO_RESIZE = 'videoresize',
67
68
  CONTENT_PROTECTION_ERROR = 'contentprotectionerror',
69
+ CONTENT_PROTECTION_SUCCESS = 'contentprotectionsuccess',
68
70
  }
69
71
 
70
72
  /**
@@ -249,4 +251,9 @@ export interface PlayerEventMap {
249
251
  * Dispatched when an error related to content protection occurs.
250
252
  */
251
253
  [PlayerEventType.CONTENT_PROTECTION_ERROR]: ContentProtectionErrorEvent;
254
+
255
+ /**
256
+ * Dispatched when content protection succeeds, i.e. when the key session for a media track was successfully set up.
257
+ */
258
+ [PlayerEventType.CONTENT_PROTECTION_SUCCESS]: ContentProtectionSuccessEvent;
252
259
  }
@@ -15,6 +15,8 @@ import type { PlayerVersion } from './PlayerVersion';
15
15
  import type { EventBroadcastAPI } from '../broadcast/EventBroadcastAPI';
16
16
  import { TheoAdsAPI } from '../theoads/TheoAdsAPI';
17
17
  import { TheoLiveAPI } from '../theolive/TheoLiveAPI';
18
+ import { MediaControlAPI } from '../media/MediaControlAPI';
19
+ import type { MetricsAPI } from '../metrics/MetricsAPI';
18
20
 
19
21
  export type PreloadType = 'none' | 'metadata' | 'auto' | '';
20
22
 
@@ -198,6 +200,21 @@ export interface THEOplayer extends EventDispatcher<PlayerEventMap> {
198
200
  */
199
201
  aspectRatio: AspectRatio;
200
202
 
203
+ /**
204
+ * Whether the player manages the display criteria of the TV to match the content.
205
+ *
206
+ * @defaultValue `false`
207
+ *
208
+ * @platform ios
209
+ *
210
+ * @remarks
211
+ * <br/> - Only supported on tvOS.
212
+ * <br/> - When enabled, and while the player is presented fullscreen, the player sets the display's preferred frame rate and dynamic range to match the content before playback starts.
213
+ * <br/> - The display only follows these criteria when the viewer enabled content matching on tvOS in "Settings" > "Video and Audio" > "Match Content".
214
+ * <br/> - A display mode switch can briefly blank the screen, so only enable this on a single, fullscreen-presented player.
215
+ */
216
+ manageContentMatching: boolean;
217
+
201
218
  /**
202
219
  * Specifies where the player is displaying the video.
203
220
  *
@@ -287,4 +304,14 @@ export interface THEOplayer extends EventDispatcher<PlayerEventMap> {
287
304
  * The API for THEOlive.
288
305
  */
289
306
  readonly theoLive: TheoLiveAPI;
307
+
308
+ /**
309
+ * The API for media controls.
310
+ */
311
+ readonly mediaControl?: MediaControlAPI;
312
+
313
+ /**
314
+ * The API for player metrics.
315
+ */
316
+ readonly metrics: MetricsAPI;
290
317
  }
@@ -1,3 +1,4 @@
1
1
  export * from './THEOplayer';
2
2
  export * from './PlayerEventMap';
3
3
  export * from './PlayerVersion';
4
+ export * from './Integration';
@@ -4,10 +4,26 @@ import type { Quality } from './Quality';
4
4
  /**
5
5
  * Represents the category of a media track (audio or video).
6
6
  *
7
+ * @remarks
8
+ * The value depends on the stream and platform. Typical values include:
9
+ * <br/> - `'main'`: The primary track.
10
+ * <br/> - `'alternative'`: An alternative to the primary track.
11
+ * <br/> - `'commentary'`: A commentary track.
12
+ * <br/> - `'descriptions'`: Audio descriptions of the video content.
13
+ * <br/> - `'description'`: A variant of `'descriptions'` used by some streams or platforms.
14
+ * <br/> - `'main-desc'`: The primary audio track with audio descriptions.
15
+ * <br/> - `'translation'`: A translated audio track.
16
+ * <br/> - `'captions'`: A video track with captions.
17
+ * <br/> - `'sign'`: A sign-language video track.
18
+ * <br/> - `'subtitles'`: A video track with subtitles.
19
+ * <br/> - `''`: No kind is specified.
20
+ *
21
+ * This list is not exhaustive. Other string values are accepted and are not normalized.
22
+ *
7
23
  * @category Media and Text Tracks
8
24
  * @public
9
25
  */
10
- export type MediaTrackKind = 'main' | 'alternative';
26
+ export type MediaTrackKind = string;
11
27
 
12
28
  /**
13
29
  * Represents a media track (audio or video) of a media resource.
@@ -35,9 +51,10 @@ export interface MediaTrack extends Track {
35
51
  readonly uid: number;
36
52
 
37
53
  /**
38
- * The kind of the media track, represented by a value from the following list:
39
- * <br/> - `'main'`: The track is the default track for playback
40
- * <br/> - `'alternative'`: The track is not the default track for playback
54
+ * The kind of the media track, as reported by the underlying player.
55
+ *
56
+ * @remarks
57
+ * See {@link MediaTrackKind} for typical values. Other string values are possible.
41
58
  */
42
59
  readonly kind: MediaTrackKind;
43
60
 
@@ -24,6 +24,7 @@ import {
24
24
  DefaultChromecastChangeEvent,
25
25
  DefaultChromecastErrorEvent,
26
26
  DefaultContentProtectionErrorEvent,
27
+ DefaultContentProtectionSuccessEvent,
27
28
  DefaultCurrentSourceChangeEvent,
28
29
  DefaultDimensionChangeEvent,
29
30
  DefaultDurationChangeEvent,
@@ -54,6 +55,7 @@ import type {
54
55
  import { toMediaTrackType, toMediaTrackTypeEventType, toTextTrackEventType, toTrackListEventType } from './adapter/event/native/NativeTrackEvent';
55
56
  import {
56
57
  NativeContentProtectionErrorEvent,
58
+ NativeContentProtectionSuccessEvent,
57
59
  NativeCurrentSourceChangeEvent,
58
60
  NativeDurationChangeEvent,
59
61
  NativeErrorEvent,
@@ -119,6 +121,7 @@ interface THEOplayerRCTViewProps {
119
121
  onNativePresentationModeChange: (event: NativeSyntheticEvent<NativePresentationModeChangeEvent>) => void;
120
122
  onNativeDeviceOrientationChanged: () => void;
121
123
  onNativeContentProtectionError: (event: NativeSyntheticEvent<NativeContentProtectionErrorEvent>) => void;
124
+ onNativeContentProtectionSuccess: (event: NativeSyntheticEvent<NativeContentProtectionSuccessEvent>) => void;
122
125
  onNativeDimensionChange: (event: NativeSyntheticEvent<NativeDimensionChangeEvent>) => void;
123
126
  onNativeVideoResize: (event: NativeSyntheticEvent<NativeVideoResizeEvent>) => void;
124
127
  }
@@ -429,6 +432,10 @@ export class THEOplayerView extends PureComponent<React.PropsWithChildren<THEOpl
429
432
  this._facade?.dispatchEvent(new DefaultContentProtectionErrorEvent(event.nativeEvent.error));
430
433
  };
431
434
 
435
+ private _onContentProtectionSuccess = (_event: NativeSyntheticEvent<NativeContentProtectionSuccessEvent>) => {
436
+ this._facade?.dispatchEvent(new DefaultContentProtectionSuccessEvent());
437
+ };
438
+
432
439
  private _onVideoResize = (event: NativeSyntheticEvent<NativeVideoResizeEvent>) => {
433
440
  this._facade?.dispatchEvent(new DefaultVideoResizeEvent(event.nativeEvent.videoWidth, event.nativeEvent.videoHeight));
434
441
  };
@@ -468,11 +475,11 @@ export class THEOplayerView extends PureComponent<React.PropsWithChildren<THEOpl
468
475
  }
469
476
 
470
477
  public render(): React.JSX.Element {
471
- const { config, style, posterStyle, children } = this.props;
478
+ const { config, style, posterStyle, testID, children } = this.props;
472
479
  const { posterActive, poster } = this.state;
473
480
 
474
481
  return (
475
- <View style={[styles.base, style, this.styleOverride()]}>
482
+ <View testID={testID} style={[styles.base, style, this.styleOverride()]}>
476
483
  <THEOplayerRCTView
477
484
  ref={this._root}
478
485
  style={StyleSheet.absoluteFill}
@@ -511,6 +518,7 @@ export class THEOplayerView extends PureComponent<React.PropsWithChildren<THEOpl
511
518
  onNativePresentationModeChange={this._onPresentationModeChange}
512
519
  onNativeDeviceOrientationChanged={this._onDeviceOrientationChanged}
513
520
  onNativeContentProtectionError={this._onContentProtectionError}
521
+ onNativeContentProtectionSuccess={this._onContentProtectionSuccess}
514
522
  onNativeDimensionChange={this._onDimensionChange}
515
523
  onNativeVideoResize={this._onVideoResize}
516
524
  />
@@ -5,7 +5,7 @@ import { THEOplayerWebAdapter } from './adapter/THEOplayerWebAdapter';
5
5
  import { useIsAttached } from './hooks/useIsAttached';
6
6
 
7
7
  export function THEOplayerView(props: React.PropsWithChildren<THEOplayerViewProps>) {
8
- const { config, children, onPlayerReady, onPlayerDestroy } = props;
8
+ const { config, children, onPlayerReady, onPlayerDestroy, testID } = props;
9
9
  const player = useRef<ChromelessPlayer | null>(null);
10
10
  const adapter = useRef<THEOplayerWebAdapter | null>(null);
11
11
  const container = useRef<HTMLDivElement | null>(null);
@@ -59,7 +59,7 @@ export function THEOplayerView(props: React.PropsWithChildren<THEOplayerViewProp
59
59
  // Note: `display: contents` causes an element's children to appear as if they were direct children of the element's parent,
60
60
  // ignoring the element itself.
61
61
  // It's necessary to make sure we do not interfere with the IMA container
62
- <div id={'theoplayer-root-container'} style={{ display: CSS.supports('display', 'contents') ? 'contents' : 'flex' }}>
62
+ <div id={'theoplayer-root-container'} data-testid={testID} style={{ display: CSS.supports('display', 'contents') ? 'contents' : 'flex' }}>
63
63
  {!CSS.supports('aspect-ratio', '16/9') ? (
64
64
  // Handle aspect-ratio 16/9 with padding-top: 56.25% to support older versions.
65
65
  // {@link https://www.w3schools.com/howto/howto_css_aspect_ratio.asp}
@@ -30,6 +30,7 @@ export class DefaultNativePlayerState extends DefaultTextTrackState implements N
30
30
  playbackRate = 1;
31
31
  preload: PreloadType = 'none';
32
32
  aspectRatio: AspectRatio = AspectRatio.FIT;
33
+ manageContentMatching = false;
33
34
  renderingTarget: RenderingTarget = RenderingTarget.SURFACE_VIEW;
34
35
  keepScreenOn = true;
35
36
  audioTracks: MediaTrack[] = [];