react-native-theoplayer 9.5.0 → 9.7.0

package/src/api/track/MediaTrack.ts

@@ -46,6 +46,13 @@ export interface MediaTrack extends Track {
    */
   readonly label: string;
 
+  /**
+   * The unlocalized label of the media track, as extracted from the manifest.
+   *
+   * @platform ios
+   */
+  readonly unlocalizedLabel?: string;
+
   /**
    * The language of the media track.
    */

package/src/api/track/TextTrack.ts

@@ -83,6 +83,13 @@ export interface TextTrack extends Track {
    */
   readonly kind: TextTrackKind;
 
+  /**
+   * The unlocalized label of the text track, as extracted from the manifest.
+   *
+   * @platform ios
+   */
+  readonly unlocalizedLabel?: string;
+
   /**
    * The label of the text track.
    */

package/src/internal/adapter/THEOplayerAdapter.ts

@@ -20,6 +20,7 @@ import {
   SourceDescription,
   TextTrack,
   TheoAdsAPI,
+  TheoLiveAPI,
   THEOplayer,
   THEOplayerView,
   TimeUpdateEvent,
@@ -48,6 +49,7 @@ import type { NativePlayerState } from './NativePlayerState';
 import { EventBroadcastAdapter } from './broadcast/EventBroadcastAdapter';
 import { DefaultNativePlayerState } from './DefaultNativePlayerState';
 import { THEOAdsNativeAdapter } from './theoads/THEOAdsNativeAdapter';
+import { TheoLiveNativeAdapter } from './theolive/TheoLiveNativeAdapter';
 
 const NativePlayerModule = NativeModules.THEORCTPlayerModule;
 
@@ -59,6 +61,7 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
   private readonly _castAdapter: THEOplayerNativeCastAdapter;
   private readonly _abrAdapter: AbrAdapter;
   private readonly _textTrackStyleAdapter: TextTrackStyleAdapter;
+  private readonly _theoliveAdapter: TheoLiveNativeAdapter;
   private _externalEventRouter: EventBroadcastAPI | undefined = undefined;
   private _playerVersion!: PlayerVersion;
 
@@ -71,6 +74,7 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
     this._castAdapter = new THEOplayerNativeCastAdapter(this, this._view);
     this._abrAdapter = new AbrAdapter(this._view);
     this._textTrackStyleAdapter = new TextTrackStyleAdapter(this._view);
+    this._theoliveAdapter = new TheoLiveNativeAdapter(this._view);
 
     this.addEventListener(PlayerEventType.LOADED_METADATA, this.onLoadedMetadata);
     this.addEventListener(PlayerEventType.PAUSE, this.onPause);
@@ -210,6 +214,10 @@ export class THEOplayerAdapter extends DefaultEventDispatcher<PlayerEventMap> im
     return this._theoAdsAdapter;
   }
 
+  get theolive(): TheoLiveAPI {
+    return this._theoliveAdapter;
+  }
+
   set autoplay(autoplay: boolean) {
     this._state.autoplay = autoplay;
     NativePlayerModule.setAutoplay(this._view.nativeHandle, autoplay);

package/src/internal/adapter/THEOplayerWebAdapter.ts

@@ -2,6 +2,7 @@ import { DefaultEventDispatcher } from './event/DefaultEventDispatcher';
 import {
   AdsAPI,
   AspectRatio,
+  BackgroundAudioConfiguration,
   CastAPI,
   CmcdConfiguration,
   CmcdTransmissionMode,
@@ -17,6 +18,7 @@ import {
   TextTrack,
   TextTrackStyle,
   TheoAdsAPI,
+  TheoLiveAPI,
   THEOplayer,
 } from 'react-native-theoplayer';
 import { THEOplayerWebAdsAdapter } from './ads/THEOplayerWebAdsAdapter';
@@ -27,7 +29,6 @@ import { findNativeQualitiesByUid, fromNativeMediaTrackList } from './web/TrackU
 import type { ABRConfiguration, SourceDescription } from 'src/api/barrel';
 import { WebEventForwarder } from './WebEventForwarder';
 import type { PiPConfiguration } from 'src/api/pip/PiPConfiguration';
-import type { BackgroundAudioConfiguration } from 'src/api/backgroundAudio/BackgroundAudioConfiguration';
 import { WebPresentationModeManager } from './web/WebPresentationModeManager';
 import { WebMediaSession } from './web/WebMediaSession';
 import { BaseEvent } from './event/BaseEvent';
@@ -36,6 +37,7 @@ import { TextTrackState } from './NativePlayerState';
 import { DefaultTextTrackState } from './DefaultTextTrackState';
 import { THEOAdsWebAdapter } from './theoads/THEOAdsWebAdapter';
 import { CMCDConnector, Configuration, createCMCDConnector, TransmissionMode } from '@theoplayer/cmcd-connector-web';
+import { TheoLiveWebAdapter } from './theolive/TheoLiveWebAdapter';
 
 const defaultBackgroundAudioConfiguration: BackgroundAudioConfiguration = {
   enabled: false,
@@ -51,6 +53,7 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
   private readonly _theoAdsAdapter: THEOAdsWebAdapter;
   private readonly _textTrackState: TextTrackState;
   private readonly _presentationModeManager: WebPresentationModeManager;
+  private readonly _theoliveAdapter: TheoLiveWebAdapter;
   private _player: NativeChromelessPlayer | undefined;
   private _eventForwarder: WebEventForwarder | undefined;
   private _mediaSession: WebMediaSession | undefined = undefined;
@@ -66,6 +69,7 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
     this._adsAdapter = new THEOplayerWebAdsAdapter(this._player);
     this._castAdapter = new THEOplayerWebCastAdapter(this._player);
     this._theoAdsAdapter = new THEOAdsWebAdapter(this._player);
+    this._theoliveAdapter = new TheoLiveWebAdapter(this._player);
     this._textTrackState = new DefaultTextTrackState(this);
     this._eventForwarder = new WebEventForwarder(this._player, this);
     this._presentationModeManager = new WebPresentationModeManager(this._player, this);
@@ -363,6 +367,10 @@ export class THEOplayerWebAdapter extends DefaultEventDispatcher<PlayerEventMap>
     return this._castAdapter;
   }
 
+  public get theolive(): TheoLiveAPI {
+    return this._theoliveAdapter;
+  }
+
   public get version(): PlayerVersion {
     return {
       version: nativeVersion,

package/src/internal/adapter/theolive/TheoLiveNativeAdapter.ts

@@ -0,0 +1,29 @@
+import type { HespLatencies, TheoLiveAPI, THEOplayerView } from 'react-native-theoplayer';
+import { NativeModules, Platform } from 'react-native';
+
+const NativeTheoLiveModule = NativeModules.THEORCTTHEOliveModule;
+
+export class TheoLiveNativeAdapter implements TheoLiveAPI {
+  constructor(private _player: THEOplayerView) {}
+
+  get currentLatency(): Promise<number> {
+    if (Platform.OS === 'ios') {
+      return NativeTheoLiveModule.currentLatency(this._player.nativeHandle);
+    }
+    // TODO: implement for Android
+    return Promise.resolve(-1);
+  }
+
+  get latencies(): Promise<HespLatencies> {
+    if (Platform.OS === 'ios') {
+      return NativeTheoLiveModule.latencies(this._player.nativeHandle);
+    }
+    // TODO: implement for Android
+    return Promise.resolve({
+      engineLatency: -1,
+      distributionLatency: -1,
+      playerLatency: -1,
+      theoliveLatency: -1,
+    });
+  }
+}

package/src/internal/adapter/theolive/TheoLiveWebAdapter.ts

@@ -0,0 +1,25 @@
+import type { HespLatencies, TheoLiveAPI } from 'react-native-theoplayer';
+import type { ChromelessPlayer } from 'theoplayer';
+
+export class TheoLiveWebAdapter implements TheoLiveAPI {
+  constructor(private _player: ChromelessPlayer) {}
+
+  get currentLatency(): Promise<number> {
+    const currentLatency = this._player.latency.currentLatency;
+    return currentLatency ? Promise.resolve(currentLatency) : Promise.reject<number>('latency not available');
+  }
+
+  get latencies(): Promise<HespLatencies> {
+    const webLatencies = this._player.hesp?.latencies;
+    if (webLatencies) {
+      return Promise.resolve({
+        engineLatency: webLatencies?.engine,
+        distributionLatency: webLatencies?.distribution,
+        playerLatency: webLatencies?.player,
+        theoliveLatency: webLatencies?.theolive,
+      });
+    } else {
+      return Promise.reject<HespLatencies>('latencies not available');
+    }
+  }
+}

package/src/manifest.json

@@ -1 +1 @@
-{"version":"9.5.0","buildDate":"2025-06-20T10:02:00.763Z"}
+{"version":"9.7.0","buildDate":"2025-07-01T14:45:04.561Z"}