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.
- package/CHANGELOG.md +20 -0
- package/README.md +69 -0
- package/android/build.gradle +1 -0
- package/android/src/main/java/com/theoplayer/PlayerConfigAdapter.kt +6 -0
- package/android/src/main/java/com/theoplayer/PlayerEventEmitter.kt +2 -2
- package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +37 -8
- package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +3 -0
- package/android/src/main/java/com/theoplayer/ReactTHEOplayerView.kt +51 -3
- package/android/src/main/java/com/theoplayer/ads/AdEventAdapter.kt +4 -0
- package/android/src/main/java/com/theoplayer/ads/AdsModule.kt +6 -6
- package/android/src/main/java/com/theoplayer/integration/Integration.kt +72 -0
- package/android/src/main/java/com/theoplayer/integration/IntegrationRegistration.kt +68 -0
- package/android/src/main/java/com/theoplayer/integration/PlayerFacade.kt +187 -0
- package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdState.kt +19 -0
- package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAds.kt +73 -0
- package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdsBridge.kt +112 -0
- package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEventSubscription.kt +11 -0
- package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEvents.kt +139 -0
- package/android/src/main/java/com/theoplayer/metrics/MetricsModule.kt +37 -0
- package/android/src/main/java/com/theoplayer/theoads/THEOadsModule.kt +1 -1
- package/android/src/test/java/com/theoplayer/integration/PlayerFacadeAdsBridgeTest.kt +250 -0
- package/android/src/test/java/com/theoplayer/integration/PlayerFacadeConfigurationTest.kt +30 -0
- package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTest.kt +507 -0
- package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTestHost.kt +104 -0
- package/ios/THEOplayerRCTBridge.m +19 -0
- package/ios/THEOplayerRCTPlayerAPI.swift +31 -0
- package/ios/Theoplayer-Bridging-Header.h +0 -1
- package/ios/metrics/THEOplayerRCTMetricsAPI.swift +31 -0
- package/lib/commonjs/api/barrel.js +31 -20
- package/lib/commonjs/api/barrel.js.map +1 -1
- package/lib/commonjs/api/metrics/MetricsAPI.js +2 -0
- package/lib/commonjs/api/metrics/MetricsAPI.js.map +1 -0
- package/lib/commonjs/api/metrics/barrel.js +17 -0
- package/lib/commonjs/api/metrics/barrel.js.map +1 -0
- package/lib/commonjs/api/player/Integration.js +2 -0
- package/lib/commonjs/api/player/Integration.js.map +1 -0
- package/lib/commonjs/api/player/THEOplayer.js.map +1 -1
- package/lib/commonjs/api/player/barrel.js +11 -0
- package/lib/commonjs/api/player/barrel.js.map +1 -1
- package/lib/commonjs/api/track/MediaTrack.js +16 -0
- package/lib/commonjs/api/track/MediaTrack.js.map +1 -1
- package/lib/commonjs/internal/THEOplayerView.js +2 -0
- package/lib/commonjs/internal/THEOplayerView.js.map +1 -1
- package/lib/commonjs/internal/THEOplayerView.web.js +3 -1
- package/lib/commonjs/internal/THEOplayerView.web.js.map +1 -1
- package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js +1 -0
- package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js.map +1 -1
- package/lib/commonjs/internal/adapter/THEOplayerAdapter.js +18 -0
- package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
- package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +21 -4
- package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
- package/lib/commonjs/internal/adapter/WebEventForwarder.js +1 -1
- package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
- package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js +18 -0
- package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
- package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js +16 -0
- package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
- package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js +6 -0
- package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js.map +1 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacade.js +258 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacade.js.map +1 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js +6 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js +114 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js +6 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js +6 -0
- package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
- package/lib/commonjs/manifest.json +1 -1
- package/lib/module/api/barrel.js +1 -0
- package/lib/module/api/barrel.js.map +1 -1
- package/lib/module/api/metrics/MetricsAPI.js +2 -0
- package/lib/module/api/metrics/MetricsAPI.js.map +1 -0
- package/lib/module/api/metrics/barrel.js +4 -0
- package/lib/module/api/metrics/barrel.js.map +1 -0
- package/lib/module/api/player/Integration.js +2 -0
- package/lib/module/api/player/Integration.js.map +1 -0
- package/lib/module/api/player/THEOplayer.js.map +1 -1
- package/lib/module/api/player/barrel.js +1 -0
- package/lib/module/api/player/barrel.js.map +1 -1
- package/lib/module/api/track/MediaTrack.js +16 -0
- package/lib/module/api/track/MediaTrack.js.map +1 -1
- package/lib/module/internal/THEOplayerView.js +2 -0
- package/lib/module/internal/THEOplayerView.js.map +1 -1
- package/lib/module/internal/THEOplayerView.web.js +3 -1
- package/lib/module/internal/THEOplayerView.web.js.map +1 -1
- package/lib/module/internal/adapter/DefaultNativePlayerState.js +1 -0
- package/lib/module/internal/adapter/DefaultNativePlayerState.js.map +1 -1
- package/lib/module/internal/adapter/THEOplayerAdapter.js +18 -0
- package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
- package/lib/module/internal/adapter/THEOplayerWebAdapter.js +21 -4
- package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
- package/lib/module/internal/adapter/WebEventForwarder.js +1 -1
- package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
- package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js +13 -0
- package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
- package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js +11 -0
- package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
- package/lib/module/internal/adapter/web/IntegrationRegistration.js +4 -0
- package/lib/module/internal/adapter/web/IntegrationRegistration.js.map +1 -0
- package/lib/module/internal/adapter/web/PlayerFacade.js +253 -0
- package/lib/module/internal/adapter/web/PlayerFacade.js.map +1 -0
- package/lib/module/internal/adapter/web/PlayerFacadeAPI.js +4 -0
- package/lib/module/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
- package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js +109 -0
- package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
- package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js +4 -0
- package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
- package/lib/module/internal/adapter/web/PlayerFacadeTypes.js +4 -0
- package/lib/module/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
- package/lib/module/manifest.json +1 -1
- package/lib/typescript/__tests__/PlayerFacade.test.d.ts +2 -0
- package/lib/typescript/__tests__/PlayerFacade.test.d.ts.map +1 -0
- package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts +2 -0
- package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts.map +1 -0
- package/lib/typescript/__tests__/index.test.d.ts +13 -0
- package/lib/typescript/__tests__/index.test.d.ts.map +1 -1
- package/lib/typescript/api/THEOplayerView.d.ts +4 -0
- package/lib/typescript/api/THEOplayerView.d.ts.map +1 -1
- package/lib/typescript/api/barrel.d.ts +1 -0
- package/lib/typescript/api/barrel.d.ts.map +1 -1
- package/lib/typescript/api/config/PlayerConfiguration.d.ts +15 -0
- package/lib/typescript/api/config/PlayerConfiguration.d.ts.map +1 -1
- package/lib/typescript/api/event/AdEvent.d.ts +1 -1
- package/lib/typescript/api/metrics/MetricsAPI.d.ts +21 -0
- package/lib/typescript/api/metrics/MetricsAPI.d.ts.map +1 -0
- package/lib/typescript/api/metrics/barrel.d.ts +2 -0
- package/lib/typescript/api/metrics/barrel.d.ts.map +1 -0
- package/lib/typescript/api/player/Integration.d.ts +88 -0
- package/lib/typescript/api/player/Integration.d.ts.map +1 -0
- package/lib/typescript/api/player/THEOplayer.d.ts +19 -0
- package/lib/typescript/api/player/THEOplayer.d.ts.map +1 -1
- package/lib/typescript/api/player/barrel.d.ts +1 -0
- package/lib/typescript/api/player/barrel.d.ts.map +1 -1
- package/lib/typescript/api/track/MediaTrack.d.ts +21 -4
- package/lib/typescript/api/track/MediaTrack.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts +1 -0
- package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/NativePlayerState.d.ts +1 -0
- package/lib/typescript/internal/adapter/NativePlayerState.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts +6 -1
- package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +6 -1
- package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts +7 -0
- package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts +8 -0
- package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts +53 -0
- package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts +26 -0
- package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts +33 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts +21 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts +43 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts +13 -0
- package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts.map +1 -0
- package/package.json +1 -1
- package/react-native-theoplayer.podspec +7 -7
- package/src/__tests__/PlayerFacade.test.ts +579 -0
- package/src/__tests__/PlayerFacadeWebAdapter.test.ts +193 -0
- package/src/__tests__/index.test.tsx +15 -1
- package/src/api/THEOplayerView.ts +5 -0
- package/src/api/barrel.ts +1 -0
- package/src/api/config/PlayerConfiguration.ts +16 -0
- package/src/api/event/AdEvent.ts +1 -1
- package/src/api/metrics/MetricsAPI.ts +20 -0
- package/src/api/metrics/barrel.ts +1 -0
- package/src/api/player/Integration.ts +97 -0
- package/src/api/player/THEOplayer.ts +21 -0
- package/src/api/player/barrel.ts +1 -0
- package/src/api/track/MediaTrack.ts +21 -4
- package/src/internal/THEOplayerView.tsx +2 -2
- package/src/internal/THEOplayerView.web.tsx +2 -2
- package/src/internal/adapter/DefaultNativePlayerState.ts +1 -0
- package/src/internal/adapter/NativePlayerState.ts +1 -0
- package/src/internal/adapter/THEOplayerAdapter.ts +24 -0
- package/src/internal/adapter/THEOplayerWebAdapter.ts +27 -4
- package/src/internal/adapter/WebEventForwarder.ts +5 -3
- package/src/internal/adapter/metrics/MetricsNativeAdapter.ts +12 -0
- package/src/internal/adapter/metrics/MetricsWebAdapter.ts +14 -0
- package/src/internal/adapter/web/IntegrationRegistration.ts +57 -0
- package/src/internal/adapter/web/PlayerFacade.ts +281 -0
- package/src/internal/adapter/web/PlayerFacadeAPI.ts +35 -0
- package/src/internal/adapter/web/PlayerFacadeAdsEvents.ts +119 -0
- package/src/internal/adapter/web/PlayerFacadeIntegration.ts +45 -0
- package/src/internal/adapter/web/PlayerFacadeTypes.ts +14 -0
- package/src/manifest.json +1 -1
|
@@ -9,6 +9,7 @@ import {
|
|
|
9
9
|
EventBroadcastAPI,
|
|
10
10
|
MediaControlAPI,
|
|
11
11
|
MediaTrack,
|
|
12
|
+
MetricsAPI,
|
|
12
13
|
NativeHandleType,
|
|
13
14
|
PlayerConfiguration,
|
|
14
15
|
PlayerEventMap,
|
|
@@ -39,6 +40,8 @@ import { DefaultTextTrackState } from './DefaultTextTrackState';
|
|
|
39
40
|
import { THEOAdsWebAdapter } from './theoads/THEOAdsWebAdapter';
|
|
40
41
|
import { CMCDConnector, Configuration, createCMCDConnector, TransmissionMode } from '@theoplayer/cmcd-connector-web';
|
|
41
42
|
import { TheoLiveWebAdapter } from './theolive/TheoLiveWebAdapter';
|
|
43
|
+
import { MetricsWebAdapter } from './metrics/MetricsWebAdapter';
|
|
44
|
+
import { PlayerFacade } from './web/PlayerFacade';
|
|
42
45
|
|
|
43
46
|
const defaultBackgroundAudioConfiguration: BackgroundAudioConfiguration = {
|
|
44
47
|
enabled: false,
|
|
@@ -55,6 +58,8 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
|
|
|
55
58
|
private readonly _textTrackState: TextTrackState;
|
|
56
59
|
private readonly _presentationModeManager: WebPresentationModeManager;
|
|
57
60
|
private readonly _theoliveAdapter: TheoLiveWebAdapter;
|
|
61
|
+
private readonly _metricsAdapter: MetricsWebAdapter;
|
|
62
|
+
private readonly _playerFacade: PlayerFacade | undefined;
|
|
58
63
|
private _player: NativeChromelessPlayer | undefined;
|
|
59
64
|
private _eventForwarder: WebEventForwarder | undefined;
|
|
60
65
|
private readonly _mediaSession: WebMediaSession;
|
|
@@ -68,11 +73,13 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
|
|
|
68
73
|
|
|
69
74
|
constructor(player: NativeChromelessPlayer, config?: PlayerConfiguration) {
|
|
70
75
|
super();
|
|
71
|
-
this.
|
|
76
|
+
this._playerFacade = config?.usePlayerFacade === true ? new PlayerFacade(player) : undefined;
|
|
77
|
+
this._player = this._playerFacade?.player ?? player;
|
|
72
78
|
this._adsAdapter = new THEOplayerWebAdsAdapter(this._player);
|
|
73
79
|
this._castAdapter = new THEOplayerWebCastAdapter(this._player);
|
|
74
80
|
this._theoAdsAdapter = new THEOAdsWebAdapter(this._player);
|
|
75
81
|
this._theoliveAdapter = new TheoLiveWebAdapter(this._player);
|
|
82
|
+
this._metricsAdapter = new MetricsWebAdapter(this._player);
|
|
76
83
|
this._textTrackState = new DefaultTextTrackState(this);
|
|
77
84
|
this._eventForwarder = new WebEventForwarder(this._player, this);
|
|
78
85
|
this._presentationModeManager = new WebPresentationModeManager(this._player, this);
|
|
@@ -81,13 +88,17 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
|
|
|
81
88
|
|
|
82
89
|
// Always create a media session connector so it can be toggled at runtime via mediaControl.setEnabled().
|
|
83
90
|
// The initial enabled state is derived from config.mediaControl.mediaSessionEnabled.
|
|
84
|
-
this._mediaSession = new WebMediaSession(this,
|
|
91
|
+
this._mediaSession = new WebMediaSession(this, this._player, config?.mediaControl);
|
|
85
92
|
}
|
|
86
93
|
|
|
87
94
|
get mediaControl(): MediaControlAPI {
|
|
88
95
|
return this._mediaSession.mediaControlAdapter;
|
|
89
96
|
}
|
|
90
97
|
|
|
98
|
+
get metrics(): MetricsAPI {
|
|
99
|
+
return this._metricsAdapter;
|
|
100
|
+
}
|
|
101
|
+
|
|
91
102
|
get abr(): ABRConfiguration | undefined {
|
|
92
103
|
return this._player?.abr as ABRConfiguration | undefined;
|
|
93
104
|
}
|
|
@@ -355,6 +366,14 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
|
|
|
355
366
|
// unused
|
|
356
367
|
}
|
|
357
368
|
|
|
369
|
+
get manageContentMatching(): boolean {
|
|
370
|
+
return false;
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
set manageContentMatching(_enable: boolean) {
|
|
374
|
+
// unused
|
|
375
|
+
}
|
|
376
|
+
|
|
358
377
|
get keepScreenOn(): boolean {
|
|
359
378
|
return false;
|
|
360
379
|
}
|
|
@@ -399,8 +418,12 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
|
|
|
399
418
|
this._cmcdConnector?.destroy();
|
|
400
419
|
this._cmcdConnector = undefined;
|
|
401
420
|
this._player?.removeEventListener('dimensionchange', this.onPlayerDimensionChange);
|
|
402
|
-
|
|
403
|
-
|
|
421
|
+
try {
|
|
422
|
+
this._player?.destroy();
|
|
423
|
+
} finally {
|
|
424
|
+
this._playerFacade?.close();
|
|
425
|
+
this._player = undefined;
|
|
426
|
+
}
|
|
404
427
|
}
|
|
405
428
|
|
|
406
429
|
private readonly onVisibilityChange = () => {
|
|
@@ -2,7 +2,7 @@ import type {
|
|
|
2
2
|
AdBreakEvent as NativeAdBreakEvent,
|
|
3
3
|
AddTrackEvent,
|
|
4
4
|
AdEvent as NativeAdEvent,
|
|
5
|
-
|
|
5
|
+
EventDispatcher,
|
|
6
6
|
CastStateChangeEvent,
|
|
7
7
|
ChromecastErrorEvent,
|
|
8
8
|
ChromelessPlayer,
|
|
@@ -46,6 +46,7 @@ import {
|
|
|
46
46
|
} from 'react-native-theoplayer';
|
|
47
47
|
import type { Ad } from '../../api/ads/Ad';
|
|
48
48
|
import type { AdBreak } from '../../api/ads/AdBreak';
|
|
49
|
+
import type { PlayerFacadeAdsEventMap as NativeAdsEventMap } from './web/PlayerFacadeTypes';
|
|
49
50
|
import type { THEOplayerWebAdapter } from './THEOplayerWebAdapter';
|
|
50
51
|
import { BaseEvent } from './event/BaseEvent';
|
|
51
52
|
import {
|
|
@@ -136,7 +137,7 @@ export class WebEventForwarder {
|
|
|
136
137
|
this._player.cast?.chromecast?.addEventListener('error', this.onChromecastError);
|
|
137
138
|
this._player.cast?.airplay?.addEventListener('statechange', this.onAirplayStateChange);
|
|
138
139
|
|
|
139
|
-
this._player.ads?.addEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
|
|
140
|
+
(this._player.ads as EventDispatcher<NativeAdsEventMap> | undefined)?.addEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
|
|
140
141
|
this._player.ads?.addEventListener(FORWARDED_ADBREAK_EVENTS, this.onAdBreakEvent);
|
|
141
142
|
this._player.theoads?.addEventListener(FORWARDED_THEOADS_EVENTS, this.onTheoAdsEvent);
|
|
142
143
|
this._player.theoLive?.addEventListener(FORWARDED_THEOLIVE_EVENTS, this.onTheoLiveEvent);
|
|
@@ -189,7 +190,7 @@ export class WebEventForwarder {
|
|
|
189
190
|
this._player.cast?.chromecast?.removeEventListener('error', this.onChromecastError);
|
|
190
191
|
this._player.cast?.airplay?.removeEventListener('statechange', this.onAirplayStateChange);
|
|
191
192
|
|
|
192
|
-
this._player.ads?.removeEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
|
|
193
|
+
(this._player.ads as EventDispatcher<NativeAdsEventMap> | undefined)?.removeEventListener(FORWARDED_AD_EVENTS, this.onAdEvent);
|
|
193
194
|
this._player.ads?.removeEventListener(FORWARDED_ADBREAK_EVENTS, this.onAdBreakEvent);
|
|
194
195
|
this._player.theoads?.removeEventListener(FORWARDED_THEOADS_EVENTS, this.onTheoAdsEvent);
|
|
195
196
|
this._player.theoLive?.removeEventListener(FORWARDED_THEOLIVE_EVENTS, this.onTheoLiveEvent);
|
|
@@ -491,6 +492,7 @@ const FORWARDED_AD_EVENTS = [
|
|
|
491
492
|
AdEventType.AD_THIRD_QUARTILE,
|
|
492
493
|
AdEventType.AD_SKIP,
|
|
493
494
|
AdEventType.AD_IMPRESSION,
|
|
495
|
+
AdEventType.AD_CLICKED,
|
|
494
496
|
AdEventType.AD_ERROR,
|
|
495
497
|
AdEventType.AD_METADATA,
|
|
496
498
|
AdEventType.AD_BUFFERING,
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { MetricsAPI, THEOplayerView } from 'react-native-theoplayer';
|
|
2
|
+
import { NativeModules } from 'react-native';
|
|
3
|
+
|
|
4
|
+
const NativeMetricsModule = NativeModules.THEORCTMetricsModule;
|
|
5
|
+
|
|
6
|
+
export class MetricsNativeAdapter implements MetricsAPI {
|
|
7
|
+
constructor(private readonly _view: THEOplayerView) {}
|
|
8
|
+
|
|
9
|
+
currentBandwidthEstimate(): Promise<number> {
|
|
10
|
+
return NativeMetricsModule.currentBandwidthEstimate(this._view.nativeHandle);
|
|
11
|
+
}
|
|
12
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { MetricsAPI } from 'react-native-theoplayer';
|
|
2
|
+
import type { ChromelessPlayer } from 'theoplayer';
|
|
3
|
+
|
|
4
|
+
export class MetricsWebAdapter implements MetricsAPI {
|
|
5
|
+
private readonly _player: ChromelessPlayer;
|
|
6
|
+
|
|
7
|
+
constructor(player: ChromelessPlayer) {
|
|
8
|
+
this._player = player;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
currentBandwidthEstimate(): Promise<number> {
|
|
12
|
+
return Promise.resolve(this._player.metrics?.currentBandwidthEstimate ?? 0);
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import type { PlayerEventMap } from 'theoplayer';
|
|
2
|
+
import type { PlayerFacadeEvent } from './PlayerFacadeTypes';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Controls event delivery and the lifetime of a registered Web integration.
|
|
6
|
+
*
|
|
7
|
+
* @category Player
|
|
8
|
+
* @platform web
|
|
9
|
+
* @internal
|
|
10
|
+
*/
|
|
11
|
+
export interface IntegrationRegistration {
|
|
12
|
+
/**
|
|
13
|
+
* Compatibility entry point for player events; equivalent to dispatchEvent(event).
|
|
14
|
+
*
|
|
15
|
+
* @param event - The player event to deliver to facade listeners.
|
|
16
|
+
*/
|
|
17
|
+
dispatchPlayerEvent<TEvent extends PlayerEventMap[keyof PlayerEventMap]>(event: TEvent): void;
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* Routes typed THEOplayer events to player or player.ads listeners without emitting on the content player.
|
|
21
|
+
* Bypasses backing-event interceptors and ignores calls after the registration closes.
|
|
22
|
+
*
|
|
23
|
+
* @param event - The player or advertising event to deliver. Advertising events go only to Ads listeners.
|
|
24
|
+
*/
|
|
25
|
+
dispatchEvent<TEvent extends PlayerFacadeEvent>(event: TEvent): void;
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Return true to consume a backing-player event before facade listeners receive it.
|
|
29
|
+
* Dispose explicitly: interceptors survive unregistering to allow already-queued events to drain.
|
|
30
|
+
*
|
|
31
|
+
* @param type - The event type to intercept, even when it has no facade listeners.
|
|
32
|
+
* @param interceptor - Called once per event; return `false` to continue delivery.
|
|
33
|
+
* @returns An idempotent disposer. Closed registrations return a no-op disposer.
|
|
34
|
+
*/
|
|
35
|
+
interceptPlayerEvent<TType extends keyof PlayerEventMap>(type: TType, interceptor: (event: PlayerEventMap[TType]) => boolean): () => void;
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Filters every subscribed backing-player event after type-specific interceptors, including future subscriptions.
|
|
39
|
+
* Uses the same explicit disposer lifetime; integration dispatch bypasses this filter.
|
|
40
|
+
*
|
|
41
|
+
* @param interceptor - Return `true` to consume the event, or `false` to continue delivery.
|
|
42
|
+
* @returns An idempotent disposer. Closed registrations return a no-op disposer.
|
|
43
|
+
*
|
|
44
|
+
* @remarks
|
|
45
|
+
* This does not subscribe to otherwise unobserved event types. Consuming a native destroy event does not prevent facade cleanup.
|
|
46
|
+
*/
|
|
47
|
+
interceptPlayerEvents(interceptor: (event: PlayerEventMap[keyof PlayerEventMap]) => boolean): () => void;
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Restores content-player delegation without destroying the content player.
|
|
51
|
+
*
|
|
52
|
+
* @remarks
|
|
53
|
+
* Idempotent. Stops integration dispatch and restores native Ads subscriptions.
|
|
54
|
+
* Existing player-event interceptors remain until explicitly disposed or the facade closes.
|
|
55
|
+
*/
|
|
56
|
+
close(): void;
|
|
57
|
+
}
|
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
import type { ChromelessPlayer, EventListener, PlayerEventMap } from 'theoplayer';
|
|
2
|
+
import { PlayerFacadeAdsEvents } from './PlayerFacadeAdsEvents';
|
|
3
|
+
import type { IntegrationRegistration, PlayerFacade as PlayerFacadeAPI, PlayerFacadeEvent, PlayerFacadeIntegration } from './PlayerFacadeTypes';
|
|
4
|
+
|
|
5
|
+
type Registration = IntegrationRegistration & { integration?: PlayerFacadeIntegration };
|
|
6
|
+
type PlayerEvent = PlayerEventMap[keyof PlayerEventMap];
|
|
7
|
+
type PlayerEventSubscription = {
|
|
8
|
+
listeners: Set<EventListener<PlayerEvent>>;
|
|
9
|
+
interceptors: Set<(event: PlayerEvent) => boolean>;
|
|
10
|
+
forward: EventListener<PlayerEvent>;
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
// Resolve the current backing object on every access while preserving its method receiver and identity.
|
|
14
|
+
function delegate<T extends object, TOverrides extends object>(backing: () => T, overrides: TOverrides): T & TOverrides {
|
|
15
|
+
const methods = new Map<PropertyKey, { original: unknown; receiver: object; bound: unknown }>();
|
|
16
|
+
return new Proxy(Object.create(Object.getPrototypeOf(backing())) as T & TOverrides, {
|
|
17
|
+
get: (_target, property) => {
|
|
18
|
+
const receiver = Object.prototype.hasOwnProperty.call(overrides, property) ? overrides : backing();
|
|
19
|
+
const value: unknown = Reflect.get(receiver, property, receiver);
|
|
20
|
+
if (typeof value !== 'function' || property === 'constructor') return value;
|
|
21
|
+
const cached = methods.get(property);
|
|
22
|
+
if (cached?.original !== value || cached.receiver !== receiver)
|
|
23
|
+
methods.set(property, { original: value, receiver, bound: value.bind(receiver) });
|
|
24
|
+
return methods.get(property)!.bound;
|
|
25
|
+
},
|
|
26
|
+
set: (_target, property, value) => {
|
|
27
|
+
const receiver = Reflect.getOwnPropertyDescriptor(overrides, property)?.set ? overrides : backing();
|
|
28
|
+
return Reflect.set(receiver, property, value, receiver);
|
|
29
|
+
},
|
|
30
|
+
has: (_target, property) => property in overrides || property in backing(),
|
|
31
|
+
ownKeys: () => [...new Set([...Reflect.ownKeys(backing()), ...Reflect.ownKeys(overrides)])],
|
|
32
|
+
getOwnPropertyDescriptor: (_target, property) => {
|
|
33
|
+
const descriptor = Reflect.getOwnPropertyDescriptor(overrides, property) ?? Reflect.getOwnPropertyDescriptor(backing(), property);
|
|
34
|
+
return descriptor && { ...descriptor, configurable: true };
|
|
35
|
+
},
|
|
36
|
+
preventExtensions: () => false,
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Stable player surface with generic integration hooks; no playback or ad-lifecycle policy lives here.
|
|
42
|
+
*
|
|
43
|
+
* @internal
|
|
44
|
+
*/
|
|
45
|
+
export class PlayerFacade {
|
|
46
|
+
readonly player: PlayerFacadeAPI;
|
|
47
|
+
private readonly nativeAds: PlayerFacadeAPI['ads'] | undefined;
|
|
48
|
+
private readonly adsEvents: PlayerFacadeAdsEvents;
|
|
49
|
+
private readonly playerSubscriptions = new Map<keyof PlayerEventMap, PlayerEventSubscription>();
|
|
50
|
+
private readonly playerInterceptors = new Set<(event: PlayerEvent) => boolean>();
|
|
51
|
+
private registration?: Registration;
|
|
52
|
+
private closed = false;
|
|
53
|
+
|
|
54
|
+
constructor(readonly contentPlayer: ChromelessPlayer) {
|
|
55
|
+
this.nativeAds = contentPlayer.ads as PlayerFacadeAPI['ads'];
|
|
56
|
+
this.adsEvents = new PlayerFacadeAdsEvents(this.nativeAds, () => this.registration?.integration);
|
|
57
|
+
const readAdState = () => this.registration?.integration?.ads ?? this.registration?.integration?.getAdState?.();
|
|
58
|
+
const readPlaying = () => readAdState()?.playing ?? this.nativeAds?.playing ?? false;
|
|
59
|
+
const readAds = () => readAdState()?.currentAds ?? this.nativeAds?.currentAds ?? [];
|
|
60
|
+
const readBreak = () => {
|
|
61
|
+
const state = readAdState();
|
|
62
|
+
return state ? state.currentAdBreak : this.nativeAds?.currentAdBreak;
|
|
63
|
+
};
|
|
64
|
+
const readTime = () => {
|
|
65
|
+
const value = this.registration?.integration?.getCurrentTime?.();
|
|
66
|
+
return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : contentPlayer.currentTime;
|
|
67
|
+
};
|
|
68
|
+
const writeTime = (value: number) => {
|
|
69
|
+
if (this.registration?.integration?.setCurrentTime?.(value) !== true) contentPlayer.currentTime = value;
|
|
70
|
+
};
|
|
71
|
+
const readPaused = () => this.registration?.integration?.isPaused?.() ?? contentPlayer.paused;
|
|
72
|
+
const readSeeking = () => this.registration?.integration?.isSeeking?.() ?? contentPlayer.seeking;
|
|
73
|
+
const readDuration = () => this.registration?.integration?.getDuration?.() ?? contentPlayer.duration;
|
|
74
|
+
const emptyAds = {} as PlayerFacadeAPI['ads'];
|
|
75
|
+
// Consumers may retain player.ads before registration; only its backing source should change.
|
|
76
|
+
const ads = delegate(() => this.registration?.integration?.ads ?? this.nativeAds ?? emptyAds, {
|
|
77
|
+
get playing() {
|
|
78
|
+
return readPlaying();
|
|
79
|
+
},
|
|
80
|
+
get currentAds() {
|
|
81
|
+
return readAds();
|
|
82
|
+
},
|
|
83
|
+
get currentAdBreak() {
|
|
84
|
+
return readBreak();
|
|
85
|
+
},
|
|
86
|
+
addEventListener: this.adsEvents.addEventListener,
|
|
87
|
+
removeEventListener: this.adsEvents.removeEventListener,
|
|
88
|
+
});
|
|
89
|
+
const readMuted = () => this.registration?.integration?.getMuted?.() ?? contentPlayer.muted;
|
|
90
|
+
const writeMuted = (value: boolean) => {
|
|
91
|
+
if (this.registration?.integration?.setMuted?.(value) !== true) contentPlayer.muted = value;
|
|
92
|
+
};
|
|
93
|
+
const readVolume = () => this.registration?.integration?.getVolume?.() ?? contentPlayer.volume;
|
|
94
|
+
const writeVolume = (value: number) => {
|
|
95
|
+
if (this.registration?.integration?.setVolume?.(value) !== true) contentPlayer.volume = value;
|
|
96
|
+
};
|
|
97
|
+
this.player = delegate(() => contentPlayer, {
|
|
98
|
+
get muted() {
|
|
99
|
+
return readMuted();
|
|
100
|
+
},
|
|
101
|
+
set muted(value: boolean) {
|
|
102
|
+
writeMuted(value);
|
|
103
|
+
},
|
|
104
|
+
get volume() {
|
|
105
|
+
return readVolume();
|
|
106
|
+
},
|
|
107
|
+
set volume(value: number) {
|
|
108
|
+
writeVolume(value);
|
|
109
|
+
},
|
|
110
|
+
ads,
|
|
111
|
+
contentPlayer,
|
|
112
|
+
registerIntegration: this.registerIntegration.bind(this),
|
|
113
|
+
addEventListener: this.addPlayerEventListener,
|
|
114
|
+
removeEventListener: this.removePlayerEventListener,
|
|
115
|
+
get currentTime() {
|
|
116
|
+
return readTime();
|
|
117
|
+
},
|
|
118
|
+
set currentTime(value: number) {
|
|
119
|
+
writeTime(value);
|
|
120
|
+
},
|
|
121
|
+
get paused() {
|
|
122
|
+
return readPaused();
|
|
123
|
+
},
|
|
124
|
+
get seeking() {
|
|
125
|
+
return readSeeking();
|
|
126
|
+
},
|
|
127
|
+
get duration() {
|
|
128
|
+
return readDuration();
|
|
129
|
+
},
|
|
130
|
+
play: () => {
|
|
131
|
+
if (this.registration?.integration?.play?.() !== true) contentPlayer.play();
|
|
132
|
+
},
|
|
133
|
+
pause: () => {
|
|
134
|
+
if (this.registration?.integration?.pause?.() !== true) contentPlayer.pause();
|
|
135
|
+
},
|
|
136
|
+
});
|
|
137
|
+
this.getPlayerSubscription('destroy');
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
registerIntegration(integration: PlayerFacadeIntegration): IntegrationRegistration {
|
|
141
|
+
if (this.closed) throw new Error('The player facade has been closed.');
|
|
142
|
+
if (this.registration) throw new Error('Unregister the previous integration first.');
|
|
143
|
+
if (!integration || typeof integration !== 'object') throw new Error('An integration must be an object implementing Integration.');
|
|
144
|
+
for (const method of [
|
|
145
|
+
'getCurrentTime',
|
|
146
|
+
'setCurrentTime',
|
|
147
|
+
'play',
|
|
148
|
+
'pause',
|
|
149
|
+
'isPaused',
|
|
150
|
+
'isSeeking',
|
|
151
|
+
'getDuration',
|
|
152
|
+
'getMuted',
|
|
153
|
+
'setMuted',
|
|
154
|
+
'getVolume',
|
|
155
|
+
'setVolume',
|
|
156
|
+
'getAdState',
|
|
157
|
+
'shouldConsumeAdEvent',
|
|
158
|
+
] as const) {
|
|
159
|
+
if (integration[method] !== undefined && typeof integration[method] !== 'function') {
|
|
160
|
+
throw new Error(`Integration.${method} must be a function.`);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
const registration: Registration = {
|
|
164
|
+
integration,
|
|
165
|
+
dispatchPlayerEvent: (event) => this.dispatchEvent(registration, event),
|
|
166
|
+
dispatchEvent: (event) => this.dispatchEvent(registration, event),
|
|
167
|
+
interceptPlayerEvent: (type, callback) => {
|
|
168
|
+
if (this.closed || this.registration !== registration) return () => undefined;
|
|
169
|
+
const subscription = this.getPlayerSubscription(type);
|
|
170
|
+
const interceptor = callback as (event: PlayerEvent) => boolean;
|
|
171
|
+
subscription.interceptors.add(interceptor);
|
|
172
|
+
return () => {
|
|
173
|
+
subscription.interceptors.delete(interceptor);
|
|
174
|
+
this.releasePlayerSubscription(type, subscription);
|
|
175
|
+
};
|
|
176
|
+
},
|
|
177
|
+
interceptPlayerEvents: (interceptor) => {
|
|
178
|
+
if (this.closed || this.registration !== registration) return () => undefined;
|
|
179
|
+
this.playerInterceptors.add(interceptor);
|
|
180
|
+
return () => {
|
|
181
|
+
this.playerInterceptors.delete(interceptor);
|
|
182
|
+
};
|
|
183
|
+
},
|
|
184
|
+
close: () => {
|
|
185
|
+
registration.integration = undefined;
|
|
186
|
+
if (this.registration !== registration) return;
|
|
187
|
+
this.registration = undefined;
|
|
188
|
+
// Interceptors have explicit disposers so queued backing events can drain after unregistering.
|
|
189
|
+
if (!this.closed) this.adsEvents.rebind();
|
|
190
|
+
},
|
|
191
|
+
};
|
|
192
|
+
this.registration = registration;
|
|
193
|
+
try {
|
|
194
|
+
this.adsEvents.rebind();
|
|
195
|
+
} catch (error) {
|
|
196
|
+
registration.close();
|
|
197
|
+
throw error;
|
|
198
|
+
}
|
|
199
|
+
return registration;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
private getPlayerSubscription(type: keyof PlayerEventMap): PlayerEventSubscription {
|
|
203
|
+
const existing = this.playerSubscriptions.get(type);
|
|
204
|
+
if (existing) return existing;
|
|
205
|
+
// One backing listener per type lets interceptors decide once for all facade consumers.
|
|
206
|
+
const subscription: PlayerEventSubscription = {
|
|
207
|
+
listeners: new Set(),
|
|
208
|
+
interceptors: new Set(),
|
|
209
|
+
forward: (event) => {
|
|
210
|
+
try {
|
|
211
|
+
for (const interceptor of [...subscription.interceptors]) {
|
|
212
|
+
if (subscription.interceptors.has(interceptor) && interceptor(event)) return;
|
|
213
|
+
}
|
|
214
|
+
for (const interceptor of [...this.playerInterceptors]) {
|
|
215
|
+
if (this.playerInterceptors.has(interceptor) && interceptor(event)) return;
|
|
216
|
+
}
|
|
217
|
+
for (const listener of [...subscription.listeners]) {
|
|
218
|
+
if (subscription.listeners.has(listener)) listener(event);
|
|
219
|
+
}
|
|
220
|
+
} finally {
|
|
221
|
+
if (type === 'destroy') this.close();
|
|
222
|
+
}
|
|
223
|
+
},
|
|
224
|
+
};
|
|
225
|
+
this.playerSubscriptions.set(type, subscription);
|
|
226
|
+
this.contentPlayer.addEventListener(type, subscription.forward);
|
|
227
|
+
return subscription;
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
private releasePlayerSubscription(type: keyof PlayerEventMap, subscription: PlayerEventSubscription): void {
|
|
231
|
+
if (type === 'destroy' || subscription.listeners.size || subscription.interceptors.size || this.playerSubscriptions.get(type) !== subscription)
|
|
232
|
+
return;
|
|
233
|
+
this.contentPlayer.removeEventListener(type, subscription.forward);
|
|
234
|
+
this.playerSubscriptions.delete(type);
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
private readonly addPlayerEventListener: ChromelessPlayer['addEventListener'] = (types, listener) => {
|
|
238
|
+
if (this.closed) throw new Error('The player facade has been closed.');
|
|
239
|
+
for (const type of typeof types === 'string' ? [types] : types) {
|
|
240
|
+
this.getPlayerSubscription(type).listeners.add(listener as EventListener<PlayerEvent>);
|
|
241
|
+
}
|
|
242
|
+
};
|
|
243
|
+
|
|
244
|
+
private readonly removePlayerEventListener: ChromelessPlayer['removeEventListener'] = (types, listener) => {
|
|
245
|
+
for (const type of typeof types === 'string' ? [types] : types) {
|
|
246
|
+
const subscription = this.playerSubscriptions.get(type);
|
|
247
|
+
if (!subscription) continue;
|
|
248
|
+
subscription.listeners.delete(listener as EventListener<PlayerEvent>);
|
|
249
|
+
this.releasePlayerSubscription(type, subscription);
|
|
250
|
+
}
|
|
251
|
+
};
|
|
252
|
+
|
|
253
|
+
private dispatchEvent(registration: Registration, event: PlayerFacadeEvent): void {
|
|
254
|
+
const isCurrentRegistration = () => !this.closed && this.registration === registration;
|
|
255
|
+
if (!isCurrentRegistration()) return;
|
|
256
|
+
if (!event || typeof event.type !== 'string') throw new Error('A THEOplayer event with a type is required.');
|
|
257
|
+
if (PlayerFacadeAdsEvents.isAdEvent(event)) {
|
|
258
|
+
this.adsEvents.dispatch(event, isCurrentRegistration);
|
|
259
|
+
return;
|
|
260
|
+
}
|
|
261
|
+
// Integration events already represent public playback state; backing-player filters must not consume them.
|
|
262
|
+
const listeners = this.playerSubscriptions.get(event.type)?.listeners;
|
|
263
|
+
for (const listener of [...(listeners ?? [])]) {
|
|
264
|
+
if (isCurrentRegistration() && listeners?.has(listener)) listener(event);
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
close = (): void => {
|
|
269
|
+
if (this.closed) return;
|
|
270
|
+
this.closed = true;
|
|
271
|
+
this.registration?.close();
|
|
272
|
+
this.playerInterceptors.clear();
|
|
273
|
+
for (const [type, subscription] of this.playerSubscriptions) {
|
|
274
|
+
subscription.listeners.clear();
|
|
275
|
+
subscription.interceptors.clear();
|
|
276
|
+
this.contentPlayer.removeEventListener(type, subscription.forward);
|
|
277
|
+
}
|
|
278
|
+
this.playerSubscriptions.clear();
|
|
279
|
+
this.adsEvents.close();
|
|
280
|
+
};
|
|
281
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { Ads, ChromelessPlayer, EventDispatcher } from 'theoplayer';
|
|
2
|
+
import type { IntegrationRegistration } from './IntegrationRegistration';
|
|
3
|
+
import type { PlayerFacadeIntegration } from './PlayerFacadeIntegration';
|
|
4
|
+
import type { PlayerFacadeAdsEventMap } from './PlayerFacadeTypes';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Describes the stable native Web player handle when the player facade is enabled.
|
|
8
|
+
*
|
|
9
|
+
* @category Player
|
|
10
|
+
* @platform web
|
|
11
|
+
* @internal
|
|
12
|
+
*/
|
|
13
|
+
export interface PlayerFacadeAPI extends ChromelessPlayer {
|
|
14
|
+
/**
|
|
15
|
+
* The stable advertising API, including integration-generated `adclicked` events.
|
|
16
|
+
* Delegates to the registered integration's Ads API or the content player's Ads API.
|
|
17
|
+
*/
|
|
18
|
+
readonly ads: Ads & EventDispatcher<PlayerFacadeAdsEventMap>;
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Raw playback engine, unaffected by integration overrides or event interception.
|
|
22
|
+
* Use this player for playback engines and ad schedulers that require the content timeline.
|
|
23
|
+
*/
|
|
24
|
+
readonly contentPlayer: ChromelessPlayer;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Registers an integration that optionally overrides playback and advertising behavior.
|
|
28
|
+
* Only one integration may be registered at a time.
|
|
29
|
+
*
|
|
30
|
+
* @param integration - The hooks and optional Ads API to use until the registration closes.
|
|
31
|
+
* @returns The registration used to dispatch events, install interceptors, and unregister.
|
|
32
|
+
* @throws If the facade is closed, an integration is already registered, or a hook is not a function.
|
|
33
|
+
*/
|
|
34
|
+
registerIntegration(integration: PlayerFacadeIntegration): IntegrationRegistration;
|
|
35
|
+
}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
import type { EventListener } from 'theoplayer';
|
|
2
|
+
import type { PlayerFacadeAds, PlayerFacadeAdsEventMap as AdsEventMap, PlayerFacadeEvent, PlayerFacadeIntegration } from './PlayerFacadeTypes';
|
|
3
|
+
|
|
4
|
+
type AdEventType = keyof AdsEventMap;
|
|
5
|
+
type AdEvent = AdsEventMap[AdEventType];
|
|
6
|
+
type Listener = EventListener<AdEvent>;
|
|
7
|
+
type Subscription = { listeners: Set<Listener>; remove: () => void };
|
|
8
|
+
|
|
9
|
+
// This table selects the Ads event surface; it does not restrict player event dispatch.
|
|
10
|
+
const AD_EVENTS: Record<AdEventType, true> = {
|
|
11
|
+
addadbreak: true,
|
|
12
|
+
removeadbreak: true,
|
|
13
|
+
adbreakbegin: true,
|
|
14
|
+
adbreakend: true,
|
|
15
|
+
adbreakchange: true,
|
|
16
|
+
addad: true,
|
|
17
|
+
updatead: true,
|
|
18
|
+
updateadbreak: true,
|
|
19
|
+
adloaded: true,
|
|
20
|
+
adbegin: true,
|
|
21
|
+
adend: true,
|
|
22
|
+
adskip: true,
|
|
23
|
+
aderror: true,
|
|
24
|
+
adimpression: true,
|
|
25
|
+
adclicked: true,
|
|
26
|
+
adfirstquartile: true,
|
|
27
|
+
admidpoint: true,
|
|
28
|
+
adthirdquartile: true,
|
|
29
|
+
adbuffering: true,
|
|
30
|
+
admetadata: true,
|
|
31
|
+
adsmanagerloaded: true,
|
|
32
|
+
};
|
|
33
|
+
|
|
34
|
+
/** Keeps public Ads listeners stable while their backing event source changes. */
|
|
35
|
+
export class PlayerFacadeAdsEvents {
|
|
36
|
+
private readonly subscriptions = new Map<AdEventType, Subscription>();
|
|
37
|
+
private closed = false;
|
|
38
|
+
|
|
39
|
+
constructor(
|
|
40
|
+
private readonly nativeAds: PlayerFacadeAds | undefined,
|
|
41
|
+
private readonly getIntegration: () => PlayerFacadeIntegration | undefined,
|
|
42
|
+
) {}
|
|
43
|
+
|
|
44
|
+
static isAdEvent(event: PlayerFacadeEvent): event is AdEvent {
|
|
45
|
+
return Object.prototype.hasOwnProperty.call(AD_EVENTS, event.type);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
readonly addEventListener = <TType extends AdEventType>(types: TType | readonly TType[], listener: EventListener<AdsEventMap[TType]>): void => {
|
|
49
|
+
if (this.closed) throw new Error('The player facade has been closed.');
|
|
50
|
+
for (const type of typeof types === 'string' ? [types] : types) {
|
|
51
|
+
let subscription = this.subscriptions.get(type);
|
|
52
|
+
if (!subscription) {
|
|
53
|
+
subscription = { listeners: new Set(), remove: () => undefined };
|
|
54
|
+
subscription.remove = this.bindListener(type, subscription);
|
|
55
|
+
this.subscriptions.set(type, subscription);
|
|
56
|
+
}
|
|
57
|
+
subscription.listeners.add(listener as Listener);
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
readonly removeEventListener = <TType extends AdEventType>(types: TType | readonly TType[], listener: EventListener<AdsEventMap[TType]>): void => {
|
|
62
|
+
for (const type of typeof types === 'string' ? [types] : types) {
|
|
63
|
+
const subscription = this.subscriptions.get(type);
|
|
64
|
+
if (!subscription) continue;
|
|
65
|
+
subscription.listeners.delete(listener as Listener);
|
|
66
|
+
if (!subscription.listeners.size) {
|
|
67
|
+
subscription.remove();
|
|
68
|
+
this.subscriptions.delete(type);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
private bindListener(type: AdEventType, subscription: Subscription): () => void {
|
|
74
|
+
const integration = this.getIntegration();
|
|
75
|
+
const ads = integration?.ads ?? this.nativeAds;
|
|
76
|
+
let attached = true;
|
|
77
|
+
const isCurrentSource = () => attached && this.getIntegration() === integration && this.subscriptions.get(type) === subscription;
|
|
78
|
+
const forward: Listener = (event) => {
|
|
79
|
+
// A detached source may still deliver an event queued before the integration changed.
|
|
80
|
+
if (!isCurrentSource() || this.closed) return;
|
|
81
|
+
if (ads === this.nativeAds && integration?.shouldConsumeAdEvent?.(event) === true) return;
|
|
82
|
+
this.dispatch(event, isCurrentSource);
|
|
83
|
+
};
|
|
84
|
+
try {
|
|
85
|
+
ads?.addEventListener(type, forward);
|
|
86
|
+
} catch (error) {
|
|
87
|
+
attached = false;
|
|
88
|
+
ads?.removeEventListener(type, forward);
|
|
89
|
+
throw error;
|
|
90
|
+
}
|
|
91
|
+
return () => {
|
|
92
|
+
attached = false;
|
|
93
|
+
ads?.removeEventListener(type, forward);
|
|
94
|
+
};
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
rebind(): void {
|
|
98
|
+
for (const [type, subscription] of this.subscriptions) {
|
|
99
|
+
subscription.remove();
|
|
100
|
+
subscription.remove = this.bindListener(type, subscription);
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
dispatch(event: AdEvent, isCurrentRegistration: () => boolean): void {
|
|
105
|
+
const listeners = this.subscriptions.get(event.type)?.listeners;
|
|
106
|
+
for (const listener of [...(listeners ?? [])]) {
|
|
107
|
+
// Listeners can remove each other or unregister the integration during delivery.
|
|
108
|
+
if (!this.closed && isCurrentRegistration() && listeners?.has(listener)) listener(event);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
close(): void {
|
|
113
|
+
if (this.closed) return;
|
|
114
|
+
this.closed = true;
|
|
115
|
+
const subscriptions = [...this.subscriptions.values()];
|
|
116
|
+
this.subscriptions.clear();
|
|
117
|
+
for (const subscription of subscriptions) subscription.remove();
|
|
118
|
+
}
|
|
119
|
+
}
|