react-native-mp3-player 1.0.3 → 1.0.5

package/README.md

@@ -34,6 +34,7 @@ For audio to continue when the app is backgrounded or the screen is locked (and
 1. **Enable Background Modes → Audio** (or “Audio, AirPlay, and Picture in Picture”) in your app’s Xcode project: select your target → **Signing & Capabilities** → **+ Capability** → **Background Modes** → check **Audio**.
 2. The package configures **AVAudioSession** (category `.playback` with options for Bluetooth, AirPlay, ducking) and handles **interruptions** and **background transitions** so that playback can continue when the app is backgrounded.
 3. **Lock screen and Control Center** controls (play, pause, seek, 15-second skip) are handled **natively**, so they work even when the JavaScript thread is suspended (e.g. screen locked). When the app returns to the foreground, events are emitted so your UI stays in sync.
+4. **Now Playing widget:** The package sets and updates **MPNowPlayingInfoCenter** as soon as a track is loaded (title, artist, duration, elapsed, rate, artwork) and keeps it updated every second during playback. When you pause, the widget shows the track as paused (rate 0), not "Not Playing". Now playing info is only cleared when there is no current track (e.g. after `reset()`).
 
 ### Android background playback
 
@@ -79,8 +80,8 @@ TrackPlayer.registerPlaybackService(() => PlaybackService);
 - **Lifecycle:** `setupPlayer(options?, background?)`, `registerPlaybackService(factory)`, `reset()`
 - **Queue:** `add()`, `load()`, `remove()`, `skip()`, `skipToNext()`, `skipToPrevious()`, `setQueue()`, `getQueue()`, **`getActiveTrack()`** (current track), `getActiveTrackIndex()`
 - **Playback:** `play()`, `pause()`, `stop()`, `seekTo()`, `seekBy()`, `setVolume()`, `setRate()`, `setRepeatMode()`
-- **State:** `getPlaybackState()`, `getProgress()`, `getVolume()`, `getRate()`
-- **Events:** `addEventListener(event, listener)` – see `Event` enum.
+- **State & progress:** **`getPlaybackState()`** (returns `{ state }`; use this, not `getState`), **`getProgress()`** (returns `{ position, duration, buffered }` in seconds), **`getPosition()`** and **`getDuration()`** (convenience wrappers around `getProgress()`), `getVolume()`, `getRate()`
+- **Events:** `addEventListener(event, listener)` – see `Event` enum. Listen for `Event.PlaybackState` so the UI stays in sync when the user taps play/pause.
 - **Hooks:** **`useProgress(updateInterval?, background?)`** (interval in **milliseconds**; e.g. `useProgress(250)` = every 250 ms), `usePlaybackState()`, `useActiveTrack()`, `useIsPlaying()`, `useTrackPlayerEvents()`, etc.
 
 **Setup options** (e.g. in `setupPlayer` / `updateOptions`): `iosCategory` (e.g. `'playback'`), `iosCategoryOptions` (e.g. `['allowAirPlay','allowBluetooth','duckOthers']`), `autoHandleInterruptions`, `autoUpdateMetadata`, `waitForBuffer`, `minBuffer` / buffer-related options, `forwardJumpInterval` / `backwardJumpInterval` (seconds, e.g. 15), `progressUpdateEventInterval` (seconds). Types and options are in the package TypeScript definitions.

package/ios/RNTrackPlayer/RNTrackPlayer.swift

@@ -27,6 +27,9 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
     private var forwardJumpInterval: NSNumber? = nil;
     private var backwardJumpInterval: NSNumber? = nil;
     private var sessionCategory: AVAudioSession.Category = .playback
+    /// Timer work item for updating Now Playing elapsed/duration every second so the lock screen widget stays in sync.
+    private var nowPlayingUpdateWorkItem: DispatchWorkItem? = nil
+    private let nowPlayingUpdateQueue = DispatchQueue.main
     private var sessionCategoryMode: AVAudioSession.Mode = .default
     private var sessionCategoryPolicy: AVAudioSession.RouteSharingPolicy = .longFormAudio
     private var sessionCategoryOptions: AVAudioSession.CategoryOptions = []
@@ -199,6 +202,10 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
         player.remoteCommandController.handlePauseCommand = { [weak self] _ in
             guard let self = self else { return MPRemoteCommandHandlerStatus.commandFailed }
             self.player.pause()
+            if self.player.currentItem != nil && self.player.automaticallyUpdateNowPlayingInfo {
+                self.player.updateNowPlayingPlaybackValues()
+            }
+            self.emit(event: EventType.PlaybackState, body: self.getPlaybackStateBodyKeyValues(state: .paused))
             self.emit(event: EventType.RemotePause)
             return MPRemoteCommandHandlerStatus.success
         }
@@ -206,6 +213,10 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
         player.remoteCommandController.handlePlayCommand = { [weak self] _ in
             guard let self = self else { return MPRemoteCommandHandlerStatus.commandFailed }
             self.player.play()
+            if self.player.currentItem != nil && self.player.automaticallyUpdateNowPlayingInfo {
+                self.player.updateNowPlayingPlaybackValues()
+            }
+            self.emit(event: EventType.PlaybackState, body: self.getPlaybackStateBodyKeyValues(state: .playing))
             self.emit(event: EventType.RemotePlay)
             return MPRemoteCommandHandlerStatus.success
         }
@@ -244,6 +255,10 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
         player.remoteCommandController.handleStopCommand = { [weak self] _ in
             guard let self = self else { return MPRemoteCommandHandlerStatus.commandFailed }
             self.player.stop()
+            if self.player.currentItem != nil && self.player.automaticallyUpdateNowPlayingInfo {
+                self.player.updateNowPlayingPlaybackValues()
+            }
+            self.emit(event: EventType.PlaybackState, body: self.getPlaybackStateBodyKeyValues(state: .stopped))
             self.emit(event: EventType.RemoteStop)
             return MPRemoteCommandHandlerStatus.success
         }
@@ -252,9 +267,17 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
             guard let self = self else { return MPRemoteCommandHandlerStatus.commandFailed }
             if self.player.playerState == .paused {
                 self.player.play()
+                if self.player.currentItem != nil && self.player.automaticallyUpdateNowPlayingInfo {
+                    self.player.updateNowPlayingPlaybackValues()
+                }
+                self.emit(event: EventType.PlaybackState, body: self.getPlaybackStateBodyKeyValues(state: .playing))
                 self.emit(event: EventType.RemotePlay)
             } else {
                 self.player.pause()
+                if self.player.currentItem != nil && self.player.automaticallyUpdateNowPlayingInfo {
+                    self.player.updateNowPlayingPlaybackValues()
+                }
+                self.emit(event: EventType.PlaybackState, body: self.getPlaybackStateBodyKeyValues(state: .paused))
                 self.emit(event: EventType.RemotePause)
             }
             return MPRemoteCommandHandlerStatus.success
@@ -531,6 +554,7 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
     public func reset(resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
         if (rejectWhenNotInitialized(reject: reject)) { return }
 
+        stopNowPlayingUpdateTimer()
         player.stop()
         player.clear()
         resolve(NSNull())
@@ -540,7 +564,12 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
     public func play(resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
         if (rejectWhenNotInitialized(reject: reject)) { return }
         player.play()
+        // Update Now Playing widget immediately (rate 1, current elapsed) so it never shows "Not Playing".
+        if player.currentItem != nil && player.automaticallyUpdateNowPlayingInfo {
+            player.updateNowPlayingPlaybackValues()
+        }
         resolve(NSNull())
+        emit(event: EventType.PlaybackState, body: getPlaybackStateBodyKeyValues(state: .playing))
     }
 
     @objc(pause:rejecter:)
@@ -548,7 +577,12 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
         if (rejectWhenNotInitialized(reject: reject)) { return }
 
         player.pause()
+        // Update Now Playing widget immediately (rate 0, current elapsed) so it shows "Paused" not "Not Playing".
+        if player.currentItem != nil && player.automaticallyUpdateNowPlayingInfo {
+            player.updateNowPlayingPlaybackValues()
+        }
         resolve(NSNull())
+        emit(event: EventType.PlaybackState, body: getPlaybackStateBodyKeyValues(state: .paused))
     }
 
     @objc(setPlayWhenReady:resolver:rejecter:)
@@ -823,6 +857,33 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
                 "position": player.currentTime,
             ] as [String : Any])
         }
+        // Keep Now Playing widget elapsed/duration in sync: update every second when we have a current item and are ready/playing/paused.
+        switch state {
+        case .ready, .playing, .paused:
+            if player.currentItem != nil && player.automaticallyUpdateNowPlayingInfo {
+                scheduleNextNowPlayingUpdate()
+            } else {
+                stopNowPlayingUpdateTimer()
+            }
+        default:
+            stopNowPlayingUpdateTimer()
+        }
+    }
+
+    private func scheduleNextNowPlayingUpdate() {
+        stopNowPlayingUpdateTimer()
+        let workItem = DispatchWorkItem { [weak self] in
+            guard let self = self, self.player.currentItem != nil, self.player.automaticallyUpdateNowPlayingInfo else { return }
+            self.player.updateNowPlayingPlaybackValues()
+            self.scheduleNextNowPlayingUpdate()
+        }
+        nowPlayingUpdateWorkItem = workItem
+        nowPlayingUpdateQueue.asyncAfter(deadline: .now() + 1.0, execute: workItem)
+    }
+
+    private func stopNowPlayingUpdateTimer() {
+        nowPlayingUpdateWorkItem?.cancel()
+        nowPlayingUpdateWorkItem = nil
     }
     
     func handleAudioPlayerCommonMetadataReceived(metadata: [AVMetadataItem]) {

package/ios/SwiftAudioEx/Sources/SwiftAudioEx/AudioPlayer.swift

@@ -211,12 +211,12 @@ public class AudioPlayer: AVPlayerWrapperDelegate {
             currentItem = item
 
             if (automaticallyUpdateNowPlayingInfo) {
-                // Reset playback values without updating, because that will happen in
-                // the loadNowPlayingMetaValues call straight after:
-                nowPlayingInfoController.setWithoutUpdate(keyValues: [
-                    MediaItemProperty.duration(nil),
-                    NowPlayingInfoProperty.playbackRate(nil),
-                    NowPlayingInfoProperty.elapsedPlaybackTime(nil)
+                // Set initial playback values so the Now Playing widget never shows "Not Playing"
+                // (duration/elapsed/rate must be set; use 0 until the player reports real values).
+                nowPlayingInfoController.set(keyValues: [
+                    MediaItemProperty.duration(0),
+                    NowPlayingInfoProperty.playbackRate(playWhenReady ? 1.0 : 0.0),
+                    NowPlayingInfoProperty.elapsedPlaybackTime(0)
                 ])
                 loadNowPlayingMetaValues()
             }

package/lib/src/trackPlayer.d.ts

@@ -269,6 +269,14 @@ export declare function getActiveTrack(): Promise<Track | undefined>;
  * duration in seconds.
  */
 export declare function getProgress(): Promise<Progress>;
+/**
+ * Gets the current playback position in seconds. Convenience wrapper around getProgress().
+ */
+export declare function getPosition(): Promise<number>;
+/**
+ * Gets the duration of the current track in seconds. Convenience wrapper around getProgress().
+ */
+export declare function getDuration(): Promise<number>;
 /**
  * Gets the playback state of the player.
  *

package/lib/src/trackPlayer.js

@@ -474,6 +474,20 @@ export async function getProgress() {
     // @ts-expect-error codegen issues
     return TrackPlayer.getProgress();
 }
+/**
+ * Gets the current playback position in seconds. Convenience wrapper around getProgress().
+ */
+export async function getPosition() {
+    const { position } = await getProgress();
+    return position;
+}
+/**
+ * Gets the duration of the current track in seconds. Convenience wrapper around getProgress().
+ */
+export async function getDuration() {
+    const { duration } = await getProgress();
+    return duration;
+}
 /**
  * Gets the playback state of the player.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-mp3-player",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "React Native audio player with reliable iOS background playback. Media controls, queue, hooks. Built for stability and long-running playback.",
   "main": "lib/src/index.js",
   "types": "lib/src/index.d.ts",

package/src/trackPlayer.ts

@@ -633,6 +633,22 @@ export async function getProgress(): Promise<Progress> {
   return TrackPlayer.getProgress();
 }
 
+/**
+ * Gets the current playback position in seconds. Convenience wrapper around getProgress().
+ */
+export async function getPosition(): Promise<number> {
+  const { position } = await getProgress();
+  return position;
+}
+
+/**
+ * Gets the duration of the current track in seconds. Convenience wrapper around getProgress().
+ */
+export async function getDuration(): Promise<number> {
+  const { duration } = await getProgress();
+  return duration;
+}
+
 /**
  * Gets the playback state of the player.
  *