react-native-theoplayer 2.7.0 → 2.8.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.8.0] - 23-06-01
+
+### Added
+
+- Added `ignoreAvailabilityWindow` property to `SourceDescription.dash` for Android and Web.
+- Added `needsTimescaleShifting`, `desiredTimescale` and `forceSeekToSynchronize` properties to `SourceDescription.dash` for Web.
+
+### Fixed
+
+- Fixed an issue where text track cue changes were not applied to the TextTrack's `cue` property.
+- Fixed an issue on Android where play-out of an MP4 stream would sometimes crash the player.
+- Fixed an issue on Android where a `pause` event would not be dispatched while pausing during play-out of an ad.
+- Fixed an issue on Android where hardware buttons, such as `play` and `pause`, were not handled anymore after toggling background audio support.
+- Fixed an issue on Android where the app would crash when toggling background playback while multiple `MediaBrowserServiceCompat` instances are registered.
+
+### Changed
+
+- Improved fullscreen support to use non-native fullscreen on Safari for iPad and Mac.
+- Limited the set of available media session actions on Android when an ad or live stream is playing.
+- Removed pausing the stream when disabling background playback on Android.
+
 ## [2.7.0] - 23-05-15
 
 ### Changed
@@ -14,6 +35,12 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ### Fixed
 
 - Fixed an issue on Android where if an invalid view tag is passed to the native bridge, it would crash the player.
+- Fixed an issue on Web where preview thumbnails would fail to load.
+
+### Added
+
+- Updated UI documentation with necessary dependencies.
+- Added improved debug logging on iOS.
 
 ## [2.6.0] - 23-05-05
 

package/android/build.gradle

@@ -109,7 +109,7 @@ dependencies {
   def theoplayer_sdk_version = safeExtGet('THEOplayer_sdk', '[5.0.1,)')
 
 //  def theoplayer_mediasession_version = safeExtGet('THEOplayer_mediasession', theoplayer_sdk_version)
-  def theoplayer_mediasession_version = "4.12.0-local"
+  def theoplayer_mediasession_version = "5.2.0-local"
   def enabledV4 = theoplayer_sdk_version.toString().startsWith("4.")
   def core_prefix = enabledV4 ? 'unified' : 'core'
   def integration_prefix = enabledV4 ? 'unified' : 'integration'

package/android/local/com/theoplayer/android-connector/mediasession/{4.12.0-local/mediasession-4.12.0-local.pom → 5.2.0-local/mediasession-5.2.0-local.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.theoplayer.android-connector</groupId>
   <artifactId>mediasession</artifactId>
-  <version>4.12.0-local</version>
+  <version>5.2.0-local</version>
   <packaging>aar</packaging>
   <dependencies>
     <dependency>

package/android/local/com/theoplayer/android-connector/mediasession/maven-metadata-local.xml

@@ -3,11 +3,11 @@
   <groupId>com.theoplayer.android-connector</groupId>
   <artifactId>mediasession</artifactId>
   <versioning>
-    <latest>4.12.0-local</latest>
-    <release>4.12.0-local</release>
+    <latest>5.2.0-local</latest>
+    <release>5.2.0-local</release>
     <versions>
-      <version>4.12.0-local</version>
+      <version>5.2.0-local</version>
     </versions>
-    <lastUpdated>20230408184844</lastUpdated>
+    <lastUpdated>20230531125422</lastUpdated>
   </versioning>
 </metadata>

package/android/src/main/AndroidManifest.xml

@@ -29,7 +29,7 @@
 
     <!-- Allow background audio playback by registering this service. -->
     <service
-      android:name="com.theoplayer.audio.MediaPlaybackService"
+      android:name="com.theoplayer.media.MediaPlaybackService"
       android:description="@string/background_playback_service_description"
       android:exported="false"
       android:enabled="false"
@@ -40,7 +40,7 @@
       </intent-filter>
     </service>
 
-    <receiver android:name="androidx.media.session.MediaButtonReceiver"
+    <receiver android:name="com.theoplayer.media.CustomMediaButtonReceiver"
       android:exported="false">
       <intent-filter>
         <action android:name="android.intent.action.MEDIA_BUTTON" />

package/android/src/main/java/com/theoplayer/PlayerEventEmitter.kt

@@ -346,7 +346,7 @@ class PlayerEventEmitter internal constructor(
   private fun onPause() {
     val player = playerView.player
     // Do not forward the pause event in case the content player is paused because the ad player starts.
-    if (player != null && !playerView.adsApi.isPlaying) {
+    if (player != null && (!playerView.adsApi.isPlaying || player.isPaused)) {
       receiveEvent(EVENT_PAUSE, null)
     }
   }

package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt

@@ -26,11 +26,20 @@ import com.theoplayer.android.api.event.player.*
 import com.theoplayer.android.api.player.Player
 import com.theoplayer.android.connector.mediasession.MediaSessionConnector
 import com.theoplayer.audio.BackgroundAudioConfig
-import com.theoplayer.audio.MediaPlaybackService
+import com.theoplayer.media.MediaPlaybackService
 import java.util.concurrent.atomic.AtomicBoolean
 
 private const val TAG = "ReactTHEOplayerContext"
 
+private const val ALLOWED_PLAYBACK_ACTIONS = (
+  PlaybackStateCompat.ACTION_PLAY_PAUSE or
+    PlaybackStateCompat.ACTION_PLAY or
+    PlaybackStateCompat.ACTION_PAUSE or
+    PlaybackStateCompat.ACTION_SEEK_TO or
+    PlaybackStateCompat.ACTION_FAST_FORWARD or
+    PlaybackStateCompat.ACTION_REWIND or
+    PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED)
+
 class ReactTHEOplayerContext private constructor(
   private val reactContext: ThemedReactContext
 ) {
@@ -59,8 +68,6 @@ class ReactTHEOplayerContext private constructor(
     get() = backgroundAudioConfig.enabled
 
   companion object {
-    private var mediaControlledInstance: ReactTHEOplayerContext? = null
-
     fun create(
       reactContext: ThemedReactContext,
       playerConfig: THEOplayerConfig
@@ -75,9 +82,6 @@ class ReactTHEOplayerContext private constructor(
     override fun onServiceConnected(className: ComponentName, service: IBinder) {
       binder = service as MediaPlaybackService.MediaPlaybackBinder
 
-      // Clean-up any existing media session connector
-      mediaSessionConnector?.destroy()
-
       // Get media session connector from service
       mediaSessionConnector = binder?.mediaSessionConnector
       mediaSessionConnector?.player = player
@@ -128,12 +132,26 @@ class ReactTHEOplayerContext private constructor(
     }
   }
 
+  private fun applyAllowedMediaControls() {
+    // Reduce allowed set of remote control playback actions for ads & live streams.
+    val isLive = player.duration.isInfinite()
+    val isInAd = player.ads.isPlaying
+    mediaSessionConnector?.enabledPlaybackActions = if (isInAd || isLive) {
+      0
+    } else {
+      ALLOWED_PLAYBACK_ACTIONS
+    }
+  }
+
   private fun bindMediaPlaybackService() {
     // Bind to an existing service, if available
     // A bound service runs only as long as another application component is bound to it.
     // Multiple components can bind to the service at once, but when all of them unbind, the
     // service is destroyed.
     if (!isBound.get()) {
+      // Clean-up any existing media session connector
+      mediaSessionConnector?.destroy()
+
       isBound.set(
         reactContext.bindService(
           Intent(reactContext, MediaPlaybackService::class.java),
@@ -179,11 +197,8 @@ class ReactTHEOplayerContext private constructor(
     addIntegrations(playerConfig)
     addListeners()
 
-    if (mediaControlledInstance == null) {
-      mediaControlledInstance = this
-      if (!BuildConfig.USE_PLAYBACK_SERVICE || !isBackgroundAudioEnabled) {
-        initDefaultMediaSession()
-      }
+    if (!BuildConfig.USE_PLAYBACK_SERVICE || !isBackgroundAudioEnabled) {
+      initDefaultMediaSession()
     }
 
     // Apply initial backgroundPlayback config
@@ -243,10 +258,12 @@ class ReactTHEOplayerContext private constructor(
   private val onSourceChange = EventListener<SourceChangeEvent> {
     mediaSessionConnector?.setMediaSessionMetadata(player.source)
     binder?.updateNotification()
+    applyAllowedMediaControls()
   }
 
   private val onLoadedMetadata = EventListener<LoadedMetadataEvent> {
     binder?.updateNotification()
+    applyAllowedMediaControls()
   }
 
   private val onPlay = EventListener<PlayEvent> {
@@ -254,10 +271,12 @@ class ReactTHEOplayerContext private constructor(
       bindMediaPlaybackService()
     }
     binder?.updateNotification(PlaybackStateCompat.STATE_PLAYING)
+    applyAllowedMediaControls()
   }
 
   private val onPause = EventListener<PauseEvent> {
     binder?.updateNotification(PlaybackStateCompat.STATE_PAUSED)
+    applyAllowedMediaControls()
   }
 
   private fun addListeners() {
@@ -310,17 +329,14 @@ class ReactTHEOplayerContext private constructor(
   }
 
   fun destroy() {
-    if (mediaControlledInstance == this) {
-      if (BuildConfig.USE_PLAYBACK_SERVICE) {
-        removeListeners()
+    if (BuildConfig.USE_PLAYBACK_SERVICE) {
+      removeListeners()
 
-        // Remove service from foreground
-        binder?.stopForegroundService()
+      // Remove service from foreground
+      binder?.stopForegroundService()
 
-        // Unbind client from background service so it can stop
-        unbindMediaPlaybackService()
-      }
-      mediaControlledInstance = null
+      // Unbind client from background service so it can stop
+      unbindMediaPlaybackService()
     }
     mediaSessionConnector?.destroy()
     playerView.onDestroy()

package/android/src/main/java/com/theoplayer/media/CustomMediaButtonReceiver.kt

@@ -0,0 +1,25 @@
+package com.theoplayer.media
+
+import android.content.Context
+import android.content.Intent
+import android.util.Log
+import androidx.media.session.MediaButtonReceiver
+
+private const val TAG = "MediaButtonReceiver"
+
+class CustomMediaButtonReceiver : MediaButtonReceiver() {
+
+  override fun onReceive(context: Context?, intent: Intent?) {
+    // MediaButtonReceiver will throw an IllegalStateException in case there are
+    // none, or more than one MediaBrowserServiceCompat instances registered.
+    // Handle and ignore the exception here.
+    try {
+      super.onReceive(context, intent)
+    } catch (e: IllegalStateException) {
+      Log.e(
+        TAG,
+        e.message ?: "Failed to handle media playback button action."
+      )
+    }
+  }
+}

package/android/src/main/java/com/theoplayer/{audio → media}/MediaNotificationBuilder.kt

@@ -1,4 +1,4 @@
-package com.theoplayer.audio
+package com.theoplayer.media
 
 import android.app.Notification
 import android.app.NotificationChannel

package/android/src/main/java/com/theoplayer/{audio → media}/MediaPlaybackService.kt

@@ -1,4 +1,4 @@
-package com.theoplayer.audio
+package com.theoplayer.media
 
 import android.app.NotificationManager
 import android.app.PendingIntent
@@ -98,6 +98,9 @@ class MediaPlaybackService : MediaBrowserServiceCompat() {
   }
 
   override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+    // This ensures that the correct callbacks to MediaSessionCompat.Callback will be triggered
+    // based on the incoming KeyEvent.
+    // https://developer.android.com/reference/androidx/media/session/MediaButtonReceiver
     MediaButtonReceiver.handleIntent(mediaSession, intent)
     return super.onStartCommand(intent, flags, startId)
   }
@@ -155,17 +158,19 @@ class MediaPlaybackService : MediaBrowserServiceCompat() {
       setMediaButtonReceiver(mediaButtonPendingIntent)
     }
 
-    // Create a MediaSessionConnector and attach the THEOplayer instance.
+    // Create a MediaSessionConnector.
     mediaSessionConnector = MediaSessionConnector(mediaSession).apply {
       debug = BuildConfig.LOG_MEDIASESSION_EVENTS
 
       // Set mediaSession active
       setActive(true)
     }
+
+    // Set the MediaBrowserServiceCompat's media session.
+    sessionToken = mediaSession.sessionToken
   }
 
   private fun stopForegroundService() {
-    player?.pause()
     updateNotification(PlaybackStateCompat.STATE_STOPPED)
     stopSelf()
   }

package/android/src/main/java/com/theoplayer/source/SourceAdapter.kt

@@ -24,6 +24,7 @@ import com.theoplayer.android.api.source.metadata.ChromecastMetadataImage
 import com.facebook.react.bridge.ReadableArray
 import com.theoplayer.BuildConfig
 import com.theoplayer.android.api.error.ErrorCode
+import com.theoplayer.android.api.source.dash.DashPlaybackConfiguration
 import com.theoplayer.drm.ContentProtectionAdapter
 import org.json.JSONArray
 import org.json.JSONException
@@ -51,6 +52,8 @@ private const val PROP_TEXT_TRACKS = "textTracks"
 private const val PROP_POSTER = "poster"
 private const val PROP_ADS = "ads"
 private const val PROP_AVAILABILITY_TYPE = "availabilityType"
+private const val PROP_DASH = "dash"
+private const val PROP_DASH_IGNORE_AVAILABILITYWINDOW = "ignoreAvailabilityWindow"
 private const val ERROR_DAI_NOT_ENABLED = "Google DAI support not enabled."
 private const val ERROR_UNSUPPORTED_SSAI_INTEGRATION = "Unsupported SSAI integration"
 private const val ERROR_MISSING_SSAI_INTEGRATION = "Missing SSAI integration"
@@ -186,6 +189,9 @@ class SourceAdapter {
       if (sourceType != null) {
         tsBuilder.type(sourceType)
       }
+      if (jsonTypedSource.has(PROP_DASH)) {
+        tsBuilder.dash(parseDashConfig(jsonTypedSource.getJSONObject(PROP_DASH)))
+      }
       if (jsonTypedSource.has(PROP_LIVE_OFFSET)) {
         tsBuilder.liveOffset(jsonTypedSource.getDouble(PROP_LIVE_OFFSET))
       }
@@ -358,6 +364,12 @@ class SourceAdapter {
     return MetadataDescription(metadata)
   }
 
+  private fun parseDashConfig(dashConfig: JSONObject): DashPlaybackConfiguration {
+    return DashPlaybackConfiguration.Builder()
+      .ignoreAvailabilityWindow(dashConfig.optBoolean(PROP_DASH_IGNORE_AVAILABILITYWINDOW))
+      .build()
+  }
+
   @Throws(JSONException::class)
   private fun parseMetadataImages(metadataImages: JSONArray): List<ChromecastMetadataImage> {
     val imageList: MutableList<ChromecastMetadataImage> = ArrayList()

package/android/src/main/java/com/theoplayer/track/TrackListAdapter.kt

@@ -124,9 +124,11 @@ object TrackListAdapter {
     audioTrackPayload.putString(PROP_LANGUAGE, audioTrack.language)
     val qualityList = audioTrack.qualities
     val qualities = Arguments.createArray()
-    qualityList?.forEach { quality ->
-      qualities.pushMap(fromAudioQuality(quality))
-    }
+    try {
+      qualityList?.forEach { quality ->
+        qualities.pushMap(fromAudioQuality(quality))
+      }
+    } catch (ignore: NullPointerException) {}
     audioTrackPayload.putArray(PROP_QUALITIES, qualities)
     val activeQuality = audioTrack.activeQuality
     if (activeQuality != null) {
@@ -163,18 +165,20 @@ object TrackListAdapter {
     videoTrackPayload.putString(PROP_KIND, videoTrack.kind)
     videoTrackPayload.putString(PROP_LABEL, videoTrack.label)
     videoTrackPayload.putString(PROP_LANGUAGE, videoTrack.language)
-    val qualityList = videoTrack.qualities
     val qualities = Arguments.createArray()
-    if (qualityList != null) {
-      // Sort qualities according to (height, bandwidth)
-      val sortedQualityList = QualityListAdapter(qualityList)
-      sortedQualityList.sort { o: VideoQuality, t1: VideoQuality ->
-        if (o.height == t1.height) t1.bandwidth.compareTo(o.bandwidth) else t1.height.compareTo(o.height)
+    try {
+      val qualityList = videoTrack.qualities
+      if (qualityList != null) {
+        // Sort qualities according to (height, bandwidth)
+        val sortedQualityList = QualityListAdapter(qualityList)
+        sortedQualityList.sort { o: VideoQuality, t1: VideoQuality ->
+          if (o.height == t1.height) t1.bandwidth.compareTo(o.bandwidth) else t1.height.compareTo(o.height)
+        }
+        for (quality in sortedQualityList) {
+          qualities.pushMap(fromVideoQuality(quality as VideoQuality))
+        }
       }
-      for (quality in sortedQualityList) {
-        qualities.pushMap(fromVideoQuality(quality as VideoQuality))
-      }
-    }
+    } catch (ignore: java.lang.NullPointerException) {}
     videoTrackPayload.putArray(PROP_QUALITIES, qualities)
     val activeQuality = videoTrack.activeQuality
     if (activeQuality != null) {

package/lib/commonjs/api/source/dash/DashPlaybackConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["DashPlaybackConfiguration.ts"],"sourcesContent":["/**\n * The strategy for period switches (see {@link DashPlaybackConfiguration.useSeamlessPeriodSwitch}), represented by a value from the following list:\n * <br/> - `'auto'`: The player uses seamless switches if the platform supports it, and hard switches otherwise.\n *                   This is the default.\n * <br/> - `'never'`: The player never uses a seamless switch, and always uses a hard switch.\n *                    Use this if you notice that the player is attempting but failing to preload the next period on the current platform.\n * <br/> - `'always'`: The player always uses a seamless switch, and never uses a hard switch.\n *                     Use this if you notice that the player never preloads the next period, even though you know that the current platform\n *                     should support it.\n *\n * @public\n */\nexport type SeamlessPeriodSwitchStrategy = 'auto' | 'always' | 'never';\n\n/**\n * Represents a configuration for controlling playback of an MPEG-DASH stream.\n *\n * @remarks\n * <br/> - Available since v2.79.0.\n *\n * @public\n */\nexport interface DashPlaybackConfiguration {\n  /**\n   * Whether to seamlessly switch between DASH periods.\n   *\n   * @remarks\n   * The player supports two strategies for handling a switch between two periods in an MPEG-DASH stream:\n   * <br/> - <strong>Seamless</strong>: Once the player is done buffering the current period, it immediately starts buffering the next period.\n   *         This requires that the current period and the next period have compatible codecs and content protection, or that the platform\n   *         supports buffering different codecs in a single player. Because the next period is preloaded ahead of time, this makes the actual\n   *         switch between periods (almost) completely seamless.\n   * <br/> - <strong>Hard</strong>: The player waits until playback reaches the end of the current period before buffering and playing the next\n   *         period. Because the buffering is not done ahead of time, this may result in a noticeable stall at the start of the next period.\n   *         However, this strategy does not require any special platform support, so it works on any platform or device.\n   *\n   * By default, the player will automatically choose between a seamless or a hard period switch based on the codecs and content protection of\n   * the two periods, and the support information reported by the platform. However, if you notice that the player makes an incorrect decision\n   * on certain streams or platforms, you can use this option to override its behavior as a stopgap solution. (You should still report this\n   * problem to THEOplayer support, so we can improve the player's default behavior and you can remove this override.)\n   *\n   * @defaultValue `'auto'`\n   */\n  useSeamlessPeriodSwitch?: SeamlessPeriodSwitchStrategy;\n}\n"],"mappings":""}
+{"version":3,"names":[],"sources":["DashPlaybackConfiguration.ts"],"sourcesContent":["/**\n * The strategy for period switches (see {@link DashPlaybackConfiguration.useSeamlessPeriodSwitch}), represented by a value from the following list:\n * <br/> - `'auto'`: The player uses seamless switches if the platform supports it, and hard switches otherwise.\n *                   This is the default.\n * <br/> - `'never'`: The player never uses a seamless switch, and always uses a hard switch.\n *                    Use this if you notice that the player is attempting but failing to preload the next period on the current platform.\n * <br/> - `'always'`: The player always uses a seamless switch, and never uses a hard switch.\n *                     Use this if you notice that the player never preloads the next period, even though you know that the current platform\n *                     should support it.\n *\n * @public\n */\nexport type SeamlessPeriodSwitchStrategy = 'auto' | 'always' | 'never';\n\n/**\n * Represents a configuration for controlling playback of an MPEG-DASH stream.\n *\n * @remarks\n * <br/> - Available since v2.79.0.\n *\n * @public\n */\nexport interface DashPlaybackConfiguration {\n  /**\n   * Whether to seamlessly switch between DASH periods.\n   *\n   * @remarks\n   * <br/> - Available on Web only.\n   *\n   * The player supports two strategies for handling a switch between two periods in an MPEG-DASH stream:\n   * <br/> - <strong>Seamless</strong>: Once the player is done buffering the current period, it immediately starts buffering the next period.\n   *         This requires that the current period and the next period have compatible codecs and content protection, or that the platform\n   *         supports buffering different codecs in a single player. Because the next period is preloaded ahead of time, this makes the actual\n   *         switch between periods (almost) completely seamless.\n   * <br/> - <strong>Hard</strong>: The player waits until playback reaches the end of the current period before buffering and playing the next\n   *         period. Because the buffering is not done ahead of time, this may result in a noticeable stall at the start of the next period.\n   *         However, this strategy does not require any special platform support, so it works on any platform or device.\n   *\n   * By default, the player will automatically choose between a seamless or a hard period switch based on the codecs and content protection of\n   * the two periods, and the support information reported by the platform. However, if you notice that the player makes an incorrect decision\n   * on certain streams or platforms, you can use this option to override its behavior as a stopgap solution. (You should still report this\n   * problem to THEOplayer support, so we can improve the player's default behavior and you can remove this override.)\n   *\n   * @defaultValue `'auto'`\n   */\n  useSeamlessPeriodSwitch?: SeamlessPeriodSwitchStrategy;\n\n  /**\n   * (Experimental) Whether the timescales of the media data need to be shifted,\n   * in order to work around platform-specific issues on certain smart TV platforms.\n   *\n   * @remarks\n   * <br/> - Available since v4.1.0.\n   * <br/> - Available on Web only.\n   * <br/> - On certain smart TV platforms (such as Tizen 2), playback issues may arise when\n   *         the timescale of the media data changes across periods or discontinuities.\n   *         In that case, the player may need to shift all the timescales first,\n   *         however this strategy may not work for all streams.\n   * <br/> - When not specified, the player will decide whether or not to shift timescales\n   *         based on the platform.\n   * <br/> - This is an experimental option. It should only be used after consulting with\n   *         THEOplayer support or engineering.\n   */\n  needsTimescaleShifting?: boolean | null;\n\n  /**\n   * (Experimental) The desired timescale to which the media data should be shifted.\n   *\n   * @remarks\n   * <br/> - Available since v4.11.0.\n   * <br/> - Available on Web only.\n   * <br/> - When specified, if the player decides to shift the timescale (see {@link DashPlaybackConfiguration.needsTimescaleShifting}), the timescale will be set to the\n   *         given desired timescale.\n   * <br/> - When not specified, if the player decides to shift timescale, the player will decide the timescale to which it should shift.\n   * <br/> - This is an experimental option. It should only be used after consulting with\n   *         THEOplayer support or engineering.\n   */\n  desiredTimescale?: number;\n\n  /**\n   * Whether the player should try to force the seek on period switching to realign video and audio.\n   *\n   * @internal\n   *\n   * @remarks\n   * <br/> - Available on Web only.\n   */\n  forceSeekToSynchronize?: boolean;\n\n  /**\n   * (Experimental) Force the player to ignore the availability window of individual segments in the MPD,\n   * and instead consider every listed segment to be immediately available.\n   *\n   * @remarks\n   * <br/> - Available since v5.2.0.\n   * <br/> - Available on Web and Android.\n   * <br/> - This only applies to livestreams (with `<MPD type=\"dynamic\">`).\n   * <br/> - This only applies to streams that use `<SegmentTimeline>`.\n   */\n  ignoreAvailabilityWindow?: boolean;\n}\n"],"mappings":""}

package/lib/commonjs/api/track/TextTrack.js.map

@@ -1 +1 @@
-{"version":3,"names":["TextTrackType","exports","TextTrackKind","TextTrackMode","filterRenderableTracks","textTracks","filter","textTrack","kind","filterThumbnailTracks","find","isThumbnailTrack","label","hasTextTrackCue","cue","cues","c","uid","removeTextTrackCue","addTextTrackCue","push","findTextTrackByUid","t"],"sources":["TextTrack.ts"],"sourcesContent":["import type { Track } from './Track';\nimport type { TextTrackCue } from './TextTrackCue';\n\nexport enum TextTrackType {\n  cea608 = 'cea608',\n  id3 = 'id3',\n  srt = 'srt',\n  ttml = 'ttml',\n  webvtt = 'webvtt',\n}\n\nexport enum TextTrackKind {\n  captions = 'captions',\n  chapters = 'chapters',\n  descriptions = 'descriptions',\n  metadata = 'metadata',\n  subtitles = 'subtitles',\n  thumbnails = 'thumbnails',\n}\n\nexport enum TextTrackMode {\n  disabled = 'disabled',\n  showing = 'showing',\n  hidden = 'hidden',\n}\n\nexport interface TextTrack extends Track {\n  /**\n   * The kind of the text track, represented by a value from the following list:\n   * <br/> - `'subtitles'`: The track contains subtitles.\n   * <br/> - `'captions'`: The track contains closed captions, a translation of dialogue and sound effects.\n   * <br/> - `'descriptions'`: The track contains descriptions, a textual description of the video.\n   * <br/> - `'chapters'`: The track contains chapter titles.\n   * <br/> - `'metadata'`: The track contains metadata. This track will not serve display purposes.\n   */\n  readonly kind: TextTrackKind;\n\n  /**\n   * The label of the text track.\n   */\n  label: string;\n\n  /**\n   * The language of the text track.\n   */\n  readonly language: string;\n\n  /**\n   * The identifier of the text track.\n   *\n   * @remarks\n   * <br/> - This identifier can be used to distinguish between related tracks, e.g. tracks in the same list.\n   */\n  readonly id: string;\n\n  /**\n   * A unique identifier of the text track.\n   *\n   * @remarks\n   * <br/> - This identifier is unique across tracks of a THEOplayer instance and can be used to distinguish between tracks.\n   */\n  readonly uid: number;\n\n  /**\n   * The mode of the text track, represented by a value from the following list:\n   * <br/> - `'disabled'`: The track is disabled.\n   * <br/> - `'showing'`: The track is showing.\n   */\n  mode: TextTrackMode;\n\n  /**\n   * The content type of the text track.\n   */\n  readonly type: TextTrackType;\n\n  /**\n   * The list of cues of the track.\n   *\n   * @remarks\n   * <br/> - If the {@link TextTrack.mode} is `'disabled'`, this property is `null`.\n   */\n  cues: TextTrackCue[] | null;\n\n  /**\n   * The source of the text track.\n   */\n  readonly src: string;\n\n  /**\n   * Indicates whether the track contains Forced Narrative cues.\n   * This may only be true for subtitle tracks where\n   * <br/> - For DASH: the corresponding AdaptationSet contains a child Role with its value attribute equal to `'forced_subtitle'`\n   * <br/> - For HLS: the corresponding #EXT-X-MEDIA tag contains the attributes TYPE=SUBTITLES and FORCED=YES (not supported yet)\n   */\n  readonly forced: boolean;\n}\n\n/**\n * Retain renderable tracks.\n * https://html.spec.whatwg.org/multipage/embedded-content.html#text-track-showing\n */\nexport function filterRenderableTracks(textTracks: TextTrack[] | undefined): TextTrack[] | undefined {\n  return textTracks && textTracks.filter((textTrack) => textTrack.kind === 'subtitles' || textTrack.kind === 'captions');\n}\n\n/**\n * Retain first thumbnail track encountered in the textTracks list.\n */\nexport function filterThumbnailTracks(textTracks: TextTrack[] | undefined): TextTrack | undefined {\n  return textTracks && textTracks.find(isThumbnailTrack);\n}\n\n/**\n * Query whether a track is a valid thumbnail track.\n */\nexport function isThumbnailTrack(textTrack: TextTrack | undefined): boolean {\n  return !!textTrack && (textTrack.kind === 'thumbnails' || (textTrack.kind === 'metadata' && textTrack.label === 'thumbnails'));\n}\n\nexport function hasTextTrackCue(textTrack: TextTrack, cue: TextTrackCue): boolean {\n  return !!(textTrack.cues && cue && textTrack.cues.find((c) => cue.uid === c.uid));\n}\n\nexport function removeTextTrackCue(textTrack: TextTrack, cue: TextTrackCue) {\n  if (textTrack && textTrack.cues && cue && !hasTextTrackCue(textTrack, cue)) {\n    textTrack.cues = textTrack.cues.filter((c) => c.uid !== cue.uid);\n  }\n}\n\nexport function addTextTrackCue(textTrack: TextTrack, cue: TextTrackCue) {\n  if (textTrack && textTrack.cues && cue && !hasTextTrackCue(textTrack, cue)) {\n    textTrack.cues.push(cue);\n  }\n}\n\nexport function findTextTrackByUid(textTracks: TextTrack[], uid: number): TextTrack | undefined {\n  return textTracks.find((t) => t.uid === uid);\n}\n"],"mappings":";;;;;;;;;;;;;IAGYA,aAAa;AAAAC,OAAA,CAAAD,aAAA,GAAAA,aAAA;AAAA,WAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;AAAA,GAAbA,aAAa,KAAAC,OAAA,CAAAD,aAAA,GAAbA,aAAa;AAAA,IAQbE,aAAa;AAAAD,OAAA,CAAAC,aAAA,GAAAA,aAAA;AAAA,WAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;AAAA,GAAbA,aAAa,KAAAD,OAAA,CAAAC,aAAA,GAAbA,aAAa;AAAA,IASbC,aAAa;AAAAF,OAAA,CAAAE,aAAA,GAAAA,aAAA;AAAA,WAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;AAAA,GAAbA,aAAa,KAAAF,OAAA,CAAAE,aAAA,GAAbA,aAAa;AA6EzB;AACA;AACA;AACA;AACO,SAASC,sBAAsBA,CAACC,UAAmC,EAA2B;EACnG,OAAOA,UAAU,IAAIA,UAAU,CAACC,MAAM,CAAEC,SAAS,IAAKA,SAAS,CAACC,IAAI,KAAK,WAAW,IAAID,SAAS,CAACC,IAAI,KAAK,UAAU,CAAC;AACxH;;AAEA;AACA;AACA;AACO,SAASC,qBAAqBA,CAACJ,UAAmC,EAAyB;EAChG,OAAOA,UAAU,IAAIA,UAAU,CAACK,IAAI,CAACC,gBAAgB,CAAC;AACxD;;AAEA;AACA;AACA;AACO,SAASA,gBAAgBA,CAACJ,SAAgC,EAAW;EAC1E,OAAO,CAAC,CAACA,SAAS,KAAKA,SAAS,CAACC,IAAI,KAAK,YAAY,IAAKD,SAAS,CAACC,IAAI,KAAK,UAAU,IAAID,SAAS,CAACK,KAAK,KAAK,YAAa,CAAC;AAChI;AAEO,SAASC,eAAeA,CAACN,SAAoB,EAAEO,GAAiB,EAAW;EAChF,OAAO,CAAC,EAAEP,SAAS,CAACQ,IAAI,IAAID,GAAG,IAAIP,SAAS,CAACQ,IAAI,CAACL,IAAI,CAAEM,CAAC,IAAKF,GAAG,CAACG,GAAG,KAAKD,CAAC,CAACC,GAAG,CAAC,CAAC;AACnF;AAEO,SAASC,kBAAkBA,CAACX,SAAoB,EAAEO,GAAiB,EAAE;EAC1E,IAAIP,SAAS,IAAIA,SAAS,CAACQ,IAAI,IAAID,GAAG,IAAI,CAACD,eAAe,CAACN,SAAS,EAAEO,GAAG,CAAC,EAAE;IAC1EP,SAAS,CAACQ,IAAI,GAAGR,SAAS,CAACQ,IAAI,CAACT,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,GAAG,KAAKH,GAAG,CAACG,GAAG,CAAC;EAClE;AACF;AAEO,SAASE,eAAeA,CAACZ,SAAoB,EAAEO,GAAiB,EAAE;EACvE,IAAIP,SAAS,IAAIA,SAAS,CAACQ,IAAI,IAAID,GAAG,IAAI,CAACD,eAAe,CAACN,SAAS,EAAEO,GAAG,CAAC,EAAE;IAC1EP,SAAS,CAACQ,IAAI,CAACK,IAAI,CAACN,GAAG,CAAC;EAC1B;AACF;AAEO,SAASO,kBAAkBA,CAAChB,UAAuB,EAAEY,GAAW,EAAyB;EAC9F,OAAOZ,UAAU,CAACK,IAAI,CAAEY,CAAC,IAAKA,CAAC,CAACL,GAAG,KAAKA,GAAG,CAAC;AAC9C"}
+{"version":3,"names":["TextTrackType","exports","TextTrackKind","TextTrackMode","filterRenderableTracks","textTracks","filter","textTrack","kind","filterThumbnailTracks","find","isThumbnailTrack","label","hasTextTrackCue","cue","cues","c","uid","removeTextTrackCue","addTextTrackCue","push","findTextTrackByUid","t"],"sources":["TextTrack.ts"],"sourcesContent":["import type { Track } from './Track';\nimport type { TextTrackCue } from './TextTrackCue';\n\nexport enum TextTrackType {\n  cea608 = 'cea608',\n  id3 = 'id3',\n  srt = 'srt',\n  ttml = 'ttml',\n  webvtt = 'webvtt',\n}\n\nexport enum TextTrackKind {\n  captions = 'captions',\n  chapters = 'chapters',\n  descriptions = 'descriptions',\n  metadata = 'metadata',\n  subtitles = 'subtitles',\n  thumbnails = 'thumbnails',\n}\n\nexport enum TextTrackMode {\n  disabled = 'disabled',\n  showing = 'showing',\n  hidden = 'hidden',\n}\n\nexport interface TextTrack extends Track {\n  /**\n   * The kind of the text track, represented by a value from the following list:\n   * <br/> - `'subtitles'`: The track contains subtitles.\n   * <br/> - `'captions'`: The track contains closed captions, a translation of dialogue and sound effects.\n   * <br/> - `'descriptions'`: The track contains descriptions, a textual description of the video.\n   * <br/> - `'chapters'`: The track contains chapter titles.\n   * <br/> - `'metadata'`: The track contains metadata. This track will not serve display purposes.\n   */\n  readonly kind: TextTrackKind;\n\n  /**\n   * The label of the text track.\n   */\n  label: string;\n\n  /**\n   * The language of the text track.\n   */\n  readonly language: string;\n\n  /**\n   * The identifier of the text track.\n   *\n   * @remarks\n   * <br/> - This identifier can be used to distinguish between related tracks, e.g. tracks in the same list.\n   */\n  readonly id: string;\n\n  /**\n   * A unique identifier of the text track.\n   *\n   * @remarks\n   * <br/> - This identifier is unique across tracks of a THEOplayer instance and can be used to distinguish between tracks.\n   */\n  readonly uid: number;\n\n  /**\n   * The mode of the text track, represented by a value from the following list:\n   * <br/> - `'disabled'`: The track is disabled.\n   * <br/> - `'showing'`: The track is showing.\n   */\n  mode: TextTrackMode;\n\n  /**\n   * The content type of the text track.\n   */\n  readonly type: TextTrackType;\n\n  /**\n   * The list of cues of the track.\n   *\n   * @remarks\n   * <br/> - If the {@link TextTrack.mode} is `'disabled'`, this property is `null`.\n   */\n  cues: TextTrackCue[] | null;\n\n  /**\n   * The source of the text track.\n   */\n  readonly src: string;\n\n  /**\n   * Indicates whether the track contains Forced Narrative cues.\n   * This may only be true for subtitle tracks where\n   * <br/> - For DASH: the corresponding AdaptationSet contains a child Role with its value attribute equal to `'forced_subtitle'`\n   * <br/> - For HLS: the corresponding #EXT-X-MEDIA tag contains the attributes TYPE=SUBTITLES and FORCED=YES (not supported yet)\n   */\n  readonly forced: boolean;\n}\n\n/**\n * Retain renderable tracks.\n * https://html.spec.whatwg.org/multipage/embedded-content.html#text-track-showing\n */\nexport function filterRenderableTracks(textTracks: TextTrack[] | undefined): TextTrack[] | undefined {\n  return textTracks && textTracks.filter((textTrack) => textTrack.kind === 'subtitles' || textTrack.kind === 'captions');\n}\n\n/**\n * Retain first thumbnail track encountered in the textTracks list.\n */\nexport function filterThumbnailTracks(textTracks: TextTrack[] | undefined): TextTrack | undefined {\n  return textTracks && textTracks.find(isThumbnailTrack);\n}\n\n/**\n * Query whether a track is a valid thumbnail track.\n */\nexport function isThumbnailTrack(textTrack: TextTrack | undefined): boolean {\n  return !!textTrack && (textTrack.kind === 'thumbnails' || (textTrack.kind === 'metadata' && textTrack.label === 'thumbnails'));\n}\n\nexport function hasTextTrackCue(textTrack: TextTrack, cue: TextTrackCue): boolean {\n  return !!(textTrack.cues && cue && textTrack.cues.find((c) => cue.uid === c.uid));\n}\n\nexport function removeTextTrackCue(textTrack?: TextTrack, cue?: TextTrackCue) {\n  if (textTrack && textTrack.cues && cue && !hasTextTrackCue(textTrack, cue)) {\n    textTrack.cues = textTrack.cues.filter((c) => c.uid !== cue.uid);\n  }\n}\n\nexport function addTextTrackCue(textTrack?: TextTrack, cue?: TextTrackCue) {\n  if (textTrack && textTrack.cues && cue && !hasTextTrackCue(textTrack, cue)) {\n    textTrack.cues.push(cue);\n  }\n}\n\nexport function findTextTrackByUid(textTracks: TextTrack[], uid: number): TextTrack | undefined {\n  return textTracks.find((t) => t.uid === uid);\n}\n"],"mappings":";;;;;;;;;;;;;IAGYA,aAAa;AAAAC,OAAA,CAAAD,aAAA,GAAAA,aAAA;AAAA,WAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;AAAA,GAAbA,aAAa,KAAAC,OAAA,CAAAD,aAAA,GAAbA,aAAa;AAAA,IAQbE,aAAa;AAAAD,OAAA,CAAAC,aAAA,GAAAA,aAAA;AAAA,WAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;AAAA,GAAbA,aAAa,KAAAD,OAAA,CAAAC,aAAA,GAAbA,aAAa;AAAA,IASbC,aAAa;AAAAF,OAAA,CAAAE,aAAA,GAAAA,aAAA;AAAA,WAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;AAAA,GAAbA,aAAa,KAAAF,OAAA,CAAAE,aAAA,GAAbA,aAAa;AA6EzB;AACA;AACA;AACA;AACO,SAASC,sBAAsBA,CAACC,UAAmC,EAA2B;EACnG,OAAOA,UAAU,IAAIA,UAAU,CAACC,MAAM,CAAEC,SAAS,IAAKA,SAAS,CAACC,IAAI,KAAK,WAAW,IAAID,SAAS,CAACC,IAAI,KAAK,UAAU,CAAC;AACxH;;AAEA;AACA;AACA;AACO,SAASC,qBAAqBA,CAACJ,UAAmC,EAAyB;EAChG,OAAOA,UAAU,IAAIA,UAAU,CAACK,IAAI,CAACC,gBAAgB,CAAC;AACxD;;AAEA;AACA;AACA;AACO,SAASA,gBAAgBA,CAACJ,SAAgC,EAAW;EAC1E,OAAO,CAAC,CAACA,SAAS,KAAKA,SAAS,CAACC,IAAI,KAAK,YAAY,IAAKD,SAAS,CAACC,IAAI,KAAK,UAAU,IAAID,SAAS,CAACK,KAAK,KAAK,YAAa,CAAC;AAChI;AAEO,SAASC,eAAeA,CAACN,SAAoB,EAAEO,GAAiB,EAAW;EAChF,OAAO,CAAC,EAAEP,SAAS,CAACQ,IAAI,IAAID,GAAG,IAAIP,SAAS,CAACQ,IAAI,CAACL,IAAI,CAAEM,CAAC,IAAKF,GAAG,CAACG,GAAG,KAAKD,CAAC,CAACC,GAAG,CAAC,CAAC;AACnF;AAEO,SAASC,kBAAkBA,CAACX,SAAqB,EAAEO,GAAkB,EAAE;EAC5E,IAAIP,SAAS,IAAIA,SAAS,CAACQ,IAAI,IAAID,GAAG,IAAI,CAACD,eAAe,CAACN,SAAS,EAAEO,GAAG,CAAC,EAAE;IAC1EP,SAAS,CAACQ,IAAI,GAAGR,SAAS,CAACQ,IAAI,CAACT,MAAM,CAAEU,CAAC,IAAKA,CAAC,CAACC,GAAG,KAAKH,GAAG,CAACG,GAAG,CAAC;EAClE;AACF;AAEO,SAASE,eAAeA,CAACZ,SAAqB,EAAEO,GAAkB,EAAE;EACzE,IAAIP,SAAS,IAAIA,SAAS,CAACQ,IAAI,IAAID,GAAG,IAAI,CAACD,eAAe,CAACN,SAAS,EAAEO,GAAG,CAAC,EAAE;IAC1EP,SAAS,CAACQ,IAAI,CAACK,IAAI,CAACN,GAAG,CAAC;EAC1B;AACF;AAEO,SAASO,kBAAkBA,CAAChB,UAAuB,EAAEY,GAAW,EAAyB;EAC9F,OAAOZ,UAAU,CAACK,IAAI,CAAEY,CAAC,IAAKA,CAAC,CAACL,GAAG,KAAKA,GAAG,CAAC;AAC9C"}

package/lib/commonjs/internal/adapter/THEOplayerAdapter.js

@@ -94,6 +94,22 @@ class THEOplayerAdapter extends _DefaultEventDispatcher.DefaultEventDispatcher {
       this._state.seekable = (_event$seekable = event.seekable) === null || _event$seekable === void 0 ? void 0 : _event$seekable.sort((a, b) => a.end - b.end);
       this._state.buffered = (_event$buffered = event.buffered) === null || _event$buffered === void 0 ? void 0 : _event$buffered.sort((a, b) => a.end - b.end);
     });
+    _defineProperty(this, "onTextTrack", event => {
+      const {
+        subType,
+        cue,
+        trackUid
+      } = event;
+      const track = (0, _reactNativeTheoplayer.findTextTrackByUid)(this._state.textTracks, trackUid);
+      switch (subType) {
+        case _reactNativeTheoplayer.TextTrackEventType.ADD_CUE:
+          (0, _reactNativeTheoplayer.addTextTrackCue)(track, cue);
+          break;
+        case _reactNativeTheoplayer.TextTrackEventType.REMOVE_CUE:
+          (0, _reactNativeTheoplayer.removeTextTrackCue)(track, cue);
+          break;
+      }
+    });
     _defineProperty(this, "onTextTrackList", event => {
       const {
         subType,
@@ -184,6 +200,7 @@ class THEOplayerAdapter extends _DefaultEventDispatcher.DefaultEventDispatcher {
     this.addEventListener(_reactNativeTheoplayer.PlayerEventType.SEEKED, this.onSeeked);
     this.addEventListener(_reactNativeTheoplayer.PlayerEventType.PROGRESS, this.onProgress);
     this.addEventListener(_reactNativeTheoplayer.PlayerEventType.TEXT_TRACK_LIST, this.onTextTrackList);
+    this.addEventListener(_reactNativeTheoplayer.PlayerEventType.TEXT_TRACK, this.onTextTrack);
     this.addEventListener(_reactNativeTheoplayer.PlayerEventType.MEDIA_TRACK, this.onMediaTrack);
     this.addEventListener(_reactNativeTheoplayer.PlayerEventType.MEDIA_TRACK_LIST, this.onMediaTrackList);
     this.addEventListener(_reactNativeTheoplayer.PlayerEventType.PRESENTATIONMODE_CHANGE, this.onPresentationModeChange);