expo-video 1.2.5 → 1.2.7

package/CHANGELOG.md

@@ -10,6 +10,35 @@
 
 ### 💡 Others
 
+## 1.2.7 — 2024-09-26
+
+### 🐛 Bug fixes
+
+- [Web] Fix invalid `resolveAssetSource` for web. ([#31664](https://github.com/expo/expo/pull/31664) by [@behenate](https://github.com/behenate))
+
+## 1.2.6 — 2024-09-13
+
+### 🛠 Breaking changes
+
+- `showNowPlayingNotification` property of the player now defaults to `false`. ([#31261](https://github.com/expo/expo/pull/31261) by [@behenate](https://github.com/behenate))
+
+### 🎉 New features
+
+- [Android][iOS] Add properties for more advanced live stream configuration. ([#30648](https://github.com/expo/expo/pull/30648) by [@justjoostnl](https://github.com/justjoostnl))
+- [iOS] Add live indicator in the now playing info. ([#30629](https://github.com/expo/expo/pull/30629) by [@justjoostnl](https://github.com/justjoostnl))
+- Add fullscreen enter and exit events. ([#30922](https://github.com/expo/expo/pull/30922) by [@fobos531](https://github.com/fobos531))
+- Add support for playback of local assets imported with the `require` function. ([#30837](https://github.com/expo/expo/pull/30837) by [@behenate](https://github.com/behenate))
+
+### 🐛 Bug fixes
+
+- [iOS] Fixed `player.currentTime` being `NaN` when source is not provided and `player.duration` being `NaN` inside the hook callback when the source is updated. ([#31011](https://github.com/expo/expo/pull/31011) by [@AlirezaHadjar](https://github.com/AlirezaHadjar))
+- [Android] Fix wrong event being sent when the volume is changed. ([#30891](https://github.com/expo/expo/pull/30891) by [@behenate](https://github.com/behenate))
+
+### 💡 Others
+
+- Bump media3 version to 1.4.0. ([#31239](https://github.com/expo/expo/pull/31239) by [@behenate](https://github.com/behenate))
+- [Android] The media will now be buffered even when the player is unmounted to match iOS behavior. ([#30626](https://github.com/expo/expo/pull/30626) by [@behenate](https://github.com/behenate))
+
 ## 1.2.5 — 2024-08-20
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'host.exp.exponent'
-version = '1.2.5'
+version = '1.2.7'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -14,14 +14,15 @@ android {
   namespace "expo.modules.video"
   defaultConfig {
     versionCode 1
-    versionName '1.2.5'
+    versionName '1.2.7'
   }
 }
 
 dependencies {
   implementation 'com.facebook.react:react-android'
 
-  def androidxMedia3Version = "1.3.1"
+  // Remember to keep this in sync with the version in `expo-audio`
+  def androidxMedia3Version = "1.4.0"
   implementation "androidx.media3:media3-session:${androidxMedia3Version}"
   implementation "androidx.media3:media3-exoplayer:${androidxMedia3Version}"
   implementation "androidx.media3:media3-exoplayer-dash:${androidxMedia3Version}"

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

@@ -23,7 +23,7 @@ sealed class PlayerEvent {
   }
 
   data class VolumeChanged(val newValue: VolumeEvent, val oldValue: VolumeEvent?) : PlayerEvent() {
-    override val name = "playingChange"
+    override val name = "volumeChange"
     override val arguments = arrayOf(newValue, oldValue)
   }
 

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

@@ -52,7 +52,7 @@ object VideoManager {
     }
 
     if (videoPlayersToVideoViews[videoPlayer]?.size == 1) {
-      videoPlayer.serviceConnection.playbackServiceBinder?.service?.registerPlayer(videoPlayer.player)
+      videoPlayer.serviceConnection.playbackServiceBinder?.service?.registerPlayer(videoPlayer)
     }
   }
 

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

@@ -4,9 +4,11 @@ package expo.modules.video
 
 import android.app.Activity
 import android.net.Uri
+import androidx.media3.common.C
 import androidx.media3.common.PlaybackParameters
 import androidx.media3.common.Player.REPEAT_MODE_OFF
 import androidx.media3.common.Player.REPEAT_MODE_ONE
+import androidx.media3.common.Timeline
 import com.facebook.react.uimanager.PixelUtil
 import com.facebook.react.uimanager.Spacing
 import com.facebook.react.uimanager.ViewProps
@@ -43,12 +45,13 @@ class VideoModule : Module() {
     View(VideoView::class) {
       Events(
         "onPictureInPictureStart",
-        "onPictureInPictureStop"
+        "onPictureInPictureStop",
+        "onFullscreenEnter",
+        "onFullscreenExit"
       )
 
       Prop("player") { view: VideoView, player: VideoPlayer ->
         view.videoPlayer = player
-        player.prepare()
       }
 
       Prop("nativeControls") { view: VideoView, useNativeControls: Boolean ->
@@ -149,7 +152,11 @@ class VideoModule : Module() {
 
     Class(VideoPlayer::class) {
       Constructor { source: VideoSource? ->
-        VideoPlayer(activity.applicationContext, appContext, source)
+        val player = VideoPlayer(activity.applicationContext, appContext, source)
+        appContext.mainQueue.launch {
+          player.prepare()
+        }
+        return@Constructor player
       }
 
       Property("playing")
@@ -193,6 +200,34 @@ class VideoModule : Module() {
           }
         }
 
+      Property("currentLiveTimestamp")
+        .get { ref: VideoPlayer ->
+          // TODO: same as `currentTime`
+          runBlocking(appContext.mainQueue.coroutineContext) {
+            val window = Timeline.Window()
+            if (!ref.player.currentTimeline.isEmpty) {
+              ref.player.currentTimeline.getWindow(ref.player.currentMediaItemIndex, window)
+            }
+            if (window.windowStartTimeMs == C.TIME_UNSET) {
+              null
+            } else {
+              window.windowStartTimeMs + ref.player.currentPosition
+            }
+          }
+        }
+
+      Property("currentOffsetFromLive")
+        .get { ref: VideoPlayer ->
+          // TODO: same as `currentTime`
+          runBlocking(appContext.mainQueue.coroutineContext) {
+            if (ref.player.currentLiveOffset == C.TIME_UNSET) {
+              null
+            } else {
+              ref.player.currentLiveOffset / 1000f
+            }
+          }
+        }
+
       Property("duration")
         .get { ref: VideoPlayer ->
           ref.duration
@@ -284,9 +319,7 @@ class VideoModule : Module() {
 
         appContext.mainQueue.launch {
           ref.uncommittedSource = videoSource
-          if (VideoManager.isVideoPlayerAttachedToView(ref)) {
-            ref.prepare()
-          }
+          ref.prepare()
         }
       }
 

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

@@ -36,7 +36,7 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
     .setLooper(context.mainLooper)
     .build()
 
-  val serviceConnection = PlaybackServiceConnection(WeakReference(player))
+  val serviceConnection = PlaybackServiceConnection(WeakReference(this))
 
   var playing by IgnoreSameSet(false) { new, old ->
     sendEvent(PlayerEvent.IsPlayingChanged(new, old))
@@ -57,7 +57,7 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
       field = preservesPitch
       playbackParameters = applyPitchCorrection(playbackParameters)
     }
-  var showNowPlayingNotification = true
+  var showNowPlayingNotification = false
     set(value) {
       field = value
       serviceConnection.playbackServiceBinder?.service?.setShowNotification(value, this.player)
@@ -67,11 +67,12 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
 
   var volume: Float by IgnoreSameSet(1f) { new: Float, old: Float ->
     player.volume = if (muted) 0f else new
+    userVolume = volume
     sendEvent(PlayerEvent.VolumeChanged(VolumeEvent(new, muted), VolumeEvent(old, muted)))
   }
 
   var muted: Boolean by IgnoreSameSet(false) { new: Boolean, old: Boolean ->
-    volume = if (new) 0f else userVolume
+    player.volume = if (new) 0f else userVolume
     sendEvent(PlayerEvent.VolumeChanged(VolumeEvent(volume, new), VolumeEvent(volume, old)))
   }
 
@@ -113,7 +114,9 @@ class VideoPlayer(val context: Context, appContext: AppContext, source: VideoSou
     }
 
     override fun onVolumeChanged(volume: Float) {
-      this@VideoPlayer.volume = volume
+      if (!muted) {
+        this@VideoPlayer.volume = volume
+      }
     }
 
     override fun onPlaybackParametersChanged(playbackParameters: PlaybackParameters) {

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

@@ -36,6 +36,8 @@ class VideoView(context: Context, appContext: AppContext) : ExpoView(context, ap
   val playerView: PlayerView = PlayerView(context.applicationContext)
   val onPictureInPictureStart by EventDispatcher<Unit>()
   val onPictureInPictureStop by EventDispatcher<Unit>()
+  val onFullscreenEnter by EventDispatcher<Unit>()
+  val onFullscreenExit by EventDispatcher<Unit>()
 
   var willEnterPiP: Boolean = false
   var isInFullscreen: Boolean = false
@@ -154,6 +156,7 @@ class VideoView(context: Context, appContext: AppContext) : ExpoView(context, ap
       @Suppress("DEPRECATION")
       currentActivity.overridePendingTransition(0, 0)
     }
+    onFullscreenEnter(Unit)
     isInFullscreen = true
   }
 
@@ -162,6 +165,7 @@ class VideoView(context: Context, appContext: AppContext) : ExpoView(context, ap
     val fullScreenButton: ImageButton = playerView.findViewById(androidx.media3.ui.R.id.exo_fullscreen)
     fullScreenButton.setImageResource(androidx.media3.ui.R.drawable.exo_icon_fullscreen_enter)
     videoPlayer?.changePlayerView(playerView)
+    onFullscreenExit(Unit)
     isInFullscreen = false
   }
 

package/android/src/main/java/expo/modules/video/playbackService/ExpoVideoPlaybackService.kt

@@ -20,6 +20,7 @@ import androidx.media3.session.SessionCommand
 import com.google.common.collect.ImmutableList
 import expo.modules.kotlin.AppContext
 import expo.modules.video.R
+import expo.modules.video.VideoPlayer
 
 class PlaybackServiceBinder(val service: ExpoVideoPlaybackService) : Binder()
 
@@ -51,7 +52,8 @@ class ExpoVideoPlaybackService : MediaSessionService() {
     }
   }
 
-  fun registerPlayer(player: ExoPlayer) {
+  fun registerPlayer(videoPlayer: VideoPlayer) {
+    val player = videoPlayer.player
     if (mediaSessions[player] != null) {
       return
     }
@@ -64,6 +66,7 @@ class ExpoVideoPlaybackService : MediaSessionService() {
 
     mediaSessions[player] = mediaSession
     addSession(mediaSession)
+    setShowNotification(videoPlayer.showNowPlayingNotification, player)
   }
 
   fun unregisterPlayer(player: ExoPlayer) {
@@ -82,7 +85,7 @@ class ExpoVideoPlaybackService : MediaSessionService() {
   }
 
   override fun onUpdateNotification(session: MediaSession, startInForegroundRequired: Boolean) {
-    if (session.sessionExtras.getBoolean(SESSION_SHOW_NOTIFICATION, true)) {
+    if (session.sessionExtras.getBoolean(SESSION_SHOW_NOTIFICATION, false)) {
       createNotification(session)
     } else {
       (session.player as? ExoPlayer)?.let {

package/android/src/main/java/expo/modules/video/playbackService/PlaybackServiceConnection.kt

@@ -4,14 +4,14 @@ import android.content.ComponentName
 import android.content.ServiceConnection
 import android.os.IBinder
 import android.util.Log
-import androidx.media3.exoplayer.ExoPlayer
+import expo.modules.video.VideoPlayer
 import java.lang.ref.WeakReference
 
-class PlaybackServiceConnection(val player: WeakReference<ExoPlayer>) : ServiceConnection {
+class PlaybackServiceConnection(val player: WeakReference<VideoPlayer>) : ServiceConnection {
   var playbackServiceBinder: PlaybackServiceBinder? = null
 
   override fun onServiceConnected(componentName: ComponentName, binder: IBinder) {
-    val player: ExoPlayer = player.get() ?: return
+    val player = player.get() ?: return
     playbackServiceBinder = binder as? PlaybackServiceBinder
     playbackServiceBinder?.service?.registerPlayer(player) ?: run {
       Log.w(

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

@@ -1,10 +1,16 @@
 package expo.modules.video.records
+
+import android.annotation.SuppressLint
+import android.content.ContentResolver
 import android.content.Context
 import android.net.Uri
+import android.util.Log
 import androidx.annotation.OptIn
 import androidx.media3.common.MediaItem
 import androidx.media3.common.MediaMetadata
 import androidx.media3.common.util.UnstableApi
+import androidx.media3.datasource.DataSpec
+import androidx.media3.datasource.RawResourceDataSource
 import androidx.media3.exoplayer.source.MediaSource
 import expo.modules.kotlin.records.Field
 import expo.modules.kotlin.records.Record
@@ -35,10 +41,10 @@ class VideoSource(
     return buildMediaSourceWithHeaders(context, this)
   }
 
-  fun toMediaItem() = MediaItem
+  fun toMediaItem(context: Context) = MediaItem
     .Builder()
     .apply {
-      setUri(uri)
+      setUri(parseLocalAssetId(uri, context))
       setMediaId(toMediaId())
       drm?.let {
         if (it.type.isSupported()) {
@@ -57,4 +63,31 @@ class VideoSource(
       )
     }
     .build()
+
+  // Using `resolveAssetSource` to generate a local asset URI returns a resource name for android release builds
+  // we have to get the raw resource URI to play the video
+  @SuppressLint("DiscouragedApi") // AFAIK, in this case, there's no other way to get the resource URI
+  private fun parseLocalAssetId(uri: Uri?, context: Context): Uri? {
+    if (uri == null || uri.scheme != null) {
+      return uri
+    }
+    try {
+      val resourceId: Int = context.resources.getIdentifier(
+        uri.toString(),
+        "raw",
+        context.packageName
+      )
+      val parsedUri = Uri.Builder()
+        .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
+        .appendPath(resourceId.toString())
+        .build()
+      val dataSpec = DataSpec(parsedUri)
+      val rawResourceDataSource = RawResourceDataSource(context)
+      rawResourceDataSource.open(dataSpec)
+      return rawResourceDataSource.uri
+    } catch (e: RawResourceDataSource.RawResourceDataSourceException) {
+      Log.e("ExpoVideo", "Error parsing local asset id, falling back to original uri", e)
+      return uri
+    }
+  }
 }

package/android/src/main/java/expo/modules/video/utils/DataSourceUtils.kt

@@ -44,7 +44,7 @@ fun buildMediaSourceFactory(context: Context, dataSourceFactory: DataSource.Fact
 fun buildMediaSourceWithHeaders(context: Context, videoSource: VideoSource): MediaSource {
   val dataSourceFactory = buildDataSourceFactory(context, videoSource)
   val mediaSourceFactory = buildMediaSourceFactory(context, dataSourceFactory)
-  val mediaItem = videoSource.toMediaItem()
+  val mediaItem = videoSource.toMediaItem(context)
   return mediaSourceFactory.createMediaSource(mediaItem)
 }
 

package/build/VideoPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACpC,WAAW,CAQb;;AAED,wBAA6C"}
+{"version":3,"file":"VideoPlayer.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASpE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACpC,WAAW,CAQb;;AAeD,wBAA6C"}

package/build/VideoPlayer.js

@@ -1,17 +1,35 @@
 import { useReleasingSharedObject } from 'expo-modules-core';
 import NativeVideoModule from './NativeVideoModule';
+import resolveAssetSource from './resolveAssetSource';
+// TODO: Temporary solution until we develop a way of overriding prototypes that won't break the lazy loading of the module.
+const replace = NativeVideoModule.VideoPlayer.prototype.replace;
+NativeVideoModule.VideoPlayer.prototype.replace = function (source) {
+    return replace.call(this, parseSource(source));
+};
 /**
  * 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.
  */
 export function useVideoPlayer(source, setup) {
-    const parsedSource = typeof source === 'string' ? { uri: source } : source;
+    const parsedSource = parseSource(source);
     return useReleasingSharedObject(() => {
         const player = new NativeVideoModule.VideoPlayer(parsedSource);
         setup?.(player);
         return player;
     }, [JSON.stringify(parsedSource)]);
 }
+function parseSource(source) {
+    if (typeof source === 'number') {
+        return { uri: resolveAssetSource(source).uri };
+    }
+    else if (typeof source === 'string') {
+        return { uri: source };
+    }
+    if (typeof source?.assetId === 'number' && !source.uri) {
+        return { ...source, uri: resolveAssetSource(source.assetId).uri };
+    }
+    return source;
+}
 export default NativeVideoModule.VideoPlayer;
 //# sourceMappingURL=VideoPlayer.js.map

package/build/VideoPlayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.js","sourceRoot":"","sources":["../src/VideoPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAGpD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,KAAqC;IAErC,MAAM,YAAY,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAE3E,OAAO,wBAAwB,CAAC,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC/D,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,eAAe,iBAAiB,CAAC,WAAW,CAAC","sourcesContent":["import { useReleasingSharedObject } from 'expo-modules-core';\n\nimport NativeVideoModule from './NativeVideoModule';\nimport type { VideoPlayer, VideoSource } from './VideoPlayer.types';\n\n/**\n * Creates a `VideoPlayer`, which will be automatically cleaned up when the component is unmounted.\n * @param source - A video source that is used to initialize the player.\n * @param setup - A function that allows setting up the player. It will run after the player is created.\n */\nexport function useVideoPlayer(\n  source: VideoSource,\n  setup?: (player: VideoPlayer) => void\n): VideoPlayer {\n  const parsedSource = typeof source === 'string' ? { uri: source } : source;\n\n  return useReleasingSharedObject(() => {\n    const player = new NativeVideoModule.VideoPlayer(parsedSource);\n    setup?.(player);\n    return player;\n  }, [JSON.stringify(parsedSource)]);\n}\n\nexport default NativeVideoModule.VideoPlayer;\n"]}
+{"version":3,"file":"VideoPlayer.js","sourceRoot":"","sources":["../src/VideoPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,4HAA4H;AAC5H,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC;AAChE,iBAAiB,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,GAAG,UAAU,MAAmB;IAC7E,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,KAAqC;IAErC,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO,wBAAwB,CAAC,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC/D,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,MAAmB;IACtC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC9B,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;KAChD;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QACrC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;KACxB;IAED,IAAI,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;QACtD,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;KACnE;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,eAAe,iBAAiB,CAAC,WAAW,CAAC","sourcesContent":["import { useReleasingSharedObject } from 'expo-modules-core';\n\nimport NativeVideoModule from './NativeVideoModule';\nimport type { VideoPlayer, VideoSource } from './VideoPlayer.types';\nimport resolveAssetSource from './resolveAssetSource';\n\n// TODO: Temporary solution until we develop a way of overriding prototypes that won't break the lazy loading of the module.\nconst replace = NativeVideoModule.VideoPlayer.prototype.replace;\nNativeVideoModule.VideoPlayer.prototype.replace = function (source: VideoSource) {\n  return replace.call(this, parseSource(source));\n};\n\n/**\n * Creates a `VideoPlayer`, which will be automatically cleaned up when the component is unmounted.\n * @param source - A video source that is used to initialize the player.\n * @param setup - A function that allows setting up the player. It will run after the player is created.\n */\nexport function useVideoPlayer(\n  source: VideoSource,\n  setup?: (player: VideoPlayer) => void\n): VideoPlayer {\n  const parsedSource = parseSource(source);\n\n  return useReleasingSharedObject(() => {\n    const player = new NativeVideoModule.VideoPlayer(parsedSource);\n    setup?.(player);\n    return player;\n  }, [JSON.stringify(parsedSource)]);\n}\n\nfunction parseSource(source: VideoSource): VideoSource {\n  if (typeof source === 'number') {\n    return { uri: resolveAssetSource(source).uri };\n  } else if (typeof source === 'string') {\n    return { uri: source };\n  }\n\n  if (typeof source?.assetId === 'number' && !source.uri) {\n    return { ...source, uri: resolveAssetSource(source.assetId).uri };\n  }\n  return source;\n}\n\nexport default NativeVideoModule.VideoPlayer;\n"]}

package/build/VideoPlayer.types.d.ts

@@ -28,6 +28,28 @@ export declare class VideoPlayer extends SharedObject<VideoPlayerEvents> {
      * Setting `currentTime` to a new value seeks the player to the given time.
      */
     currentTime: number;
+    /**
+     * The exact timestamp when the currently displayed video frame was sent from the server,
+     * based on the `EXT-X-PROGRAM-DATE-TIME` tag in the livestream metadata.
+     * If this metadata is missing, this property will return `null`.
+     * > This property is read-only.
+     * @platform android
+     * @platform ios
+     */
+    readonly currentLiveTimestamp: number | null;
+    /**
+     * Float value indicating the latency of the live stream in seconds.
+     * If a livestream doesn't have the required metadata, this will return `null`.
+     * > This property is get-only
+     * @platform android
+     * @platform ios
+     */
+    readonly currentOffsetFromLive: number | null;
+    /**
+     * Float value indicating the time offset from the live in seconds.
+     * @platform ios
+     */
+    targetOffsetFromLive: number;
     /**
      * Float value indicating the duration of the current video in seconds.
      * > This property is get-only
@@ -65,6 +87,10 @@ export declare class VideoPlayer extends SharedObject<VideoPlayerEvents> {
     status: VideoPlayerStatus;
     /**
      * Boolean value determining whether the player should show the now playing notification.
+     *
+     * @default false
+     * @platrorm android
+     * @platform ios
      */
     showNowPlayingNotification: boolean;
     /**
@@ -137,11 +163,18 @@ export type VideoPlayerEvents = {
  * - `error`: The player has encountered an error while loading or playing the video.
  */
 export type VideoPlayerStatus = 'idle' | 'loading' | 'readyToPlay' | 'error';
-export type VideoSource = string | {
+export type VideoSource = string | number | {
     /**
      * The URI of the video.
+     *
+     * This property is exclusive with the `assetId` property. When both are present, the `assetId` will be ignored.
+     */
+    uri?: string;
+    /**
+     * The asset ID of a local video asset, acquired with the `require` function.
+     * This property is exclusive with the `uri` property. When both are present, the `assetId` will be ignored.
      */
-    uri: string;
+    assetId?: number;
     /**
      * Specifies the DRM options which will be used by the player while loading the video.
      */

package/build/VideoPlayer.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.types.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACtE;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,0BAA0B,EAAE,OAAO,CAAC;IAEpC;;;;;OAKG;IACH,uBAAuB,EAAE,OAAO,CAAC;IAEjC;;;OAGG;gBACS,MAAM,EAAE,WAAW;IAE/B;;OAEG;IACH,IAAI,IAAI,IAAI;IAEZ;;OAEG;IACH,KAAK,IAAI,IAAI;IAEb;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAElC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAE7B;;OAEG;IACH,MAAM,IAAI,IAAI;CACf;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,YAAY,CACV,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,iBAAiB,EAC5B,KAAK,CAAC,EAAE,WAAW,GAClB,IAAI,CAAC;IACR;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3E;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IACnE;;OAEG;IACH,SAAS,IAAI,IAAI,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,GAAG,IAAI,CAAC;CACzE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,CAAC;AAE7E,MAAM,MAAM,WAAW,GACnB,MAAM,GACN;IACE;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GACD,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC"}
+{"version":3,"file":"VideoPlayer.types.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.types.ts"],"names":[],"mappings":"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"}

package/build/VideoPlayer.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.types.js","sourceRoot":"","sources":["../src/VideoPlayer.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { SharedObject } from 'expo-modules-core';\n\n/**\n * A class that represents an instance of the video player.\n */\nexport declare class VideoPlayer extends SharedObject<VideoPlayerEvents> {\n  /**\n   * Boolean value whether the player is currently playing.\n   * > This property is get-only, use `play` and `pause` methods to control the playback.\n   */\n  playing: boolean;\n\n  /**\n   * Determines whether the player should automatically replay after reaching the end of the video.\n   * @default false\n   */\n  loop: boolean;\n\n  /**\n   * Boolean value whether the player is currently muted.\n   * Setting this property to `true`/`false` will mute/unmute the player.\n   * @default false\n   */\n  muted: boolean;\n\n  /**\n   * Float value indicating the current playback time in seconds.\n   *\n   * If the player is not yet playing, this value indicates the time position\n   * at which playback will begin once the `play()` method is called.\n   *\n   * Setting `currentTime` to a new value seeks the player to the given time.\n   */\n  currentTime: number;\n\n  /**\n   * Float value indicating the duration of the current video in seconds.\n   * > This property is get-only\n   */\n  duration: number;\n\n  /**\n   * Float value between 0 and 1 representing the current volume.\n   * Muting the player doesn't affect the volume. In other words, when the player is muted, the volume is the same as\n   * when unmuted. Similarly, setting the volume doesn't unmute the player.\n   * @default 1.0\n   */\n  volume: number;\n\n  /**\n   * Boolean value indicating if the player should correct audio pitch when the playback speed changes.\n   * > On web, changing this property is not supported, the player will always correct the pitch.\n   * @default true\n   * @platform android\n   * @platform ios\n   */\n  preservesPitch: boolean;\n\n  /**\n   * Float value between 0 and 16 indicating the current playback speed of the player.\n   * @default 1.0\n   */\n  playbackRate: number;\n\n  /**\n   * Boolean value indicating whether the player is currently playing a live stream.\n   * > This property is get-only\n   */\n  isLive: boolean;\n\n  /**\n   * Indicates the current status of the player.\n   * > This property is get-only\n   */\n  status: VideoPlayerStatus;\n\n  /**\n   * Boolean value determining whether the player should show the now playing notification.\n   */\n  showNowPlayingNotification: boolean;\n\n  /**\n   * Determines whether the player should continue playing after the app enters the background.\n   * @default false\n   * @platform ios\n   * @platform android\n   */\n  staysActiveInBackground: boolean;\n\n  /**\n   * Initializes a new video player instance with the given source.\n   * @hidden\n   */\n  constructor(source: VideoSource);\n\n  /**\n   * Resumes the player.\n   */\n  play(): void;\n\n  /**\n   * Pauses the player.\n   */\n  pause(): void;\n\n  /**\n   * Replaces the current source with a new one.\n   */\n  replace(source: VideoSource): void;\n\n  /**\n   * Seeks the playback by the given number of seconds.\n   */\n  seekBy(seconds: number): void;\n\n  /**\n   * Seeks the playback to the beginning.\n   */\n  replay(): void;\n}\n\n/**\n * Handlers for events which can be emitted by the player.\n */\nexport type VideoPlayerEvents = {\n  /**\n   * Handler for an event emitted when the status of the player changes.\n   */\n  statusChange(\n    newStatus: VideoPlayerStatus,\n    oldStatus: VideoPlayerStatus,\n    error?: PlayerError\n  ): void;\n  /**\n   * Handler for an event emitted when the player starts or stops playback.\n   */\n  playingChange(newIsPlaying: boolean, oldIsPlaying: boolean): void;\n  /**\n   * Handler for an event emitted when the `playbackRate` property of the player changes.\n   */\n  playbackRateChange(newPlaybackRate: number, oldPlaybackRate: number): void;\n  /**\n   * Handler for an event emitted when the `volume` property of the player changes.\n   */\n  volumeChange(newVolume: VolumeEvent, oldVolume: VolumeEvent): void;\n  /**\n   * Handler for an event emitted when the player plays to the end of the current source.\n   */\n  playToEnd(): void;\n  /**\n   * Handler for an event emitted when the current media source of the player changes.\n   */\n  sourceChange(newSource: VideoSource, previousSource: VideoSource): void;\n};\n\n/**\n * Describes the current status of the player.\n * - `idle`: The player is not playing or loading any videos.\n * - `loading`: The player is loading video data from the provided source\n * - `readyToPlay`: The player has loaded enough data to start playing or to continue playback.\n * - `error`: The player has encountered an error while loading or playing the video.\n */\nexport type VideoPlayerStatus = 'idle' | 'loading' | 'readyToPlay' | 'error';\n\nexport type VideoSource =\n  | string\n  | {\n      /**\n       * The URI of the video.\n       */\n      uri: string;\n      /**\n       * Specifies the DRM options which will be used by the player while loading the video.\n       */\n      drm?: DRMOptions;\n      /**\n       * Specifies information which will be displayed in the now playing notification.\n       * When undefined the player will display information contained in the video metadata.\n       */\n      metadata?: VideoMetadata;\n      /**\n       * Specifies headers sent with the video request.\n       * > For DRM license headers use the `headers` field of [`DRMOptions`](#drmoptions).\n       * @platform android\n       * @platform ios\n       */\n      headers?: Record<string, string>;\n    }\n  | null;\n\n/**\n * Contains information about any errors that the player encountered during the playback\n */\nexport type PlayerError = {\n  message: string;\n};\n\n/**\n * Contains information about the current volume and whether the player is muted.\n */\nexport type VolumeEvent = {\n  volume: number;\n  isMuted: boolean;\n};\n\n/**\n * Contains information that will be displayed in the now playing notification when the video is playing.\n */\nexport type VideoMetadata = {\n  /**\n   * The title of the video.\n   */\n  title?: string;\n  /**\n   * Secondary text that will be displayed under the title.\n   */\n  artist?: string;\n};\n\n/**\n * Specifies which type of DRM to use. Android supports Widevine, PlayReady and ClearKey, iOS supports FairPlay.\n */\nexport type DRMType = 'clearkey' | 'fairplay' | 'playready' | 'widevine';\n\n/**\n * Specifies DRM options which will be used by the player while loading the video.\n */\nexport type DRMOptions = {\n  /**\n   * Determines which type of DRM to use.\n   */\n  type: DRMType;\n\n  /**\n   * Determines the license server URL.\n   */\n  licenseServer: string;\n\n  /**\n   * Determines headers sent to the license server on license requests.\n   */\n  headers?: { [key: string]: string };\n\n  /**\n   * Specifies whether the DRM is a multi-key DRM.\n   * @platform android\n   */\n  multiKey?: boolean;\n\n  /**\n   * Specifies the content ID of the stream.\n   * @platform ios\n   */\n  contentId?: string;\n\n  /**\n   * Specifies the certificate URL for the FairPlay DRM.\n   * @platform ios\n   */\n  certificateUrl?: string;\n\n  /**\n   * Specifies the base64 encoded certificate data for the FairPlay DRM.\n   * When this property is set, the `certificateUrl` property is ignored.\n   * @platform ios\n   */\n  base64CertificateData?: string;\n};\n"]}
+{"version":3,"file":"VideoPlayer.types.js","sourceRoot":"","sources":["../src/VideoPlayer.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { SharedObject } from 'expo-modules-core';\n\n/**\n * A class that represents an instance of the video player.\n */\nexport declare class VideoPlayer extends SharedObject<VideoPlayerEvents> {\n  /**\n   * Boolean value whether the player is currently playing.\n   * > This property is get-only, use `play` and `pause` methods to control the playback.\n   */\n  playing: boolean;\n\n  /**\n   * Determines whether the player should automatically replay after reaching the end of the video.\n   * @default false\n   */\n  loop: boolean;\n\n  /**\n   * Boolean value whether the player is currently muted.\n   * Setting this property to `true`/`false` will mute/unmute the player.\n   * @default false\n   */\n  muted: boolean;\n\n  /**\n   * Float value indicating the current playback time in seconds.\n   *\n   * If the player is not yet playing, this value indicates the time position\n   * at which playback will begin once the `play()` method is called.\n   *\n   * Setting `currentTime` to a new value seeks the player to the given time.\n   */\n  currentTime: number;\n\n  /**\n   * The exact timestamp when the currently displayed video frame was sent from the server,\n   * based on the `EXT-X-PROGRAM-DATE-TIME` tag in the livestream metadata.\n   * If this metadata is missing, this property will return `null`.\n   * > This property is read-only.\n   * @platform android\n   * @platform ios\n   */\n  readonly currentLiveTimestamp: number | null;\n\n  /**\n   * Float value indicating the latency of the live stream in seconds.\n   * If a livestream doesn't have the required metadata, this will return `null`.\n   * > This property is get-only\n   * @platform android\n   * @platform ios\n   */\n  readonly currentOffsetFromLive: number | null;\n\n  /**\n   * Float value indicating the time offset from the live in seconds.\n   * @platform ios\n   */\n  targetOffsetFromLive: number;\n\n  /**\n   * Float value indicating the duration of the current video in seconds.\n   * > This property is get-only\n   */\n  duration: number;\n\n  /**\n   * Float value between 0 and 1 representing the current volume.\n   * Muting the player doesn't affect the volume. In other words, when the player is muted, the volume is the same as\n   * when unmuted. Similarly, setting the volume doesn't unmute the player.\n   * @default 1.0\n   */\n  volume: number;\n\n  /**\n   * Boolean value indicating if the player should correct audio pitch when the playback speed changes.\n   * > On web, changing this property is not supported, the player will always correct the pitch.\n   * @default true\n   * @platform android\n   * @platform ios\n   */\n  preservesPitch: boolean;\n\n  /**\n   * Float value between 0 and 16 indicating the current playback speed of the player.\n   * @default 1.0\n   */\n  playbackRate: number;\n\n  /**\n   * Boolean value indicating whether the player is currently playing a live stream.\n   * > This property is get-only\n   */\n  isLive: boolean;\n\n  /**\n   * Indicates the current status of the player.\n   * > This property is get-only\n   */\n  status: VideoPlayerStatus;\n\n  /**\n   * Boolean value determining whether the player should show the now playing notification.\n   *\n   * @default false\n   * @platrorm android\n   * @platform ios\n   */\n  showNowPlayingNotification: boolean;\n\n  /**\n   * Determines whether the player should continue playing after the app enters the background.\n   * @default false\n   * @platform ios\n   * @platform android\n   */\n  staysActiveInBackground: boolean;\n\n  /**\n   * Initializes a new video player instance with the given source.\n   * @hidden\n   */\n  constructor(source: VideoSource);\n\n  /**\n   * Resumes the player.\n   */\n  play(): void;\n\n  /**\n   * Pauses the player.\n   */\n  pause(): void;\n\n  /**\n   * Replaces the current source with a new one.\n   */\n  replace(source: VideoSource): void;\n\n  /**\n   * Seeks the playback by the given number of seconds.\n   */\n  seekBy(seconds: number): void;\n\n  /**\n   * Seeks the playback to the beginning.\n   */\n  replay(): void;\n}\n\n/**\n * Handlers for events which can be emitted by the player.\n */\nexport type VideoPlayerEvents = {\n  /**\n   * Handler for an event emitted when the status of the player changes.\n   */\n  statusChange(\n    newStatus: VideoPlayerStatus,\n    oldStatus: VideoPlayerStatus,\n    error?: PlayerError\n  ): void;\n  /**\n   * Handler for an event emitted when the player starts or stops playback.\n   */\n  playingChange(newIsPlaying: boolean, oldIsPlaying: boolean): void;\n  /**\n   * Handler for an event emitted when the `playbackRate` property of the player changes.\n   */\n  playbackRateChange(newPlaybackRate: number, oldPlaybackRate: number): void;\n  /**\n   * Handler for an event emitted when the `volume` property of the player changes.\n   */\n  volumeChange(newVolume: VolumeEvent, oldVolume: VolumeEvent): void;\n  /**\n   * Handler for an event emitted when the player plays to the end of the current source.\n   */\n  playToEnd(): void;\n  /**\n   * Handler for an event emitted when the current media source of the player changes.\n   */\n  sourceChange(newSource: VideoSource, previousSource: VideoSource): void;\n};\n\n/**\n * Describes the current status of the player.\n * - `idle`: The player is not playing or loading any videos.\n * - `loading`: The player is loading video data from the provided source\n * - `readyToPlay`: The player has loaded enough data to start playing or to continue playback.\n * - `error`: The player has encountered an error while loading or playing the video.\n */\nexport type VideoPlayerStatus = 'idle' | 'loading' | 'readyToPlay' | 'error';\n\nexport type VideoSource =\n  | string\n  | number\n  | {\n      /**\n       * The URI of the video.\n       *\n       * This property is exclusive with the `assetId` property. When both are present, the `assetId` will be ignored.\n       */\n      uri?: string;\n\n      /**\n       * The asset ID of a local video asset, acquired with the `require` function.\n       * This property is exclusive with the `uri` property. When both are present, the `assetId` will be ignored.\n       */\n      assetId?: number;\n\n      /**\n       * Specifies the DRM options which will be used by the player while loading the video.\n       */\n      drm?: DRMOptions;\n\n      /**\n       * Specifies information which will be displayed in the now playing notification.\n       * When undefined the player will display information contained in the video metadata.\n       */\n      metadata?: VideoMetadata;\n\n      /**\n       * Specifies headers sent with the video request.\n       * > For DRM license headers use the `headers` field of [`DRMOptions`](#drmoptions).\n       * @platform android\n       * @platform ios\n       */\n      headers?: Record<string, string>;\n    }\n  | null;\n\n/**\n * Contains information about any errors that the player encountered during the playback\n */\nexport type PlayerError = {\n  message: string;\n};\n\n/**\n * Contains information about the current volume and whether the player is muted.\n */\nexport type VolumeEvent = {\n  volume: number;\n  isMuted: boolean;\n};\n\n/**\n * Contains information that will be displayed in the now playing notification when the video is playing.\n */\nexport type VideoMetadata = {\n  /**\n   * The title of the video.\n   */\n  title?: string;\n  /**\n   * Secondary text that will be displayed under the title.\n   */\n  artist?: string;\n};\n\n/**\n * Specifies which type of DRM to use. Android supports Widevine, PlayReady and ClearKey, iOS supports FairPlay.\n */\nexport type DRMType = 'clearkey' | 'fairplay' | 'playready' | 'widevine';\n\n/**\n * Specifies DRM options which will be used by the player while loading the video.\n */\nexport type DRMOptions = {\n  /**\n   * Determines which type of DRM to use.\n   */\n  type: DRMType;\n\n  /**\n   * Determines the license server URL.\n   */\n  licenseServer: string;\n\n  /**\n   * Determines headers sent to the license server on license requests.\n   */\n  headers?: { [key: string]: string };\n\n  /**\n   * Specifies whether the DRM is a multi-key DRM.\n   * @platform android\n   */\n  multiKey?: boolean;\n\n  /**\n   * Specifies the content ID of the stream.\n   * @platform ios\n   */\n  contentId?: string;\n\n  /**\n   * Specifies the certificate URL for the FairPlay DRM.\n   * @platform ios\n   */\n  certificateUrl?: string;\n\n  /**\n   * Specifies the base64 encoded certificate data for the FairPlay DRM.\n   * When this property is set, the `certificateUrl` property is ignored.\n   * @platform ios\n   */\n  base64CertificateData?: string;\n};\n"]}

package/build/VideoPlayer.web.d.ts

@@ -17,6 +17,9 @@ export default class VideoPlayerWeb extends globalThis.expo.SharedObject<VideoPl
     _error: PlayerError | null;
     staysActiveInBackground: boolean;
     showNowPlayingNotification: boolean;
+    currentLiveTimestamp: number | null;
+    currentOffsetFromLive: number | null;
+    targetOffsetFromLive: number;
     set muted(value: boolean);
     get muted(): boolean;
     set playbackRate(value: number);

package/build/VideoPlayer.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPlayer.web.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.web.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACpC,WAAW,CAQb;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAK/D;AAED,MAAM,CAAC,OAAO,OAAO,cACnB,SAAQ,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,iBAAiB,CACtD,YAAW,WAAW;gBAEV,MAAM,EAAE,WAAW;IAK/B,GAAG,EAAE,WAAW,CAAQ;IACxB,WAAW,EAAE,WAAW,CAAQ;IAChC,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAa;IAClD,WAAW,EAAE,GAAG,CAAC,2BAA2B,CAAC,CAAa;IAC1D,OAAO,EAAE,OAAO,CAAS;IACzB,MAAM,EAAE,OAAO,CAAS;IACxB,OAAO,EAAE,MAAM,CAAK;IACpB,KAAK,EAAE,OAAO,CAAS;IACvB,aAAa,EAAE,MAAM,CAAO;IAC5B,eAAe,EAAE,OAAO,CAAQ;IAChC,OAAO,EAAE,iBAAiB,CAAU;IACpC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAClC,uBAAuB,EAAE,OAAO,CAAS;IACzC,0BAA0B,EAAE,OAAO,CAAS;IAE5C,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAKvB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,EAI7B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAKvB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAKtB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAI5B;IAED,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,EAKhC;IAED,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,OAAO,KAAK,MAAM,QAUjB;IAED,cAAc,CAAC,KAAK,EAAE,gBAAgB;IActC,gBAAgB,CAAC,KAAK,EAAE,gBAAgB;IAIxC,cAAc,CACZ,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,QAAQ,EACtB,eAAe,EAAE,2BAA2B,GAC3C,IAAI;IAYP,gBAAgB,CACd,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,2BAA2B;IAe9C,IAAI,IAAI,IAAI;IAMZ,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAmBlC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7B,MAAM,IAAI,IAAI;IAQd,0BAA0B,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAezD;;;OAGG;IACH,SAAS,CAAC,SAAS,SAAS,MAAM,iBAAiB,EACjD,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,SAAS,EACpB,GAAG,IAAI,EAAE,UAAU,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,GAChD,IAAI;IAOP,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;CAiF7C"}
+{"version":3,"file":"VideoPlayer.web.d.ts","sourceRoot":"","sources":["../src/VideoPlayer.web.tsx"],"names":[],"mappings":"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"}

package/build/VideoPlayer.web.js

@@ -1,4 +1,5 @@
 import { useMemo } from 'react';
+import resolveAssetSource from './resolveAssetSource';
 export function useVideoPlayer(source, setup) {
     const parsedSource = typeof source === 'string' ? { uri: source } : source;
     return useMemo(() => {
@@ -8,9 +9,15 @@ export function useVideoPlayer(source, setup) {
     }, [JSON.stringify(source)]);
 }
 export function getSourceUri(source) {
-    if (typeof source == 'string') {
+    if (typeof source === 'string') {
         return source;
     }
+    if (typeof source === 'number') {
+        return resolveAssetSource(source)?.uri ?? null;
+    }
+    if (typeof source?.assetId === 'number' && !source?.uri) {
+        return resolveAssetSource(source.assetId)?.uri ?? null;
+    }
     return source?.uri ?? null;
 }
 export default class VideoPlayerWeb extends globalThis.expo.SharedObject {
@@ -32,6 +39,9 @@ export default class VideoPlayerWeb extends globalThis.expo.SharedObject {
     _error = null;
     staysActiveInBackground = false; // Not supported on web. Dummy to match the interface.
     showNowPlayingNotification = false; // Not supported on web. Dummy to match the interface.
+    currentLiveTimestamp = null; // Not supported on web. Dummy to match the interface.
+    currentOffsetFromLive = null; // Not supported on web. Dummy to match the interface.
+    targetOffsetFromLive = 0; // Not supported on web. Dummy to match the interface.
     set muted(value) {
         this._mountedVideos.forEach((video) => {
             video.muted = value;