expo-video 55.0.5 → 55.0.7

package/CHANGELOG.md

@@ -10,12 +10,40 @@
 
 ### 💡 Others
 
+## 55.0.7 — 2026-02-20
+
+### 🎉 New features
+
+- [Android][iOS] Add `url` field to HLS video tracks. ([#41681](https://github.com/expo/expo/pull/41681) by [@behenate](https://github.com/behenate))
+- [Android][iOS] Add `name`, `isDefault` and `autoSelect` fields to `AudioTrack` and `SubtitleTrack`. ([#43250](https://github.com/expo/expo/pull/43250) by [@behenate](https://github.com/behenate))
+
+### 💡 Others
+
+- Update HLS video track fetching for iOS 26+. ([#41681](https://github.com/expo/expo/pull/41681) by [@behenate](https://github.com/behenate))
+
+## 55.0.6 — 2026-02-16
+
+### 🛠 Breaking changes
+
+- [Android] The next and previous buttons are now hidden by default in the native `VideoView` controls. ([#42875](https://github.com/expo/expo/pull/42875) by [@behenate](https://github.com/behenate))
+
+### 🎉 New features
+
+- [Android] Add `buttonConfiguration` prop to `VideoView`. ([#42875](https://github.com/expo/expo/pull/42875) by [@behenate](https://github.com/behenate))
+- [Android] Add `PlayerBuilderOptions` parameter to `useVideoPlayer` hook to configure seek backward/forward increments. ([#43043](https://github.com/expo/expo/pull/43043) by [@behenate](https://github.com/behenate))
+
+### 🐛 Bug fixes
+
+- [Android] Fix only one player getting released when reloading with multiple players present. ([#42780](https://github.com/expo/expo/pull/42780) by [@behenate](https://github.com/behenate))
+- [iOS] Fix data getting corrupted when caching is enabled. ([#42621](https://github.com/expo/expo/pull/42621) by [@behenate](https://github.com/behenate))
+
 ## 55.0.5 — 2026-02-08
 
 ### 🐛 Bug fixes
 
 - [iOS] Prevents blocking main thread when loading asset tracks for non-HSL tracks ([#42037](https://github.com/expo/expo/pull/42037) by [@santitopo](https://github.com/santitopo))
 - [Android] Fix crash due to `SimpleCache` directory lock conflicts. ([#42723](https://github.com/expo/expo/pull/42723) by [@santitopo](https://github.com/santitopo))
+- [Android] Avoid crash when FullscreenPlayerActivity init fails. ([#42943](https://github.com/expo/expo/pull/42943) by [@amyu](https://github.com/amyu))
 
 ## 55.0.4 — 2026-02-03
 
@@ -46,6 +74,7 @@ _This version does not introduce any user-facing changes._
 - [Android][iOS] Add `seek tolerance` and `scrubbingModeOptions` properties to the player. ([#40203](https://github.com/expo/expo/pull/40203) by [@behenate](https://github.com/behenate))
 - Allow assigning `null` value to the `player` prop of the `VideoView` ([#40860](https://github.com/expo/expo/pull/40860) by [@behenate](https://github.com/behenate))
 - [Android][iOS] Add `averageBitrate` and `peakBitrate` for video tracks. ([#41532](https://github.com/expo/expo/pull/41532) by [@behenate](https://github.com/behenate))
+- [Android][iOS] Add `url` field to HLS video tracks. ([#41681](https://github.com/expo/expo/pull/41681) by [@behenate](https://github.com/behenate))
 
 ### 🐛 Bug fixes
 
@@ -65,6 +94,7 @@ _This version does not introduce any user-facing changes._
 - Add extract the object `VideoSource` type into separate `VideoSourceObject` type. ([#41514](https://github.com/expo/expo/pull/41514) by [@behenate](https://github.com/behenate))
 - [Android] Set property values on calling thread. ([#41533](https://github.com/expo/expo/pull/41533) by [@behenate](https://github.com/behenate))
 - Mark the video track `bitrate` field as deprecated. ([#41532](https://github.com/expo/expo/pull/41532) by [@behenate](https://github.com/behenate))
+- Update HLS video track fetching for iOS 26+. ([#41681](https://github.com/expo/expo/pull/41681) by [@behenate](https://github.com/behenate))
 
 ## 3.0.15 - 2025-12-05
 

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '55.0.5'
+version = '55.0.7'
 
 android {
   namespace "expo.modules.video"
   defaultConfig {
     versionCode 1
-    versionName '55.0.5'
+    versionName '55.0.7'
   }
 }
 

package/android/src/main/java/expo/modules/video/FullscreenPlayerActivity.kt

@@ -27,14 +27,14 @@ import expo.modules.video.managers.VideoManager
 @androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
 class FullscreenPlayerActivity : Activity() {
   private lateinit var mContentView: View
-  private lateinit var videoViewId: String
+  private var videoViewId: String? = null
   private var videoPlayer: VideoPlayer? = null
   private lateinit var playerView: PlayerView
   private lateinit var videoView: VideoView
   private var didFinish = false
   private var wasAutoPaused = false
   private lateinit var options: FullscreenOptions
-  private lateinit var orientationHelper: FullscreenActivityOrientationHelper
+  private var orientationHelper: FullscreenActivityOrientationHelper? = null
   private var captioningChangeListener: CaptioningManager.CaptioningChangeListener? = null
 
   override fun onCreate(savedInstanceState: Bundle?) {
@@ -53,7 +53,8 @@ class FullscreenPlayerActivity : Activity() {
           ?: throw FullScreenOptionsNotFoundException()
       }
 
-      videoView = VideoManager.getVideoView(videoViewId)
+      videoView = videoViewId?.let { VideoManager.getVideoView(it) }
+        ?: throw FullScreenVideoViewNotFoundException()
 
       orientationHelper = FullscreenActivityOrientationHelper(
         this,
@@ -65,7 +66,7 @@ class FullscreenPlayerActivity : Activity() {
           requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED
         }
       )
-      orientationHelper.startOrientationEventListener()
+      orientationHelper?.startOrientationEventListener()
     } catch (e: CodedException) {
       Log.e("ExpoVideo", "${e.message}", e)
       finish()
@@ -94,13 +95,16 @@ class FullscreenPlayerActivity : Activity() {
     super.onPostCreate(savedInstanceState)
     hideStatusBar()
     setupFullscreenButton()
-    playerView.applyRequiresLinearPlayback(videoPlayer?.requiresLinearPlayback ?: false)
+    val requiresLinearPlayback = videoPlayer?.requiresLinearPlayback ?: false
+    val buttonConfig = videoView.buttonOptions.copy(showBottomBar = true) // Always show bottom bar in fullscreen mode so user can exit
+    playerView.applyButtonOptions(buttonConfig, requiresLinearPlayback)
+    playerView.setTimeBarInteractive(requiresLinearPlayback)
     playerView.addOnLayoutChangeListener { _, _, _, _, _, _, _, _, _ ->
       // On every re-layout ExoPlayer makes the timeBar interactive.
       // We need to disable it to keep scrubbing off.
-      playerView.setTimeBarInteractive(videoPlayer?.requiresLinearPlayback ?: true)
+      playerView.setTimeBarInteractive(requiresLinearPlayback)
     }
-    playerView.setShowSubtitleButton(videoView.showsSubtitlesButton)
+    playerView.setShowSubtitleButton(videoView.buttonOptions.showSubtitles ?: videoView.currentTrackHasSubtitles)
 
     // Configure subtitle view to fix sizing issues with embedded styles (same as VideoView)
     SubtitleUtils.configureSubtitleView(playerView, this)
@@ -116,7 +120,7 @@ class FullscreenPlayerActivity : Activity() {
   override fun finish() {
     super.finish()
     didFinish = true
-    VideoManager.getVideoView(videoViewId).attachPlayer()
+    videoViewId?.let { VideoManager.getVideoView(it).attachPlayer() }
 
     // Disable the exit transition
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
@@ -128,7 +132,7 @@ class FullscreenPlayerActivity : Activity() {
   }
 
   override fun onResume() {
-    orientationHelper.startOrientationEventListener()
+    orientationHelper?.startOrientationEventListener()
     playerView.useController = true
     // Reconfigure subtitles when resuming (handles returning from settings)
     SubtitleUtils.configureSubtitleView(playerView, this)
@@ -143,7 +147,7 @@ class FullscreenPlayerActivity : Activity() {
         videoPlayer?.player?.pause()
       }
     }
-    orientationHelper.stopOrientationEventListener()
+    orientationHelper?.stopOrientationEventListener()
     super.onPause()
   }
 
@@ -159,7 +163,7 @@ class FullscreenPlayerActivity : Activity() {
 
     videoView.exitFullscreen()
     VideoManager.unregisterFullscreenPlayerActivity(hashCode().toString())
-    orientationHelper.stopOrientationEventListener()
+    orientationHelper?.stopOrientationEventListener()
   }
 
   private fun setupFullscreenButton() {
@@ -213,7 +217,7 @@ class FullscreenPlayerActivity : Activity() {
 
   override fun onConfigurationChanged(newConfig: Configuration) {
     super.onConfigurationChanged(newConfig)
-    orientationHelper.onConfigurationChanged(newConfig)
+    orientationHelper?.onConfigurationChanged(newConfig)
   }
 
   companion object {

package/android/src/main/java/expo/modules/video/PlayerViewExtension.kt

@@ -34,3 +34,54 @@ internal fun PlayerView.setFullscreenButtonVisibility(visible: Boolean) {
     android.view.View.GONE
   }
 }
+
+@androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
+internal fun PlayerView.setSettingsButtonVisibility(visible: Boolean) {
+  val settingsButton = findViewById<android.widget.ImageButton>(androidx.media3.ui.R.id.exo_settings)
+  settingsButton?.visibility = if (visible) {
+    android.view.View.VISIBLE
+  } else {
+    android.view.View.GONE
+  }
+}
+
+@androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
+internal fun PlayerView.setPlayPauseButtonVisibility(visible: Boolean) {
+  val playPauseButton = findViewById<android.widget.ImageButton>(androidx.media3.ui.R.id.exo_play_pause)
+  playPauseButton?.visibility = if (visible) {
+    android.view.View.VISIBLE
+  } else {
+    android.view.View.GONE
+  }
+}
+
+@androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
+internal fun PlayerView.setBottomBarVisibility(visible: Boolean) {
+  val bottomBar = findViewById<android.view.ViewGroup>(androidx.media3.ui.R.id.exo_bottom_bar)
+  bottomBar?.visibility = if (visible) {
+    android.view.View.VISIBLE
+  } else {
+    android.view.View.GONE
+  }
+
+  val progressBar = findViewById<DefaultTimeBar>(androidx.media3.ui.R.id.exo_progress)
+  progressBar?.visibility = if (visible) {
+    android.view.View.VISIBLE
+  } else {
+    android.view.View.GONE
+  }
+}
+
+@androidx.annotation.OptIn(androidx.media3.common.util.UnstableApi::class)
+internal fun PlayerView.applyButtonOptions(
+  config: expo.modules.video.records.ButtonOptions,
+  requiresLinearPlayback: Boolean = false
+) {
+  setShowFastForwardButton(!requiresLinearPlayback && config.showSeekForward)
+  setShowRewindButton(!requiresLinearPlayback && config.showSeekBackward)
+  setShowPreviousButton(!requiresLinearPlayback && config.showPrevious)
+  setShowNextButton(!requiresLinearPlayback && config.showNext)
+  setSettingsButtonVisibility(config.showSettings)
+  setPlayPauseButtonVisibility(config.showPlayPause)
+  setBottomBarVisibility(config.showBottomBar)
+}

package/android/src/main/java/expo/modules/video/VideoModule.kt

@@ -1,5 +1,3 @@
-@file:OptIn(EitherType::class)
-
 package expo.modules.video
 
 import android.net.Uri
@@ -8,7 +6,6 @@ import androidx.media3.common.Player.REPEAT_MODE_OFF
 import androidx.media3.common.Player.REPEAT_MODE_ONE
 import androidx.media3.common.util.UnstableApi
 import expo.modules.kotlin.Promise
-import expo.modules.kotlin.apifeatures.EitherType
 import expo.modules.kotlin.functions.Coroutine
 import expo.modules.kotlin.functions.Queues
 import expo.modules.kotlin.modules.Module
@@ -19,6 +16,8 @@ import expo.modules.video.enums.AudioMixingMode
 import expo.modules.video.enums.ContentFit
 import expo.modules.video.player.VideoPlayer
 import expo.modules.video.records.BufferOptions
+import expo.modules.video.records.PlayerBuilderOptions
+import expo.modules.video.records.ButtonOptions
 import expo.modules.video.records.FullscreenOptions
 import expo.modules.video.records.SubtitleTrack
 import expo.modules.video.records.AudioTrack
@@ -72,8 +71,8 @@ class VideoModule : Module() {
     }
 
     Class(VideoPlayer::class) {
-      Constructor { source: VideoSource? ->
-        val player = VideoPlayer(appContext.throwingActivity.applicationContext, appContext, source)
+      Constructor { source: VideoSource?, /* useSynchronousReplace - iOS-only */ _: Boolean?, playerBuilderOptions: PlayerBuilderOptions? ->
+        val player = VideoPlayer(appContext.throwingActivity.applicationContext, appContext, source, playerBuilderOptions)
         appContext.mainQueue.launch {
           player.prepare()
         }
@@ -410,9 +409,10 @@ private inline fun <reified T : VideoView> ViewDefinitionBuilder<T>.VideoViewCom
     }
   }
   Prop("requiresLinearPlayback") { view: T, requiresLinearPlayback: Boolean? ->
-    val linearPlayback = requiresLinearPlayback ?: false
-    view.playerView.applyRequiresLinearPlayback(linearPlayback)
-    view.videoPlayer?.requiresLinearPlayback = linearPlayback
+    view.requiresLinearPlayback = requiresLinearPlayback ?: false
+  }
+  Prop("buttonOptions") { view: T, buttonOptions: ButtonOptions? ->
+    view.buttonOptions = buttonOptions ?: ButtonOptions()
   }
   Prop("useExoShutter") { view: T, useExoShutter: Boolean? ->
     view.useExoShutter = useExoShutter

package/android/src/main/java/expo/modules/video/VideoView.kt

@@ -26,6 +26,7 @@ import expo.modules.video.player.VideoPlayer
 import expo.modules.video.listeners.VideoPlayerListener
 import expo.modules.video.listeners.VideoViewListener
 import expo.modules.video.records.AudioTrack
+import expo.modules.video.records.ButtonOptions
 import expo.modules.video.records.SubtitleTrack
 import expo.modules.video.records.VideoSource
 import expo.modules.video.records.VideoTrack
@@ -57,11 +58,25 @@ open class VideoView(context: Context, appContext: AppContext, useTextureView: B
   var wasAutoPaused: Boolean = false
   var isInFullscreen: Boolean = false
     private set
-  var showsSubtitlesButton = false
+  var currentTrackHasSubtitles = false
     private set
   var showsAudioTracksButton = false
     private set
 
+  var requiresLinearPlayback: Boolean = false
+    set(value) {
+      field = value
+      videoPlayer?.requiresLinearPlayback = value
+      playerView.applyRequiresLinearPlayback(value)
+      applyButtonSettings()
+    }
+
+  var buttonOptions: ButtonOptions = ButtonOptions()
+    set(value) {
+      field = value
+      applyButtonSettings()
+    }
+
   private var listeners = mutableListOf<WeakReference<VideoViewListener>>()
   private val currentActivity = appContext.throwingActivity
   private val decorView = currentActivity.window.decorView
@@ -131,8 +146,9 @@ open class VideoView(context: Context, appContext: AppContext, useTextureView: B
 
   var useNativeControls: Boolean = true
     set(value) {
+      val shouldShowSubtitle = value && (buttonOptions.showSubtitles ?: currentTrackHasSubtitles)
       playerView.useController = value
-      playerView.setShowSubtitleButton(value)
+      playerView.setShowSubtitleButton(shouldShowSubtitle)
       field = value
     }
 
@@ -291,9 +307,9 @@ open class VideoView(context: Context, appContext: AppContext, useTextureView: B
   }
 
   override fun onTracksChanged(player: VideoPlayer, tracks: Tracks) {
-    showsSubtitlesButton = player.subtitles.availableSubtitleTracks.isNotEmpty()
+    currentTrackHasSubtitles = player.subtitles.availableSubtitleTracks.isNotEmpty()
     showsAudioTracksButton = player.audioTracks.availableAudioTracks.size > 1
-    playerView.setShowSubtitleButton(showsSubtitlesButton)
+    playerView.setShowSubtitleButton(buttonOptions.showSubtitles ?: currentTrackHasSubtitles)
     super.onTracksChanged(player, tracks)
   }
 
@@ -407,6 +423,12 @@ open class VideoView(context: Context, appContext: AppContext, useTextureView: B
     }
   }
 
+  private fun applyButtonSettings() {
+    val shouldShowSubtitle = buttonOptions.showSubtitles ?: currentTrackHasSubtitles
+    playerView.applyButtonOptions(buttonOptions, requiresLinearPlayback)
+    playerView.setShowSubtitleButton(shouldShowSubtitle)
+  }
+
   companion object {
     fun isPictureInPictureSupported(currentActivity: Activity): Boolean {
       return Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && currentActivity.packageManager.hasSystemFeature(

package/android/src/main/java/expo/modules/video/player/FirstFrameEventGenerator.kt

@@ -28,10 +28,9 @@ internal class FirstFrameEventGenerator(
   appContext: AppContext,
   videoPlayer: VideoPlayer,
   private val currentViewReference: MutableWeakReference<VideoView?>,
-  private val onFirstFrameRendered: () -> Unit
+  private var onFirstFrameRendered: (() -> Unit)?
 ) : Player.Listener, VideoPlayerListener {
   private val videoPlayerReference = WeakReference(videoPlayer)
-  private val weakAppContext = WeakReference(appContext)
   private var hasPendingOnFirstFrame = false
   internal var hasSentFirstFrameForCurrentMediaItem = false
     private set
@@ -45,12 +44,11 @@ internal class FirstFrameEventGenerator(
     }
   }
 
+  @MainThread
   fun release() {
     videoPlayerReference.get()?.removeListener(this)
-
-    weakAppContext.get()?.mainQueue?.launch {
-      videoPlayerReference.get()?.player?.removeListener(this@FirstFrameEventGenerator)
-    }
+    videoPlayerReference.get()?.player?.removeListener(this)
+    onFirstFrameRendered = null
   }
 
   override fun onRenderedFirstFrame() {
@@ -80,7 +78,7 @@ internal class FirstFrameEventGenerator(
   // We want to match the behavior across platforms, so we limit the number of event emissions.
   private fun maybeCallOnFirstFrameRendered() {
     if (!hasSentFirstFrameForCurrentMediaItem || !hasSentFirstFrameForCurrentVideoView) {
-      onFirstFrameRendered()
+      onFirstFrameRendered?.invoke()
     }
     hasPendingOnFirstFrame = false
     hasSentFirstFrameForCurrentMediaItem = true

package/android/src/main/java/expo/modules/video/player/VideoPlayer.kt

@@ -20,6 +20,7 @@ import androidx.media3.exoplayer.DecoderReuseEvaluation
 import androidx.media3.exoplayer.DefaultRenderersFactory
 import androidx.media3.exoplayer.ExoPlayer
 import androidx.media3.exoplayer.analytics.AnalyticsListener
+import androidx.media3.exoplayer.hls.HlsManifest
 import androidx.media3.exoplayer.trackselection.DefaultTrackSelector
 import androidx.media3.session.MediaSession
 import androidx.media3.ui.PlayerView
@@ -47,13 +48,17 @@ import expo.modules.video.records.VideoSource
 import expo.modules.video.utils.MutableWeakReference
 import expo.modules.video.records.VideoTrack
 import expo.modules.video.utils.buildBasicMediaSession
+import kotlinx.coroutines.DelicateCoroutinesApi
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.GlobalScope
 import kotlinx.coroutines.launch
 import java.io.FileInputStream
 import java.lang.ref.WeakReference
+import kotlin.time.DurationUnit
 
 // https://developer.android.com/guide/topics/media/media3/getting-started/migration-guide#improvements_in_media3
 @UnstableApi
-class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSource?) : AutoCloseable, SharedObject(appContext), IntervalUpdateEmitter {
+class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSource?, playerBuilderOptions: expo.modules.video.records.PlayerBuilderOptions? = null) : AutoCloseable, SharedObject(appContext), IntervalUpdateEmitter {
   // This improves the performance of playing DRM-protected content
   private var renderersFactory = DefaultRenderersFactory(context)
     .forceEnableMediaCodecAsynchronousQueueing()
@@ -70,9 +75,16 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
 
   val player = ExoPlayer
     .Builder(context, renderersFactory)
-    .setLooper(context.mainLooper)
-    .setLoadControl(loadControl)
-    .build()
+    .apply {
+      setLooper(context.mainLooper)
+      setLoadControl(loadControl)
+      playerBuilderOptions?.seekBackwardIncrement?.let {
+        setSeekBackIncrementMs((it).toLong(DurationUnit.MILLISECONDS).coerceIn(1, 999_000))
+      }
+      playerBuilderOptions?.seekForwardIncrement?.let {
+        setSeekForwardIncrementMs((it).toLong(DurationUnit.MILLISECONDS).coerceIn(1, 999_000))
+      }
+    }.build()
 
   internal val firstFrameEventGenerator: FirstFrameEventGenerator
   val serviceConnection = PlaybackServiceConnection(WeakReference(this), appContext)
@@ -238,7 +250,8 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
       val newAudioTracks = audioTracks.availableAudioTracks
       val newCurrentSubtitleTrack = subtitles.currentSubtitleTrack
       val newCurrentAudioTrack = audioTracks.currentAudioTrack
-      availableVideoTracks = tracks.toVideoTracks()
+      val hlsManifest = player.currentManifest as? HlsManifest
+      availableVideoTracks = tracks.toVideoTracks(hlsManifest)
       refreshPlaybackInfo()
 
       if (isLoadingNewSource) {
@@ -346,7 +359,17 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
     }
   }
 
+  @kotlin.OptIn(DelicateCoroutinesApi::class)
   override fun close() {
+    // Releases the listeners from VideoPlayerKeepAwake
+    keepScreenOnWhilePlaying = false
+
+    intervalUpdateClock.interval = 0L
+
+    synchronized(listeners) {
+      listeners.clear()
+    }
+
     if (serviceConnection.isConnected) {
       appContext?.reactContext?.unbindService(serviceConnection)
     }
@@ -355,19 +378,20 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
 
     VideoManager.unregisterVideoPlayer(this@VideoPlayer)
 
-    appContext?.mainQueue?.launch {
+    // Run on global scope (not appContext.mainQueue) so that reloading doesn't cancel the release process
+    // https://github.com/expo/expo/blob/cdf592a7fea56fc01b0149e9b2e5dbd294bcdc4c/packages/expo-modules-core/android/src/main/java/expo/modules/kotlin/AppContext.kt#L277-L279
+    GlobalScope.launch(Dispatchers.Main) {
       firstFrameEventGenerator.release()
       player.removeListener(playerListener)
+      player.removeAnalyticsListener(analyticsListener)
       player.release()
     }
     uncommittedSource = null
     commitedSource = null
-    // Releases the listeners from VideoPlayerKeepAwake
-    keepScreenOnWhilePlaying = false
   }
 
-  override fun deallocate() {
-    super.deallocate()
+  override fun sharedObjectDidRelease() {
+    super.sharedObjectDidRelease()
     close()
   }
 
@@ -548,17 +572,23 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
 // Extension functions
 
 @OptIn(UnstableApi::class)
-private fun Tracks.toVideoTracks(): List<VideoTrack> {
+private fun Tracks.toVideoTracks(sourceManifest: HlsManifest?): List<VideoTrack> {
   val videoTracks = mutableListOf<VideoTrack?>()
   for (group in this.groups) {
     for (i in 0 until group.length) {
       val format = group.getTrackFormat(i)
       val isSupported = group.isTrackSupported(i)
+      val hlsVariant = sourceManifest?.multivariantPlaylist?.variants?.firstOrNull {
+        it.format.id == format.id
+      }
+
+      // We provide the variant url only for HLS sources
+      val variantUrl = hlsVariant?.url
 
       if (!MimeTypes.isVideo(format.sampleMimeType)) {
         continue
       }
-      videoTracks.add(VideoTrack.fromFormat(format, isSupported))
+      videoTracks.add(VideoTrack.fromFormat(format, isSupported, variantUrl))
     }
   }
   return videoTracks.filterNotNull()

package/android/src/main/java/expo/modules/video/records/ButtonOptions.kt

@@ -0,0 +1,15 @@
+package expo.modules.video.records
+
+import expo.modules.kotlin.records.Field
+import expo.modules.kotlin.records.Record
+
+data class ButtonOptions(
+  @Field val showNext: Boolean = false,
+  @Field val showPrevious: Boolean = false,
+  @Field val showSeekForward: Boolean = true,
+  @Field val showSeekBackward: Boolean = true,
+  @Field val showSubtitles: Boolean? = null,
+  @Field val showSettings: Boolean = true,
+  @Field val showPlayPause: Boolean = true,
+  @Field val showBottomBar: Boolean = true
+) : Record

package/android/src/main/java/expo/modules/video/records/PlayerBuilderOptions.kt

@@ -0,0 +1,13 @@
+package expo.modules.video.records
+
+import androidx.media3.common.util.UnstableApi
+import expo.modules.kotlin.records.Field
+import expo.modules.kotlin.records.Record
+import java.io.Serializable
+import kotlin.time.Duration
+
+@UnstableApi
+class PlayerBuilderOptions(
+  @Field var seekBackwardIncrement: Duration? = null,
+  @Field var seekForwardIncrement: Duration? = null
+) : Record, Serializable

package/android/src/main/java/expo/modules/video/records/Tracks.kt

@@ -1,5 +1,6 @@
 package expo.modules.video.records
 
+import android.net.Uri
 import androidx.annotation.OptIn
 import androidx.media3.common.Format
 import androidx.media3.common.util.UnstableApi
@@ -11,7 +12,10 @@ import java.util.Locale
 class SubtitleTrack(
   @Field val id: String,
   @Field val language: String?,
-  @Field val label: String?
+  @Field val label: String?,
+  @Field val name: String?,
+  @Field val isDefault: Boolean,
+  @Field val autoSelect: Boolean
 ) : Record, Serializable {
   companion object {
     fun fromFormat(format: Format?): SubtitleTrack? {
@@ -19,11 +23,17 @@ class SubtitleTrack(
       val id = format.id ?: return null
       val language = format.language ?: return null
       val label = Locale(language).displayLanguage
+      val name = format.label
+      val isDefault = (format.selectionFlags and androidx.media3.common.C.SELECTION_FLAG_DEFAULT) != 0
+      val autoSelect = (format.selectionFlags and androidx.media3.common.C.SELECTION_FLAG_AUTOSELECT) != 0
 
       return SubtitleTrack(
         id = id,
         language = language,
-        label = label
+        label = label,
+        name = name,
+        isDefault = isDefault,
+        autoSelect = autoSelect
       )
     }
   }
@@ -32,7 +42,10 @@ class SubtitleTrack(
 class AudioTrack(
   @Field val id: String,
   @Field val language: String?,
-  @Field val label: String?
+  @Field val label: String?,
+  @Field val name: String?,
+  @Field val isDefault: Boolean,
+  @Field val autoSelect: Boolean
 ) : Record, Serializable {
   companion object {
     fun fromFormat(format: Format?): AudioTrack? {
@@ -40,11 +53,17 @@ class AudioTrack(
       val id = format.id ?: return null
       val language = format.language
       val label = language?.let { Locale(it).displayLanguage } ?: "Unknown"
+      val name = format.label
+      val isDefault = (format.selectionFlags and androidx.media3.common.C.SELECTION_FLAG_DEFAULT) != 0
+      val autoSelect = (format.selectionFlags and androidx.media3.common.C.SELECTION_FLAG_AUTOSELECT) != 0
 
       return AudioTrack(
         id = id,
         language = language,
-        label = label
+        label = label,
+        name = name,
+        isDefault = isDefault,
+        autoSelect = autoSelect
       )
     }
   }
@@ -53,6 +72,7 @@ class AudioTrack(
 @OptIn(UnstableApi::class)
 class VideoTrack(
   @Field val id: String,
+  @Field val url: Uri?,
   @Field val size: VideoSize,
   @Field val mimeType: String?,
   @Field val isSupported: Boolean = true,
@@ -63,7 +83,7 @@ class VideoTrack(
   var format: Format? = null
 ) : Record, Serializable {
   companion object {
-    fun fromFormat(format: Format?, isSupported: Boolean): VideoTrack? {
+    fun fromFormat(format: Format?, isSupported: Boolean, variantUrl: Uri?): VideoTrack? {
       val id = format?.id ?: return null
       val size = VideoSize(format)
       val mimeType = format.sampleMimeType
@@ -73,6 +93,7 @@ class VideoTrack(
 
       return VideoTrack(
         id = id,
+        url = variantUrl,
         size = size,
         mimeType = mimeType,
         isSupported = isSupported,

package/build/VideoPlayer.d.ts

@@ -1,15 +1,17 @@
-import { VideoSource, VideoPlayer } from './VideoPlayer.types';
+import { VideoSource, VideoPlayer, PlayerBuilderOptions } from './VideoPlayer.types';
 /**
  * Creates a direct instance of `VideoPlayer` that doesn't release automatically.
  *
  * > **info** For most use cases you should use the [`useVideoPlayer`](#usevideoplayer) hook instead. See the [Using the VideoPlayer Directly](#using-the-videoplayer-directly) section for more details.
- * @param source
+ * @param source -  A video source that is used to initialize the player.
+ * @param playerBuilderOptions - Options to apply to the Android player builder before the native constructor is invoked.
  */
-export declare function createVideoPlayer(source: VideoSource): VideoPlayer;
+export declare function createVideoPlayer(source: VideoSource, playerBuilderOptions?: PlayerBuilderOptions): VideoPlayer;
 /**
  * Creates a `VideoPlayer`, which will be automatically cleaned up when the component is unmounted.
  * @param source - A video source that is used to initialize the player.
  * @param setup - A function that allows setting up the player. It will run after the player is created.
+ * @param playerBuilderOptions - Options to apply to the Android player builder before the native constructor is invoked.
  */
-export declare function useVideoPlayer(source: VideoSource, setup?: (player: VideoPlayer) => void): VideoPlayer;
+export declare function useVideoPlayer(source: VideoSource, setup?: (player: VideoPlayer) => void, playerBuilderOptions?: PlayerBuilderOptions): VideoPlayer;
 //# sourceMappingURL=VideoPlayer.d.ts.map

package/build/VideoPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAsB/D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAElE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACpC,WAAW,CAQb"}
+{"version":3,"file":"VideoPlayer.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAsBrF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,WAAW,CAGb;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,EACrC,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,WAAW,CAQb"}