@capgo/native-audio 8.3.7 → 8.3.8

package/README.md

@@ -246,6 +246,16 @@ The media control buttons automatically handle:
 - **Play** - Resumes paused audio
 - **Pause** - Pauses playing audio
 - **Stop** - Stops audio and clears the notification
+- **Rewind 15s** (Android only) - Skips backward 15 seconds
+- **Forward 15s** (Android only) - Skips forward 15 seconds
+
+**Android Notification Controls:**
+On Android, the notification displays three action buttons in this order:
+1. ⏪ **Rewind 15s** - Skip backward 15 seconds
+2. ▶️/⏸️ **Play/Pause** - Toggle playback (icon updates automatically)
+3. ⏩ **Forward 15s** - Skip forward 15 seconds
+
+The skip forward/backward buttons are automatically available when `showNotification: true` is configured. No additional setup is required.
 
 **Notes:**
 - All metadata fields are optional

package/android/src/main/java/ee/forgr/audio/NativeAudio.java

@@ -720,6 +720,7 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                     // Update notification when paused
                     if (showNotification) {
                         updatePlaybackState(PlaybackStateCompat.STATE_PAUSED);
+                        updateNotification(audioId);
                     }
 
                     call.resolve();
@@ -764,6 +765,7 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                     // Update notification when resumed
                     if (showNotification) {
                         updatePlaybackState(PlaybackStateCompat.STATE_PLAYING);
+                        updateNotification(audioId);
                     }
 
                     call.resolve();
@@ -1492,7 +1494,12 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
         mediaSession.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS | MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
 
         PlaybackStateCompat.Builder stateBuilder = new PlaybackStateCompat.Builder().setActions(
-            PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PAUSE | PlaybackStateCompat.ACTION_STOP
+            PlaybackStateCompat.ACTION_PLAY |
+                PlaybackStateCompat.ACTION_PAUSE |
+                PlaybackStateCompat.ACTION_STOP |
+                PlaybackStateCompat.ACTION_REWIND |
+                PlaybackStateCompat.ACTION_FAST_FORWARD |
+                PlaybackStateCompat.ACTION_SEEK_TO
         );
         mediaSession.setPlaybackState(stateBuilder.build());
 
@@ -1507,6 +1514,7 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                             if (asset != null && !asset.isPlaying()) {
                                 asset.resume();
                                 updatePlaybackState(PlaybackStateCompat.STATE_PLAYING);
+                                updateNotification(currentlyPlayingAssetId);
                             }
                         } catch (Exception e) {
                             Log.e(TAG, "Error resuming audio from media session", e);
@@ -1522,6 +1530,7 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                             if (asset != null) {
                                 asset.pause();
                                 updatePlaybackState(PlaybackStateCompat.STATE_PAUSED);
+                                updateNotification(currentlyPlayingAssetId);
                             }
                         } catch (Exception e) {
                             Log.e(TAG, "Error pausing audio from media session", e);
@@ -1541,6 +1550,60 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                         }
                     }
                 }
+
+                @Override
+                public void onRewind() {
+                    if (currentlyPlayingAssetId != null && audioAssetList.containsKey(currentlyPlayingAssetId)) {
+                        AudioAsset asset = audioAssetList.get(currentlyPlayingAssetId);
+                        try {
+                            if (asset != null) {
+                                // Skip backward 15 seconds
+                                double currentPosition = asset.getCurrentPosition();
+                                double newPosition = Math.max(0, currentPosition - 15.0);
+                                asset.setCurrentPosition(newPosition);
+                                Log.d(TAG, "Rewind 15s: " + currentPosition + " -> " + newPosition);
+                            }
+                        } catch (Exception e) {
+                            Log.e(TAG, "Error rewinding audio from media session", e);
+                        }
+                    }
+                }
+
+                @Override
+                public void onFastForward() {
+                    if (currentlyPlayingAssetId != null && audioAssetList.containsKey(currentlyPlayingAssetId)) {
+                        AudioAsset asset = audioAssetList.get(currentlyPlayingAssetId);
+                        try {
+                            if (asset != null) {
+                                // Skip forward 15 seconds
+                                double currentPosition = asset.getCurrentPosition();
+                                double duration = asset.getDuration();
+                                double newPosition = Math.min(duration, currentPosition + 15.0);
+                                asset.setCurrentPosition(newPosition);
+                                Log.d(TAG, "Fast forward 15s: " + currentPosition + " -> " + newPosition);
+                            }
+                        } catch (Exception e) {
+                            Log.e(TAG, "Error fast forwarding audio from media session", e);
+                        }
+                    }
+                }
+
+                @Override
+                public void onSeekTo(long pos) {
+                    if (currentlyPlayingAssetId != null && audioAssetList.containsKey(currentlyPlayingAssetId)) {
+                        AudioAsset asset = audioAssetList.get(currentlyPlayingAssetId);
+                        try {
+                            if (asset != null) {
+                                // Convert milliseconds to seconds
+                                double positionInSeconds = pos / 1000.0;
+                                asset.setCurrentPosition(positionInSeconds);
+                                Log.d(TAG, "Seek to: " + positionInSeconds);
+                            }
+                        } catch (Exception e) {
+                            Log.e(TAG, "Error seeking audio from media session", e);
+                        }
+                    }
+                }
             }
         );
 
@@ -1591,18 +1654,62 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
     }
 
     private void showNotification(String title, String artist) {
+        // Determine if currently playing
+        boolean isPlaying = false;
+        if (currentlyPlayingAssetId != null && audioAssetList.containsKey(currentlyPlayingAssetId)) {
+            AudioAsset asset = audioAssetList.get(currentlyPlayingAssetId);
+            if (asset != null) {
+                try {
+                    isPlaying = asset.isPlaying();
+                } catch (Exception e) {
+                    Log.e(TAG, "Error checking playback state", e);
+                }
+            }
+        }
+
+        // Build notification with proper action order: Rewind, Play/Pause, Fast Forward
+        // Use MediaButtonReceiver to properly wire actions to MediaSession callbacks
         NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(getContext(), CHANNEL_ID)
             .setSmallIcon(android.R.drawable.ic_media_play)
             .setContentTitle(title)
             .setContentText(artist)
+            .setVisibility(NotificationCompat.VISIBILITY_PUBLIC)
+            // Add actions BEFORE setStyle() for proper wiring
+            .addAction(
+                new NotificationCompat.Action.Builder(
+                    android.R.drawable.ic_media_rew,
+                    "Rewind 15 seconds",
+                    androidx.media.session.MediaButtonReceiver.buildMediaButtonPendingIntent(
+                        getContext(),
+                        PlaybackStateCompat.ACTION_REWIND
+                    )
+                ).build()
+            )
+            .addAction(
+                new NotificationCompat.Action.Builder(
+                    isPlaying ? android.R.drawable.ic_media_pause : android.R.drawable.ic_media_play,
+                    isPlaying ? "Pause" : "Play",
+                    androidx.media.session.MediaButtonReceiver.buildMediaButtonPendingIntent(
+                        getContext(),
+                        isPlaying ? PlaybackStateCompat.ACTION_PAUSE : PlaybackStateCompat.ACTION_PLAY
+                    )
+                ).build()
+            )
+            .addAction(
+                new NotificationCompat.Action.Builder(
+                    android.R.drawable.ic_media_ff,
+                    "Fast forward 15 seconds",
+                    androidx.media.session.MediaButtonReceiver.buildMediaButtonPendingIntent(
+                        getContext(),
+                        PlaybackStateCompat.ACTION_FAST_FORWARD
+                    )
+                ).build()
+            )
             .setStyle(
                 new androidx.media.app.NotificationCompat.MediaStyle()
                     .setMediaSession(mediaSession.getSessionToken())
                     .setShowActionsInCompactView(0, 1, 2)
             )
-            .addAction(android.R.drawable.ic_media_previous, "Previous", null)
-            .addAction(android.R.drawable.ic_media_pause, "Pause", null)
-            .addAction(android.R.drawable.ic_media_next, "Next", null)
             .setPriority(NotificationCompat.PRIORITY_LOW)
             .setOnlyAlertOnce(true);
 
@@ -1624,7 +1731,14 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
 
         PlaybackStateCompat.Builder stateBuilder = new PlaybackStateCompat.Builder()
             .setState(state, 0, state == PlaybackStateCompat.STATE_PLAYING ? 1.0f : 0.0f)
-            .setActions(PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PAUSE | PlaybackStateCompat.ACTION_STOP);
+            .setActions(
+                PlaybackStateCompat.ACTION_PLAY |
+                    PlaybackStateCompat.ACTION_PAUSE |
+                    PlaybackStateCompat.ACTION_STOP |
+                    PlaybackStateCompat.ACTION_REWIND |
+                    PlaybackStateCompat.ACTION_FAST_FORWARD |
+                    PlaybackStateCompat.ACTION_SEEK_TO
+            );
         mediaSession.setPlaybackState(stateBuilder.build());
     }
 

package/ios/Sources/NativeAudioPlugin/AudioAsset.swift

@@ -318,6 +318,10 @@ public class AudioAsset: NSObject, AVAudioPlayerDelegate {
         return result
     }
 
+    internal func shouldStopCurrentTimeUpdatesWhenNotPlaying() -> Bool {
+        true
+    }
+
     public func audioPlayerDidFinishPlaying(_ player: AVAudioPlayer, successfully flag: Bool) {
         owner?.executeOnAudioQueue { [weak self] in
             guard let self else { return }
@@ -345,7 +349,7 @@ public class AudioAsset: NSObject, AVAudioPlayerDelegate {
                 }
                 if self.isPlaying() {
                     owner.notifyCurrentTime(self)
-                } else {
+                } else if self.shouldStopCurrentTimeUpdatesWhenNotPlaying() {
                     self.stopCurrentTimeUpdates()
                 }
             }

package/ios/Sources/NativeAudioPlugin/Plugin.swift

@@ -12,7 +12,7 @@ enum MyError: Error {
 @objc(NativeAudio)
 // swiftlint:disable:next type_body_length
 public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.3.7"
+    private let pluginVersion: String = "8.3.8"
     public let identifier = "NativeAudio"
     public let jsName = "NativeAudio"
     public let pluginMethods: [CAPPluginMethod] = [

package/ios/Sources/NativeAudioPlugin/RemoteAudioAsset.swift

@@ -265,6 +265,21 @@ public class RemoteAudioAsset: AudioAsset {
         return result
     }
 
+    override func shouldStopCurrentTimeUpdatesWhenNotPlaying() -> Bool {
+        var shouldStop = true
+        owner?.executeOnAudioQueue { [weak self] in
+            guard let self else { return }
+            guard !players.isEmpty && playIndex < players.count else {
+                shouldStop = true
+                return
+            }
+
+            let status = players[playIndex].timeControlStatus
+            shouldStop = status != .waitingToPlayAtSpecifiedRate
+        }
+        return shouldStop
+    }
+
     override func getCurrentTime() -> TimeInterval {
         var result: TimeInterval = 0
         owner?.executeOnAudioQueue { [weak self] in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/native-audio",
-  "version": "8.3.7",
+  "version": "8.3.8",
   "description": "A native plugin for native audio engine",
   "license": "MPL-2.0",
   "main": "dist/plugin.cjs.js",