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.
- package/CHANGELOG.md +32 -1
- package/README.md +70 -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 +11 -2
- package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +95 -93
- package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +6 -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/media/MediaControlModule.kt +102 -0
- package/android/src/main/java/com/theoplayer/media/MediaControlProxy.kt +376 -0
- package/android/src/main/java/com/theoplayer/media/MediaNotificationBuilder.kt +78 -34
- package/android/src/main/java/com/theoplayer/media/MediaPlaybackService.kt +53 -20
- package/android/src/main/java/com/theoplayer/media/MediaSessionConfig.kt +6 -6
- package/android/src/main/java/com/theoplayer/media/MediaSessionConfigAdapter.kt +23 -20
- package/android/src/main/java/com/theoplayer/metrics/MetricsModule.kt +37 -0
- package/android/src/main/java/com/theoplayer/player/PlayerModule.kt +0 -1
- package/android/src/main/java/com/theoplayer/presentation/PipUtils.kt +98 -93
- package/android/src/main/java/com/theoplayer/theoads/THEOadsModule.kt +1 -1
- package/android/src/main/java/com/theoplayer/util/ReadableExtension.kt +14 -0
- package/android/src/main/res/drawable/ic_next.xml +9 -0
- package/android/src/main/res/drawable/ic_prev.xml +9 -0
- package/android/src/main/res/values/strings.xml +4 -0
- 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 +35 -0
- package/ios/THEOplayerRCTDebug.swift +3 -0
- package/ios/THEOplayerRCTMainEventHandler.swift +17 -0
- package/ios/THEOplayerRCTPlayerAPI.swift +31 -0
- package/ios/THEOplayerRCTTypeUtils.swift +30 -0
- package/ios/THEOplayerRCTView.swift +15 -5
- package/ios/Theoplayer-Bridging-Header.h +0 -1
- package/ios/backgroundAudio/THEOplayerRCTBackgroundAudioManager.swift +1 -1
- package/ios/backgroundAudio/THEOplayerRCTNowPlayingManager.swift +49 -3
- package/ios/backgroundAudio/THEOplayerRCTRemoteCommandsManager.swift +151 -68
- package/ios/backgroundAudio/THEOplayerRCTView+MediaControlConfig.swift +25 -11
- package/ios/mediaControl/THEOplayerRCTMediaControlAPI.swift +79 -0
- package/ios/mediaControl/THEOplayerRCTMediaControlManager.swift +38 -0
- package/ios/metrics/THEOplayerRCTMetricsAPI.swift +31 -0
- package/ios/pip/THEOplayerRCTPipControlsManager.swift +9 -12
- package/lib/commonjs/api/barrel.js +31 -20
- package/lib/commonjs/api/barrel.js.map +1 -1
- package/lib/commonjs/api/event/PlayerEvent.js +8 -0
- package/lib/commonjs/api/event/PlayerEvent.js.map +1 -1
- package/lib/commonjs/api/media/MediaControlAPI.js +14 -0
- package/lib/commonjs/api/media/MediaControlAPI.js.map +1 -0
- package/lib/commonjs/api/media/barrel.js +11 -0
- package/lib/commonjs/api/media/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/PlayerEventMap.js +1 -0
- package/lib/commonjs/api/player/PlayerEventMap.js.map +1 -1
- 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 +6 -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 +24 -0
- package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
- package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +29 -12
- package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
- package/lib/commonjs/internal/adapter/WebEventForwarder.js +6 -1
- package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
- package/lib/commonjs/internal/adapter/event/PlayerEvents.js +7 -1
- package/lib/commonjs/internal/adapter/event/PlayerEvents.js.map +1 -1
- package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js +42 -0
- package/lib/commonjs/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
- package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js +32 -0
- package/lib/commonjs/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
- 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/internal/adapter/web/WebMediaSession.js +78 -16
- package/lib/commonjs/internal/adapter/web/WebMediaSession.js.map +1 -1
- 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/event/PlayerEvent.js +9 -0
- package/lib/module/api/event/PlayerEvent.js.map +1 -1
- package/lib/module/api/media/MediaControlAPI.js +10 -0
- package/lib/module/api/media/MediaControlAPI.js.map +1 -0
- package/lib/module/api/media/barrel.js +1 -0
- package/lib/module/api/media/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/PlayerEventMap.js +1 -0
- package/lib/module/api/player/PlayerEventMap.js.map +1 -1
- 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 +7 -1
- 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 +24 -0
- package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
- package/lib/module/internal/adapter/THEOplayerWebAdapter.js +29 -12
- package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
- package/lib/module/internal/adapter/WebEventForwarder.js +7 -2
- package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
- package/lib/module/internal/adapter/event/PlayerEvents.js +5 -0
- package/lib/module/internal/adapter/event/PlayerEvents.js.map +1 -1
- package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js +37 -0
- package/lib/module/internal/adapter/media/MediaControlNativeAdapter.js.map +1 -0
- package/lib/module/internal/adapter/media/MediaControlWebAdapter.js +27 -0
- package/lib/module/internal/adapter/media/MediaControlWebAdapter.js.map +1 -0
- 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/internal/adapter/web/WebMediaSession.js +78 -16
- package/lib/module/internal/adapter/web/WebMediaSession.js.map +1 -1
- 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/event/PlayerEvent.d.ts +9 -0
- package/lib/typescript/api/event/PlayerEvent.d.ts.map +1 -1
- package/lib/typescript/api/media/MediaControlAPI.d.ts +30 -0
- package/lib/typescript/api/media/MediaControlAPI.d.ts.map +1 -0
- package/lib/typescript/api/media/MediaControlConfiguration.d.ts +5 -1
- package/lib/typescript/api/media/MediaControlConfiguration.d.ts.map +1 -1
- package/lib/typescript/api/media/barrel.d.ts +1 -0
- package/lib/typescript/api/media/barrel.d.ts.map +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/PlayerEventMap.d.ts +7 -2
- package/lib/typescript/api/player/PlayerEventMap.d.ts.map +1 -1
- package/lib/typescript/api/player/THEOplayer.d.ts +24 -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/THEOplayerView.d.ts +1 -0
- package/lib/typescript/internal/THEOplayerView.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 +8 -1
- package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +8 -2
- package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/WebEventForwarder.d.ts +1 -0
- package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts +4 -1
- package/lib/typescript/internal/adapter/event/PlayerEvents.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts +1 -0
- package/lib/typescript/internal/adapter/event/native/NativePlayerEvent.d.ts.map +1 -1
- package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts +12 -0
- package/lib/typescript/internal/adapter/media/MediaControlNativeAdapter.d.ts.map +1 -0
- package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts +14 -0
- package/lib/typescript/internal/adapter/media/MediaControlWebAdapter.d.ts.map +1 -0
- 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/lib/typescript/internal/adapter/web/WebMediaSession.d.ts +10 -3
- package/lib/typescript/internal/adapter/web/WebMediaSession.d.ts.map +1 -1
- package/package.json +3 -3
- 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/event/PlayerEvent.ts +10 -0
- package/src/api/media/MediaControlAPI.ts +33 -0
- package/src/api/media/MediaControlConfiguration.ts +5 -1
- package/src/api/media/barrel.ts +1 -0
- 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/PlayerEventMap.ts +7 -0
- package/src/api/player/THEOplayer.ts +27 -0
- package/src/api/player/barrel.ts +1 -0
- package/src/api/track/MediaTrack.ts +21 -4
- package/src/internal/THEOplayerView.tsx +10 -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 +33 -0
- package/src/internal/adapter/THEOplayerWebAdapter.ts +38 -12
- package/src/internal/adapter/WebEventForwarder.ts +12 -3
- package/src/internal/adapter/event/PlayerEvents.ts +10 -0
- package/src/internal/adapter/event/native/NativePlayerEvent.ts +2 -0
- package/src/internal/adapter/media/MediaControlNativeAdapter.ts +38 -0
- package/src/internal/adapter/media/MediaControlWebAdapter.ts +28 -0
- 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/internal/adapter/web/WebMediaSession.ts +85 -21
- package/src/manifest.json +1 -1
- package/android/src/main/java/com/theoplayer/media/MediaQueueNavigator.kt +0 -33
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { Ads } from 'theoplayer';
|
|
2
|
+
import type { Integration } from '../../../api/player/Integration';
|
|
3
|
+
import type { PlayerFacadeAds, PlayerFacadeAdsEventMap } from './PlayerFacadeTypes';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Describes Web-specific advertising overrides for a player facade integration.
|
|
7
|
+
* Optional overrides leave playback ownership and synchronization policy with the integration.
|
|
8
|
+
*
|
|
9
|
+
* @category Player
|
|
10
|
+
* @platform web
|
|
11
|
+
* @internal
|
|
12
|
+
*/
|
|
13
|
+
export interface PlayerFacadeIntegration extends Integration {
|
|
14
|
+
/**
|
|
15
|
+
* Supplies the Ads API and event source behind the stable public `player.ads` object.
|
|
16
|
+
*
|
|
17
|
+
* @remarks
|
|
18
|
+
* Keep this object stable until the registration closes. Existing listeners migrate on registration and close.
|
|
19
|
+
* Omit it to retain the content player's Ads API and optionally override only its state through {@link getAdState}.
|
|
20
|
+
*/
|
|
21
|
+
readonly ads?: PlayerFacadeAds;
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Returns the advertising state for integrations that do not supply an Ads object.
|
|
25
|
+
*
|
|
26
|
+
* @remarks
|
|
27
|
+
* Legacy state override for integrations that do not supply an Ads object.
|
|
28
|
+
* The facade never derives state from dispatched events. Update state before dispatching corresponding events.
|
|
29
|
+
* An explicitly absent current ad break does not fall back to the content player's ad break.
|
|
30
|
+
*
|
|
31
|
+
* @returns The integration's ad state. Ignored when {@link ads} is supplied.
|
|
32
|
+
*/
|
|
33
|
+
getAdState?(): Pick<Ads, 'playing' | 'currentAds' | 'currentAdBreak'>;
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Consumes backing Ads events only; integration-generated events bypass this hook.
|
|
37
|
+
*
|
|
38
|
+
* @param event - The content player's advertising event.
|
|
39
|
+
* @returns `true` to hide the event from all facade Ads listeners, or `false` to forward it.
|
|
40
|
+
*
|
|
41
|
+
* @remarks
|
|
42
|
+
* Called once per subscribed event, not once per listener. Events from {@link ads} bypass this hook.
|
|
43
|
+
*/
|
|
44
|
+
shouldConsumeAdEvent?(event: PlayerFacadeAdsEventMap[keyof PlayerFacadeAdsEventMap]): boolean;
|
|
45
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { AdEvent, Ads, AdsEventMap, EventDispatcher, PlayerEventMap } from 'theoplayer';
|
|
2
|
+
|
|
3
|
+
export type { IntegrationRegistration } from './IntegrationRegistration';
|
|
4
|
+
export type { PlayerFacadeAPI as PlayerFacade } from './PlayerFacadeAPI';
|
|
5
|
+
export type { PlayerFacadeIntegration } from './PlayerFacadeIntegration';
|
|
6
|
+
|
|
7
|
+
/** Advertising events supported by the facade, including integration-generated clicks. */
|
|
8
|
+
export type PlayerFacadeAdsEventMap = AdsEventMap & { adclicked: AdEvent<'adclicked'> };
|
|
9
|
+
|
|
10
|
+
/** The Web Ads API with event subscriptions extended to support facade advertising events. */
|
|
11
|
+
export type PlayerFacadeAds = Omit<Ads, 'addEventListener' | 'removeEventListener'> & EventDispatcher<PlayerFacadeAdsEventMap>;
|
|
12
|
+
|
|
13
|
+
/** A native Web player or advertising event that an integration can dispatch through its registration. */
|
|
14
|
+
export type PlayerFacadeEvent = PlayerEventMap[keyof PlayerEventMap] | PlayerFacadeAdsEventMap[keyof PlayerFacadeAdsEventMap];
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
/* eslint-disable @typescript-eslint/no-empty-function */
|
|
2
2
|
import type { ChromelessPlayer } from 'theoplayer';
|
|
3
3
|
import type { THEOplayerWebAdapter } from '../THEOplayerWebAdapter';
|
|
4
|
-
import { MediaControlConfiguration } from 'react-native-theoplayer';
|
|
4
|
+
import { MediaControlAction, MediaControlConfiguration } from 'react-native-theoplayer';
|
|
5
|
+
import { MediaControlWebAdapter } from '../media/MediaControlWebAdapter';
|
|
5
6
|
|
|
6
7
|
const DEFAULT_SKIP_FORWARD_INTERVAL = 5;
|
|
7
8
|
const DEFAULT_SKIP_BACKWARD_INTERVAL = 5;
|
|
@@ -30,19 +31,50 @@ const mediaSession = (function () {
|
|
|
30
31
|
* @link https://w3c.github.io/mediasession
|
|
31
32
|
*/
|
|
32
33
|
export class WebMediaSession {
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
34
|
+
// The session that most recently published to the process-wide navigator.mediaSession.
|
|
35
|
+
// Used to scope clearing so a disabled/destroyed player only clears its own session and never
|
|
36
|
+
// clobbers another (newly-active) owner during a multi-player hand-off.
|
|
37
|
+
private static _currentOwner: WebMediaSession | undefined;
|
|
38
|
+
private readonly _mediaControlAdapter: MediaControlWebAdapter;
|
|
39
|
+
private _enabled: boolean;
|
|
40
|
+
|
|
41
|
+
constructor(
|
|
42
|
+
private readonly _webAdapter: THEOplayerWebAdapter,
|
|
43
|
+
private readonly _player: ChromelessPlayer,
|
|
44
|
+
private readonly _config: MediaControlConfiguration = defaultMediaControlConfiguration,
|
|
45
|
+
) {
|
|
46
|
+
this._enabled = this._config.mediaSessionEnabled !== false;
|
|
41
47
|
this._player.addEventListener('sourcechange', this.onSourceChange);
|
|
48
|
+
this._mediaControlAdapter = new MediaControlWebAdapter(this);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
get mediaControlAdapter() {
|
|
52
|
+
return this._mediaControlAdapter;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
setEnabled(enabled: boolean) {
|
|
56
|
+
if (this._enabled === enabled) {
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
this._enabled = enabled;
|
|
60
|
+
if (enabled) {
|
|
61
|
+
this.updateMetadata();
|
|
62
|
+
this.updateMediaSession();
|
|
63
|
+
} else {
|
|
64
|
+
this.clearMediaSession();
|
|
65
|
+
}
|
|
42
66
|
}
|
|
43
67
|
|
|
44
68
|
updateMediaSession() {
|
|
45
|
-
|
|
69
|
+
if (!this._enabled) {
|
|
70
|
+
// A disabled session must not touch the shared navigator.mediaSession on routine events, as this
|
|
71
|
+
// would clobber the state of another player that currently owns the session. Explicit clearing
|
|
72
|
+
// only happens on the setEnabled(false)/destroy() transitions.
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
// This session is now publishing to the shared media session: claim ownership.
|
|
76
|
+
WebMediaSession._currentOwner = this;
|
|
77
|
+
// Update trick-play capabilities
|
|
46
78
|
if (this.isTrickPlayEnabled()) {
|
|
47
79
|
mediaSession.setActionHandler('seekbackward', (event) => {
|
|
48
80
|
const skipTime = event.seekOffset || this._config.skipBackwardInterval || DEFAULT_SKIP_BACKWARD_INTERVAL;
|
|
@@ -67,23 +99,33 @@ export class WebMediaSession {
|
|
|
67
99
|
mediaSession.setActionHandler('seekto', NoOp);
|
|
68
100
|
}
|
|
69
101
|
|
|
70
|
-
//
|
|
102
|
+
// Update play/pause capabilities
|
|
103
|
+
// Prefer a user-registered PLAY/PAUSE handler (called with the THEOplayer instance), and fall back to
|
|
104
|
+
// the default player action when none is set, matching the iOS/Android behavior.
|
|
71
105
|
if (this.isPlayPauseEnabled()) {
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
mediaSession
|
|
76
|
-
this._player?.pause();
|
|
77
|
-
});
|
|
106
|
+
const playHandler = this.mediaControlAdapter.getHandler(MediaControlAction.PLAY);
|
|
107
|
+
mediaSession.setActionHandler('play', () => (playHandler ? playHandler(this._webAdapter) : this._player?.play()));
|
|
108
|
+
const pauseHandler = this.mediaControlAdapter.getHandler(MediaControlAction.PAUSE);
|
|
109
|
+
mediaSession.setActionHandler('pause', () => (pauseHandler ? pauseHandler(this._webAdapter) : this._player?.pause()));
|
|
78
110
|
} else {
|
|
79
111
|
mediaSession.setActionHandler('play', NoOp);
|
|
80
112
|
mediaSession.setActionHandler('pause', NoOp);
|
|
81
113
|
}
|
|
82
114
|
|
|
83
|
-
//
|
|
115
|
+
// Update queue actions
|
|
116
|
+
// There is no default behaviour for these: reset the action handler when the user removed theirs, or
|
|
117
|
+
// the browser keeps presenting the button and dispatching to the removed handler.
|
|
118
|
+
// Note: the browser invokes media session action handlers with a MediaSessionActionDetails argument.
|
|
119
|
+
// Wrap the user handler so it is called with the THEOplayer instance, matching the MediaControlHandler contract.
|
|
120
|
+
const previousTrackHandler = this.mediaControlAdapter.getHandler(MediaControlAction.SKIP_TO_PREVIOUS);
|
|
121
|
+
mediaSession.setActionHandler('previoustrack', previousTrackHandler ? () => previousTrackHandler(this._webAdapter) : NoOp);
|
|
122
|
+
const nextTrackHandler = this.mediaControlAdapter.getHandler(MediaControlAction.SKIP_TO_NEXT);
|
|
123
|
+
mediaSession.setActionHandler('nexttrack', nextTrackHandler ? () => nextTrackHandler(this._webAdapter) : NoOp);
|
|
124
|
+
|
|
125
|
+
// Update playbackState
|
|
84
126
|
mediaSession.playbackState = this._player.paused ? 'paused' : 'playing';
|
|
85
127
|
|
|
86
|
-
//
|
|
128
|
+
// Update position
|
|
87
129
|
this.updatePositionState();
|
|
88
130
|
}
|
|
89
131
|
|
|
@@ -91,11 +133,28 @@ export class WebMediaSession {
|
|
|
91
133
|
this._player.removeEventListener(['play', 'playing'], this.onFirstPlaying);
|
|
92
134
|
this._player.removeEventListener(['play', 'pause', 'loadedmetadata', 'durationchange', 'ratechange'], this.update);
|
|
93
135
|
this._player.ads?.removeEventListener(['adbreakbegin', 'adbreakend'], this.update);
|
|
136
|
+
this.clearMediaSession();
|
|
137
|
+
// Make sure a late updateMediaSession() call, e.g. from a configuration setter, does not
|
|
138
|
+
// republish state for a destroyed player.
|
|
139
|
+
this._enabled = false;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
private clearMediaSession() {
|
|
143
|
+
// Only clear the shared media session if this player owns it (or nobody does), so a disabled or
|
|
144
|
+
// destroyed player never wipes another (newly-active) owner's session during a hand-off.
|
|
145
|
+
if (WebMediaSession._currentOwner !== undefined && WebMediaSession._currentOwner !== this) {
|
|
146
|
+
return;
|
|
147
|
+
}
|
|
148
|
+
WebMediaSession._currentOwner = undefined;
|
|
94
149
|
mediaSession.setActionHandler('play', NoOp);
|
|
95
150
|
mediaSession.setActionHandler('pause', NoOp);
|
|
96
151
|
mediaSession.setActionHandler('seekbackward', NoOp);
|
|
97
152
|
mediaSession.setActionHandler('seekforward', NoOp);
|
|
98
153
|
mediaSession.setActionHandler('seekto', NoOp);
|
|
154
|
+
mediaSession.setActionHandler('previoustrack', NoOp);
|
|
155
|
+
mediaSession.setActionHandler('nexttrack', NoOp);
|
|
156
|
+
mediaSession.metadata = null;
|
|
157
|
+
mediaSession.playbackState = 'none';
|
|
99
158
|
}
|
|
100
159
|
|
|
101
160
|
private update = () => {
|
|
@@ -113,12 +172,17 @@ export class WebMediaSession {
|
|
|
113
172
|
this._player.removeEventListener(['play', 'playing'], this.onFirstPlaying);
|
|
114
173
|
this._player.removeEventListener(['play', 'pause', 'loadedmetadata', 'durationchange', 'ratechange'], this.update);
|
|
115
174
|
this._player.ads?.removeEventListener(['adbreakbegin', 'adbreakend'], this.update);
|
|
116
|
-
|
|
117
|
-
|
|
175
|
+
if (this._enabled) {
|
|
176
|
+
mediaSession.metadata = null;
|
|
177
|
+
mediaSession.playbackState = 'none';
|
|
178
|
+
}
|
|
118
179
|
this._player.addEventListener(['play', 'playing'], this.onFirstPlaying);
|
|
119
180
|
};
|
|
120
181
|
|
|
121
182
|
private updateMetadata = () => {
|
|
183
|
+
if (!this._enabled) {
|
|
184
|
+
return;
|
|
185
|
+
}
|
|
122
186
|
const source = this._player.source;
|
|
123
187
|
const metadata = source?.metadata;
|
|
124
188
|
const artwork = [metadata?.displayIconUri, source?.poster, ...(metadata?.images ? metadata.images : [])]
|
package/src/manifest.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"11.
|
|
1
|
+
{"version":"11.7.0","buildDate":"2026-09-19T14:43:33.039Z"}
|