react-native-mp3-player 1.0.3 → 1.0.4

package/README.md

@@ -79,8 +79,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 = []
@@ -531,6 +534,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())
@@ -541,6 +545,8 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
         if (rejectWhenNotInitialized(reject: reject)) { return }
         player.play()
         resolve(NSNull())
+        // Emit PlaybackState immediately so in-app UI (play/pause button) updates without waiting for native state transition.
+        emit(event: EventType.PlaybackState, body: getPlaybackStateBodyKeyValues(state: .playing))
     }
 
     @objc(pause:rejecter:)
@@ -549,6 +555,8 @@ public class RNTrackPlayer: NSObject, AudioSessionControllerDelegate {
 
         player.pause()
         resolve(NSNull())
+        // Emit PlaybackState immediately so in-app UI (play/pause button) updates without waiting for native state transition.
+        emit(event: EventType.PlaybackState, body: getPlaybackStateBodyKeyValues(state: .paused))
     }
 
     @objc(setPlayWhenReady:resolver:rejecter:)
@@ -823,6 +831,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/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.4",
   "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.
  *