@capgo/native-audio 7.7.7 → 7.8.0

package/README.md

@@ -38,6 +38,23 @@ Click on video to see example 💥
 
 [![YouTube Example](https://img.youtube.com/vi/XpUGlWWtwHs/0.jpg)](https://www.youtube.com/watch?v=XpUGlWWtwHs)
 
+## Why Native Audio?
+
+The only **free**, **full-featured** audio playback plugin for Capacitor:
+
+- **HLS/M3U8 streaming** - Play live audio streams and adaptive bitrate content
+- **Remote URLs** - Stream from HTTP/HTTPS sources with built-in caching
+- **Low-latency playback** - Optimized native audio engine for sound effects and music
+- **Full control** - Play, pause, resume, loop, seek, volume, playback rate
+- **Multiple channels** - Play multiple audio files simultaneously
+- **Background playback** - Continue playing when app is backgrounded
+- **Notification center display** - Show audio metadata in iOS Control Center and Android notifications
+- **Position tracking** - Real-time currentTime events (100ms intervals)
+- **Modern package management** - Supports both Swift Package Manager (SPM) and CocoaPods (SPM-ready for Capacitor 8)
+- **Same JavaScript API** - Compatible interface with paid alternatives
+
+Perfect for music players, podcast apps, games, meditation apps, and any audio-heavy application.
+
 ## Maintainers
 
 | Maintainer      | GitHub                              | Social                                  |
@@ -114,6 +131,70 @@ No configuration required for this plugin.
 
 [Example repository](https://github.com/bazuka5801/native-audio-example)
 
+### Notification Center Display (iOS & Android)
+
+You can display audio playback information in the system notification center. This is perfect for music players, podcast apps, and any app that plays audio in the background.
+
+**Step 1: Configure the plugin with notification support**
+
+```typescript
+import { NativeAudio } from '@capgo/native-audio'
+
+// Enable notification center display
+await NativeAudio.configure({
+  showNotification: true,
+  background: true  // Also enable background playback
+});
+```
+
+**Step 2: Preload audio with metadata**
+
+```typescript
+await NativeAudio.preload({
+  assetId: 'song1',
+  assetPath: 'https://example.com/song.mp3',
+  isUrl: true,
+  notificationMetadata: {
+    title: 'My Song Title',
+    artist: 'Artist Name',
+    album: 'Album Name',
+    artworkUrl: 'https://example.com/artwork.jpg'  // Can be local or remote URL
+  }
+});
+```
+
+**Step 3: Play the audio**
+
+```typescript
+// When you play the audio, it will automatically appear in the notification center
+await NativeAudio.play({ assetId: 'song1' });
+```
+
+The notification will:
+- Show the title, artist, and album information
+- Display the artwork/album art (if provided)
+- Include media controls (play/pause/stop buttons)
+- Automatically update when audio is paused/resumed
+- Automatically clear when audio is stopped
+- Work on both iOS and Android
+
+**Media Controls:**
+Users can control playback directly from:
+- iOS: Control Center, Lock Screen, CarPlay
+- Android: Notification tray, Lock Screen, Android Auto
+
+The media control buttons automatically handle:
+- **Play** - Resumes paused audio
+- **Pause** - Pauses playing audio
+- **Stop** - Stops audio and clears the notification
+
+**Notes:**
+- All metadata fields are optional
+- Artwork can be a local file path or remote URL
+- The notification only appears when `showNotification: true` is set in configure()
+- iOS: Uses MPNowPlayingInfoCenter with MPRemoteCommandCenter
+- Android: Uses MediaSession with NotificationCompat.MediaStyle
+
 ## Example app
 
 This repository now ships with an interactive Capacitor project under `example/` that exercises the main APIs on web, iOS, and Android shells.
@@ -592,23 +673,35 @@ Use this when you need to ensure compatibility with other audio plugins
 
 #### ConfigureOptions
 
-| Prop               | Type                 | Description                                                                   |
-| ------------------ | -------------------- | ----------------------------------------------------------------------------- |
-| **`fade`**         | <code>boolean</code> | Play the audio with Fade effect, only available for IOS                       |
-| **`focus`**        | <code>boolean</code> | focus the audio with Audio Focus                                              |
-| **`background`**   | <code>boolean</code> | Play the audio in the background                                              |
-| **`ignoreSilent`** | <code>boolean</code> | Ignore silent mode, works only on iOS setting this will nuke other audio apps |
+| Prop                   | Type                 | Description                                                                                                                                                       |
+| ---------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`fade`**             | <code>boolean</code> | Play the audio with Fade effect, only available for IOS                                                                                                           |
+| **`focus`**            | <code>boolean</code> | focus the audio with Audio Focus                                                                                                                                  |
+| **`background`**       | <code>boolean</code> | Play the audio in the background                                                                                                                                  |
+| **`ignoreSilent`**     | <code>boolean</code> | Ignore silent mode, works only on iOS setting this will nuke other audio apps                                                                                     |
+| **`showNotification`** | <code>boolean</code> | Show audio playback in the notification center (iOS and Android) When enabled, displays audio metadata (title, artist, album, artwork) in the system notification |
 
 
 #### PreloadOptions
 
-| Prop                  | Type                 | Description                                                                                                                                                                           |
-| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`assetPath`**       | <code>string</code>  | Path to the audio file, relative path of the file, absolute url (file://) or remote url (https://) Supported formats: - MP3, WAV (all platforms) - M3U8/HLS streams (iOS and Android) |
-| **`assetId`**         | <code>string</code>  | Asset Id, unique identifier of the file                                                                                                                                               |
-| **`volume`**          | <code>number</code>  | Volume of the audio, between 0.1 and 1.0                                                                                                                                              |
-| **`audioChannelNum`** | <code>number</code>  | Audio channel number, default is 1                                                                                                                                                    |
-| **`isUrl`**           | <code>boolean</code> | Is the audio file a URL, pass true if assetPath is a `file://` url or a streaming URL (m3u8)                                                                                          |
+| Prop                       | Type                                                                  | Description                                                                                                                                                                           |
+| -------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`assetPath`**            | <code>string</code>                                                   | Path to the audio file, relative path of the file, absolute url (file://) or remote url (https://) Supported formats: - MP3, WAV (all platforms) - M3U8/HLS streams (iOS and Android) |
+| **`assetId`**              | <code>string</code>                                                   | Asset Id, unique identifier of the file                                                                                                                                               |
+| **`volume`**               | <code>number</code>                                                   | Volume of the audio, between 0.1 and 1.0                                                                                                                                              |
+| **`audioChannelNum`**      | <code>number</code>                                                   | Audio channel number, default is 1                                                                                                                                                    |
+| **`isUrl`**                | <code>boolean</code>                                                  | Is the audio file a URL, pass true if assetPath is a `file://` url or a streaming URL (m3u8)                                                                                          |
+| **`notificationMetadata`** | <code><a href="#notificationmetadata">NotificationMetadata</a></code> | Metadata to display in the notification center when audio is playing Only used when showNotification is enabled in configure()                                                        |
+
+
+#### NotificationMetadata
+
+| Prop             | Type                | Description                                           |
+| ---------------- | ------------------- | ----------------------------------------------------- |
+| **`title`**      | <code>string</code> | The title to display in the notification center       |
+| **`artist`**     | <code>string</code> | The artist name to display in the notification center |
+| **`album`**      | <code>string</code> | The album name to display in the notification center  |
+| **`artworkUrl`** | <code>string</code> | URL or local path to the artwork/album art image      |
 
 
 #### Assets

package/android/build.gradle

@@ -62,4 +62,7 @@ dependencies {
     implementation 'androidx.media3:media3-ui:1.5.1'
     implementation 'androidx.media3:media3-database:1.5.1'
     implementation 'androidx.media3:media3-common:1.8.0'
+    // Media notification support
+    implementation 'androidx.media:media:1.7.0'
+    implementation 'androidx.core:core:1.13.1'
 }

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

@@ -16,6 +16,8 @@ public class Constant {
     public static final String RATE = "rate";
     public static final String AUDIO_CHANNEL_NUM = "audioChannelNum";
     public static final String LOOP = "loop";
+    public static final String SHOW_NOTIFICATION = "showNotification";
+    public static final String NOTIFICATION_METADATA = "notificationMetadata";
     public static final int INVALID = 0;
     public static final int PREPARED = 1;
     public static final int PENDING_PLAY = 2;

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

@@ -9,21 +9,32 @@ import static ee.forgr.audio.Constant.ERROR_AUDIO_ASSET_MISSING;
 import static ee.forgr.audio.Constant.ERROR_AUDIO_EXISTS;
 import static ee.forgr.audio.Constant.ERROR_AUDIO_ID_MISSING;
 import static ee.forgr.audio.Constant.LOOP;
+import static ee.forgr.audio.Constant.NOTIFICATION_METADATA;
 import static ee.forgr.audio.Constant.OPT_FOCUS_AUDIO;
 import static ee.forgr.audio.Constant.RATE;
+import static ee.forgr.audio.Constant.SHOW_NOTIFICATION;
 import static ee.forgr.audio.Constant.VOLUME;
 
 import android.Manifest;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
 import android.content.Context;
 import android.content.res.AssetFileDescriptor;
 import android.content.res.AssetManager;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
 import android.media.AudioManager;
 import android.net.Uri;
 import android.os.Build;
 import android.os.Handler;
 import android.os.Looper;
 import android.os.ParcelFileDescriptor;
+import android.support.v4.media.MediaMetadataCompat;
+import android.support.v4.media.session.MediaSessionCompat;
+import android.support.v4.media.session.PlaybackStateCompat;
 import android.util.Log;
+import androidx.core.app.NotificationCompat;
+import androidx.core.app.NotificationManagerCompat;
 import androidx.media3.common.util.UnstableApi;
 import com.getcapacitor.JSObject;
 import com.getcapacitor.Plugin;
@@ -64,6 +75,14 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
 
     private final Map<String, PluginCall> pendingDurationCalls = new HashMap<>();
 
+    // Notification center support
+    private boolean showNotification = false;
+    private Map<String, Map<String, String>> notificationMetadataMap = new HashMap<>();
+    private MediaSessionCompat mediaSession;
+    private String currentlyPlayingAssetId;
+    private static final int NOTIFICATION_ID = 1001;
+    private static final String CHANNEL_ID = "native_audio_channel";
+
     @Override
     public void load() {
         super.load();
@@ -168,6 +187,7 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
         boolean focus = call.getBoolean(OPT_FOCUS_AUDIO, false);
         boolean background = call.getBoolean("background", false);
         this.fadeMusic = call.getBoolean("fade", false);
+        this.showNotification = call.getBoolean(SHOW_NOTIFICATION, false);
 
         try {
             if (focus) {
@@ -189,6 +209,11 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
             } else {
                 this.audioManager.setMode(AudioManager.MODE_NORMAL);
             }
+
+            if (this.showNotification) {
+                setupMediaSession();
+                createNotificationChannel();
+            }
         } catch (Exception ex) {
             Log.e(TAG, "Error configuring audio", ex);
         }
@@ -324,6 +349,12 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                     if (wasPlaying) {
                         resumeList.add(asset);
                     }
+
+                    // Update notification when paused
+                    if (showNotification) {
+                        updatePlaybackState(PlaybackStateCompat.STATE_PAUSED);
+                    }
+
                     call.resolve();
                 } else {
                     call.reject(ERROR_ASSET_NOT_LOADED + " - " + audioId);
@@ -347,6 +378,12 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                 if (asset != null) {
                     asset.resume();
                     resumeList.add(asset);
+
+                    // Update notification when resumed
+                    if (showNotification) {
+                        updatePlaybackState(PlaybackStateCompat.STATE_PLAYING);
+                    }
+
                     call.resolve();
                 } else {
                     call.reject(ERROR_ASSET_NOT_LOADED + " - " + audioId);
@@ -372,6 +409,13 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                             return;
                         }
                         stopAudio(audioId);
+
+                        // Clear notification when stopped
+                        if (showNotification) {
+                            clearNotification();
+                            currentlyPlayingAssetId = null;
+                        }
+
                         call.resolve();
                     } catch (Exception ex) {
                         call.reject(ex.getMessage());
@@ -581,6 +625,19 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                 audioChannelNum = call.getInt(AUDIO_CHANNEL_NUM, 1);
             }
 
+            // Store notification metadata if provided
+            JSObject metadata = call.getObject(NOTIFICATION_METADATA);
+            if (metadata != null) {
+                Map<String, String> metadataMap = new HashMap<>();
+                if (metadata.has("title")) metadataMap.put("title", metadata.getString("title"));
+                if (metadata.has("artist")) metadataMap.put("artist", metadata.getString("artist"));
+                if (metadata.has("album")) metadataMap.put("album", metadata.getString("album"));
+                if (metadata.has("artworkUrl")) metadataMap.put("artworkUrl", metadata.getString("artworkUrl"));
+                if (!metadataMap.isEmpty()) {
+                    notificationMetadataMap.put(audioId, metadataMap);
+                }
+            }
+
             if (isLocalUrl) {
                 try {
                     Uri uri = Uri.parse(assetPath);
@@ -666,6 +723,13 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                             asset.play(time);
                         }
                     }
+
+                    // Update notification if enabled
+                    if (showNotification) {
+                        currentlyPlayingAssetId = audioId;
+                        updateNotification(audioId);
+                    }
+
                     call.resolve();
                 } else {
                     call.reject("Asset is null: " + audioId);
@@ -746,6 +810,15 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
                 }
             }
 
+            // Clear notification and release media session
+            if (showNotification) {
+                clearNotification();
+                if (mediaSession != null) {
+                    mediaSession.release();
+                    mediaSession = null;
+                }
+            }
+
             // Release audio focus if we requested it
             if (audioFocusRequested && this.audioManager != null) {
                 this.audioManager.abandonAudioFocus(this);
@@ -764,4 +837,182 @@ public class NativeAudio extends Plugin implements AudioManager.OnAudioFocusChan
             call.reject("Error deinitializing plugin: " + e.getMessage());
         }
     }
+
+    // Notification and MediaSession methods
+
+    private void setupMediaSession() {
+        if (mediaSession != null) return;
+
+        mediaSession = new MediaSessionCompat(getContext(), "NativeAudio");
+
+        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
+        );
+        mediaSession.setPlaybackState(stateBuilder.build());
+
+        // Set callback for media button events
+        mediaSession.setCallback(
+            new MediaSessionCompat.Callback() {
+                @Override
+                public void onPlay() {
+                    if (currentlyPlayingAssetId != null && audioAssetList.containsKey(currentlyPlayingAssetId)) {
+                        AudioAsset asset = audioAssetList.get(currentlyPlayingAssetId);
+                        try {
+                            if (asset != null && !asset.isPlaying()) {
+                                asset.resume();
+                                updatePlaybackState(PlaybackStateCompat.STATE_PLAYING);
+                            }
+                        } catch (Exception e) {
+                            Log.e(TAG, "Error resuming audio from media session", e);
+                        }
+                    }
+                }
+
+                @Override
+                public void onPause() {
+                    if (currentlyPlayingAssetId != null && audioAssetList.containsKey(currentlyPlayingAssetId)) {
+                        AudioAsset asset = audioAssetList.get(currentlyPlayingAssetId);
+                        try {
+                            if (asset != null) {
+                                asset.pause();
+                                updatePlaybackState(PlaybackStateCompat.STATE_PAUSED);
+                            }
+                        } catch (Exception e) {
+                            Log.e(TAG, "Error pausing audio from media session", e);
+                        }
+                    }
+                }
+
+                @Override
+                public void onStop() {
+                    if (currentlyPlayingAssetId != null) {
+                        try {
+                            stopAudio(currentlyPlayingAssetId);
+                            clearNotification();
+                            currentlyPlayingAssetId = null;
+                        } catch (Exception e) {
+                            Log.e(TAG, "Error stopping audio from media session", e);
+                        }
+                    }
+                }
+            }
+        );
+
+        mediaSession.setActive(true);
+    }
+
+    private void createNotificationChannel() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            NotificationChannel channel = new NotificationChannel(CHANNEL_ID, "Audio Playback", NotificationManager.IMPORTANCE_LOW);
+            channel.setDescription("Shows currently playing audio");
+            NotificationManager notificationManager = getContext().getSystemService(NotificationManager.class);
+            if (notificationManager != null) {
+                notificationManager.createNotificationChannel(channel);
+            }
+        }
+    }
+
+    private void updateNotification(String audioId) {
+        if (mediaSession == null) return;
+
+        Map<String, String> metadata = notificationMetadataMap.get(audioId);
+        String title = metadata != null && metadata.containsKey("title") ? metadata.get("title") : "Playing";
+        String artist = metadata != null && metadata.containsKey("artist") ? metadata.get("artist") : "";
+        String album = metadata != null && metadata.containsKey("album") ? metadata.get("album") : "";
+        String artworkUrl = metadata != null ? metadata.get("artworkUrl") : null;
+
+        // Update MediaSession metadata
+        MediaMetadataCompat.Builder metadataBuilder = new MediaMetadataCompat.Builder();
+        metadataBuilder.putString(MediaMetadataCompat.METADATA_KEY_TITLE, title);
+        metadataBuilder.putString(MediaMetadataCompat.METADATA_KEY_ARTIST, artist);
+        metadataBuilder.putString(MediaMetadataCompat.METADATA_KEY_ALBUM, album);
+
+        // Load artwork if provided
+        if (artworkUrl != null) {
+            loadArtwork(artworkUrl, (bitmap) -> {
+                if (bitmap != null) {
+                    metadataBuilder.putBitmap(MediaMetadataCompat.METADATA_KEY_ALBUM_ART, bitmap);
+                }
+                mediaSession.setMetadata(metadataBuilder.build());
+                showNotification(title, artist);
+            });
+        } else {
+            mediaSession.setMetadata(metadataBuilder.build());
+            showNotification(title, artist);
+        }
+
+        updatePlaybackState(PlaybackStateCompat.STATE_PLAYING);
+    }
+
+    private void showNotification(String title, String artist) {
+        NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(getContext(), CHANNEL_ID)
+            .setSmallIcon(android.R.drawable.ic_media_play)
+            .setContentTitle(title)
+            .setContentText(artist)
+            .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);
+
+        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(getContext());
+        notificationManager.notify(NOTIFICATION_ID, notificationBuilder.build());
+    }
+
+    private void clearNotification() {
+        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(getContext());
+        notificationManager.cancel(NOTIFICATION_ID);
+
+        if (mediaSession != null) {
+            updatePlaybackState(PlaybackStateCompat.STATE_STOPPED);
+        }
+    }
+
+    private void updatePlaybackState(int state) {
+        if (mediaSession == null) return;
+
+        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);
+        mediaSession.setPlaybackState(stateBuilder.build());
+    }
+
+    private void loadArtwork(String urlString, ArtworkCallback callback) {
+        new Thread(() -> {
+            try {
+                Uri uri = Uri.parse(urlString);
+                Bitmap bitmap = null;
+
+                if (uri.getScheme() == null || uri.getScheme().equals("file")) {
+                    // Local file
+                    File file = new File(uri.getPath());
+                    if (file.exists()) {
+                        bitmap = BitmapFactory.decodeFile(file.getAbsolutePath());
+                    }
+                } else {
+                    // Remote URL
+                    URL url = new URL(urlString);
+                    bitmap = BitmapFactory.decodeStream(url.openConnection().getInputStream());
+                }
+
+                Bitmap finalBitmap = bitmap;
+                new Handler(Looper.getMainLooper()).post(() -> callback.onArtworkLoaded(finalBitmap));
+            } catch (Exception e) {
+                Log.e(TAG, "Error loading artwork", e);
+                new Handler(Looper.getMainLooper()).post(() -> callback.onArtworkLoaded(null));
+            }
+        })
+            .start();
+    }
+
+    interface ArtworkCallback {
+        void onArtworkLoaded(Bitmap bitmap);
+    }
 }

package/dist/docs.json

@@ -656,6 +656,13 @@
           "docs": "Ignore silent mode, works only on iOS setting this will nuke other audio apps",
           "complexTypes": [],
           "type": "boolean | undefined"
+        },
+        {
+          "name": "showNotification",
+          "tags": [],
+          "docs": "Show audio playback in the notification center (iOS and Android)\nWhen enabled, displays audio metadata (title, artist, album, artwork) in the system notification",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },
@@ -700,6 +707,52 @@
           "docs": "Is the audio file a URL, pass true if assetPath is a `file://` url\nor a streaming URL (m3u8)",
           "complexTypes": [],
           "type": "boolean | undefined"
+        },
+        {
+          "name": "notificationMetadata",
+          "tags": [],
+          "docs": "Metadata to display in the notification center when audio is playing\nOnly used when showNotification is enabled in configure()",
+          "complexTypes": [
+            "NotificationMetadata"
+          ],
+          "type": "NotificationMetadata"
+        }
+      ]
+    },
+    {
+      "name": "NotificationMetadata",
+      "slug": "notificationmetadata",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "title",
+          "tags": [],
+          "docs": "The title to display in the notification center",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "artist",
+          "tags": [],
+          "docs": "The artist name to display in the notification center",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "album",
+          "tags": [],
+          "docs": "The album name to display in the notification center",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "artworkUrl",
+          "tags": [],
+          "docs": "URL or local path to the artwork/album art image",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -65,6 +65,29 @@ export interface ConfigureOptions {
      * Ignore silent mode, works only on iOS setting this will nuke other audio apps
      */
     ignoreSilent?: boolean;
+    /**
+     * Show audio playback in the notification center (iOS and Android)
+     * When enabled, displays audio metadata (title, artist, album, artwork) in the system notification
+     */
+    showNotification?: boolean;
+}
+export interface NotificationMetadata {
+    /**
+     * The title to display in the notification center
+     */
+    title?: string;
+    /**
+     * The artist name to display in the notification center
+     */
+    artist?: string;
+    /**
+     * The album name to display in the notification center
+     */
+    album?: string;
+    /**
+     * URL or local path to the artwork/album art image
+     */
+    artworkUrl?: string;
 }
 export interface PreloadOptions {
     /**
@@ -91,6 +114,11 @@ export interface PreloadOptions {
      * or a streaming URL (m3u8)
      */
     isUrl?: boolean;
+    /**
+     * Metadata to display in the notification center when audio is playing
+     * Only used when showNotification is enabled in configure()
+     */
+    notificationMetadata?: NotificationMetadata;
 }
 export interface CurrentTimeEvent {
     /**

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface CompletedEvent {\n  /**\n   * Emit when a play completes\n   *\n   * @since  5.0.0\n   */\n  assetId: string;\n}\nexport type CompletedListener = (state: CompletedEvent) => void;\nexport interface Assets {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n}\nexport interface AssetVolume {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Volume of the audio, between 0.1 and 1.0\n   */\n  volume: number;\n}\n\nexport interface AssetRate {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Rate of the audio, between 0.1 and 1.0\n   */\n  rate: number;\n}\n\nexport interface AssetPlayOptions {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Time to start playing the audio, in milliseconds\n   */\n  time?: number;\n  /**\n   * Delay to start playing the audio, in milliseconds\n   */\n  delay?: number;\n}\n\nexport interface ConfigureOptions {\n  /**\n   * Play the audio with Fade effect, only available for IOS\n   */\n  fade?: boolean;\n  /**\n   * focus the audio with Audio Focus\n   */\n  focus?: boolean;\n  /**\n   * Play the audio in the background\n   */\n  background?: boolean;\n  /**\n   * Ignore silent mode, works only on iOS setting this will nuke other audio apps\n   */\n  ignoreSilent?: boolean;\n}\n\nexport interface PreloadOptions {\n  /**\n   * Path to the audio file, relative path of the file, absolute url (file://) or remote url (https://)\n   * Supported formats:\n   * - MP3, WAV (all platforms)\n   * - M3U8/HLS streams (iOS and Android)\n   */\n  assetPath: string;\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Volume of the audio, between 0.1 and 1.0\n   */\n  volume?: number;\n  /**\n   * Audio channel number, default is 1\n   */\n  audioChannelNum?: number;\n  /**\n   * Is the audio file a URL, pass true if assetPath is a `file://` url\n   * or a streaming URL (m3u8)\n   */\n  isUrl?: boolean;\n}\n\nexport interface CurrentTimeEvent {\n  /**\n   * Current time of the audio in seconds\n   * @since 6.5.0\n   */\n  currentTime: number;\n  /**\n   * Asset Id of the audio\n   * @since 6.5.0\n   */\n  assetId: string;\n}\nexport type CurrentTimeListener = (state: CurrentTimeEvent) => void;\n\nexport interface NativeAudio {\n  /**\n   * Configure the audio player\n   * @since 5.0.0\n   * @param option {@link ConfigureOptions}\n   * @returns\n   */\n  configure(options: ConfigureOptions): Promise<void>;\n  /**\n   * Load an audio file\n   * @since 5.0.0\n   * @param option {@link PreloadOptions}\n   * @returns\n   */\n  preload(options: PreloadOptions): Promise<void>;\n  /**\n   * Check if an audio file is preloaded\n   *\n   * @since 6.1.0\n   * @param option {@link Assets}\n   * @returns {Promise<boolean>}\n   */\n  isPreloaded(options: PreloadOptions): Promise<{ found: boolean }>;\n  /**\n   * Play an audio file\n   * @since 5.0.0\n   * @param option {@link PlayOptions}\n   * @returns\n   */\n  play(options: { assetId: string; time?: number; delay?: number }): Promise<void>;\n  /**\n   * Pause an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  pause(options: Assets): Promise<void>;\n  /**\n   * Resume an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  resume(options: Assets): Promise<void>;\n  /**\n   * Stop an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  loop(options: Assets): Promise<void>;\n  /**\n   * Stop an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  stop(options: Assets): Promise<void>;\n  /**\n   * Unload an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  unload(options: Assets): Promise<void>;\n  /**\n   * Set the volume of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetVolume}\n   * @returns {Promise<void>}\n   */\n  setVolume(options: { assetId: string; volume: number }): Promise<void>;\n  /**\n   * Set the rate of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<void>}\n   */\n  setRate(options: { assetId: string; rate: number }): Promise<void>;\n  /**\n   * Set the current time of an audio file\n   * @since 6.5.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<void>}\n   */\n  setCurrentTime(options: { assetId: string; time: number }): Promise<void>;\n  /**\n   * Get the current time of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<{ currentTime: number }>}\n   */\n  getCurrentTime(options: { assetId: string }): Promise<{ currentTime: number }>;\n  /**\n   * Get the duration of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<{ duration: number }>}\n   */\n  getDuration(options: Assets): Promise<{ duration: number }>;\n  /**\n   * Check if an audio file is playing\n   *\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<boolean>}\n   */\n  isPlaying(options: Assets): Promise<{ isPlaying: boolean }>;\n  /**\n   * Listen for complete event\n   *\n   * @since 5.0.0\n   * return {@link CompletedEvent}\n   */\n  addListener(eventName: 'complete', listenerFunc: CompletedListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for current time updates\n   * Emits every 100ms while audio is playing\n   *\n   * @since 6.5.0\n   * return {@link CurrentTimeEvent}\n   */\n  addListener(eventName: 'currentTime', listenerFunc: CurrentTimeListener): Promise<PluginListenerHandle>;\n  /**\n   * Clear the audio cache for remote audio files\n   * @since 6.5.0\n   * @returns {Promise<void>}\n   */\n  clearCache(): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Deinitialize the plugin and restore original audio session settings\n   * This method stops all playing audio and reverts any audio session changes made by the plugin\n   * Use this when you need to ensure compatibility with other audio plugins\n   *\n   * @since 7.7.0\n   * @returns {Promise<void>}\n   */\n  deinitPlugin(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface CompletedEvent {\n  /**\n   * Emit when a play completes\n   *\n   * @since  5.0.0\n   */\n  assetId: string;\n}\nexport type CompletedListener = (state: CompletedEvent) => void;\nexport interface Assets {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n}\nexport interface AssetVolume {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Volume of the audio, between 0.1 and 1.0\n   */\n  volume: number;\n}\n\nexport interface AssetRate {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Rate of the audio, between 0.1 and 1.0\n   */\n  rate: number;\n}\n\nexport interface AssetPlayOptions {\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Time to start playing the audio, in milliseconds\n   */\n  time?: number;\n  /**\n   * Delay to start playing the audio, in milliseconds\n   */\n  delay?: number;\n}\n\nexport interface ConfigureOptions {\n  /**\n   * Play the audio with Fade effect, only available for IOS\n   */\n  fade?: boolean;\n  /**\n   * focus the audio with Audio Focus\n   */\n  focus?: boolean;\n  /**\n   * Play the audio in the background\n   */\n  background?: boolean;\n  /**\n   * Ignore silent mode, works only on iOS setting this will nuke other audio apps\n   */\n  ignoreSilent?: boolean;\n  /**\n   * Show audio playback in the notification center (iOS and Android)\n   * When enabled, displays audio metadata (title, artist, album, artwork) in the system notification\n   */\n  showNotification?: boolean;\n}\n\nexport interface NotificationMetadata {\n  /**\n   * The title to display in the notification center\n   */\n  title?: string;\n  /**\n   * The artist name to display in the notification center\n   */\n  artist?: string;\n  /**\n   * The album name to display in the notification center\n   */\n  album?: string;\n  /**\n   * URL or local path to the artwork/album art image\n   */\n  artworkUrl?: string;\n}\n\nexport interface PreloadOptions {\n  /**\n   * Path to the audio file, relative path of the file, absolute url (file://) or remote url (https://)\n   * Supported formats:\n   * - MP3, WAV (all platforms)\n   * - M3U8/HLS streams (iOS and Android)\n   */\n  assetPath: string;\n  /**\n   * Asset Id, unique identifier of the file\n   */\n  assetId: string;\n  /**\n   * Volume of the audio, between 0.1 and 1.0\n   */\n  volume?: number;\n  /**\n   * Audio channel number, default is 1\n   */\n  audioChannelNum?: number;\n  /**\n   * Is the audio file a URL, pass true if assetPath is a `file://` url\n   * or a streaming URL (m3u8)\n   */\n  isUrl?: boolean;\n  /**\n   * Metadata to display in the notification center when audio is playing\n   * Only used when showNotification is enabled in configure()\n   */\n  notificationMetadata?: NotificationMetadata;\n}\n\nexport interface CurrentTimeEvent {\n  /**\n   * Current time of the audio in seconds\n   * @since 6.5.0\n   */\n  currentTime: number;\n  /**\n   * Asset Id of the audio\n   * @since 6.5.0\n   */\n  assetId: string;\n}\nexport type CurrentTimeListener = (state: CurrentTimeEvent) => void;\n\nexport interface NativeAudio {\n  /**\n   * Configure the audio player\n   * @since 5.0.0\n   * @param option {@link ConfigureOptions}\n   * @returns\n   */\n  configure(options: ConfigureOptions): Promise<void>;\n  /**\n   * Load an audio file\n   * @since 5.0.0\n   * @param option {@link PreloadOptions}\n   * @returns\n   */\n  preload(options: PreloadOptions): Promise<void>;\n  /**\n   * Check if an audio file is preloaded\n   *\n   * @since 6.1.0\n   * @param option {@link Assets}\n   * @returns {Promise<boolean>}\n   */\n  isPreloaded(options: PreloadOptions): Promise<{ found: boolean }>;\n  /**\n   * Play an audio file\n   * @since 5.0.0\n   * @param option {@link PlayOptions}\n   * @returns\n   */\n  play(options: { assetId: string; time?: number; delay?: number }): Promise<void>;\n  /**\n   * Pause an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  pause(options: Assets): Promise<void>;\n  /**\n   * Resume an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  resume(options: Assets): Promise<void>;\n  /**\n   * Stop an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  loop(options: Assets): Promise<void>;\n  /**\n   * Stop an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  stop(options: Assets): Promise<void>;\n  /**\n   * Unload an audio file\n   * @since 5.0.0\n   * @param option {@link Assets}\n   * @returns\n   */\n  unload(options: Assets): Promise<void>;\n  /**\n   * Set the volume of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetVolume}\n   * @returns {Promise<void>}\n   */\n  setVolume(options: { assetId: string; volume: number }): Promise<void>;\n  /**\n   * Set the rate of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<void>}\n   */\n  setRate(options: { assetId: string; rate: number }): Promise<void>;\n  /**\n   * Set the current time of an audio file\n   * @since 6.5.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<void>}\n   */\n  setCurrentTime(options: { assetId: string; time: number }): Promise<void>;\n  /**\n   * Get the current time of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<{ currentTime: number }>}\n   */\n  getCurrentTime(options: { assetId: string }): Promise<{ currentTime: number }>;\n  /**\n   * Get the duration of an audio file\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<{ duration: number }>}\n   */\n  getDuration(options: Assets): Promise<{ duration: number }>;\n  /**\n   * Check if an audio file is playing\n   *\n   * @since 5.0.0\n   * @param option {@link AssetPlayOptions}\n   * @returns {Promise<boolean>}\n   */\n  isPlaying(options: Assets): Promise<{ isPlaying: boolean }>;\n  /**\n   * Listen for complete event\n   *\n   * @since 5.0.0\n   * return {@link CompletedEvent}\n   */\n  addListener(eventName: 'complete', listenerFunc: CompletedListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for current time updates\n   * Emits every 100ms while audio is playing\n   *\n   * @since 6.5.0\n   * return {@link CurrentTimeEvent}\n   */\n  addListener(eventName: 'currentTime', listenerFunc: CurrentTimeListener): Promise<PluginListenerHandle>;\n  /**\n   * Clear the audio cache for remote audio files\n   * @since 6.5.0\n   * @returns {Promise<void>}\n   */\n  clearCache(): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Deinitialize the plugin and restore original audio session settings\n   * This method stops all playing audio and reverts any audio session changes made by the plugin\n   * Use this when you need to ensure compatibility with other audio plugins\n   *\n   * @since 7.7.0\n   * @returns {Promise<void>}\n   */\n  deinitPlugin(): Promise<void>;\n}\n"]}

package/ios/Sources/NativeAudioPlugin/AudioAsset.swift

@@ -26,7 +26,7 @@ public class AudioAsset: NSObject, AVAudioPlayerDelegate {
     let FADEDELAY: Float = 0.08
 
     // Maximum number of channels to prevent excessive resource usage
-    private let MAX_CHANNELS = Constant.MaxChannels
+    private let maxChannels = Constant.MaxChannels
 
     private var currentTimeTimer: Timer?
     internal var fadeTimer: Timer?
@@ -65,7 +65,7 @@ public class AudioAsset: NSObject, AVAudioPlayerDelegate {
         }
 
         // Limit channels to a reasonable maximum to prevent resource issues
-        let channelCount = min(max(channels ?? 1, 1), MAX_CHANNELS)
+        let channelCount = min(max(channels ?? 1, 1), maxChannels)
 
         owner.executeOnAudioQueue { [weak self] in
             guard let self = self else { return }

package/ios/Sources/NativeAudioPlugin/Constant.swift

@@ -17,6 +17,8 @@ public class Constant {
     public static let Loop = "loop"
     public static let Background = "background"
     public static let IgnoreSilent = "ignoreSilent"
+    public static let ShowNotification = "showNotification"
+    public static let NotificationMetadata = "notificationMetadata"
 
     // Default values - used for consistency across the plugin
     public static let DefaultVolume: Float = 1.0

package/ios/Sources/NativeAudioPlugin/Plugin.swift

@@ -2,6 +2,7 @@ import AVFoundation
 import Capacitor
 import CoreAudio
 import Foundation
+import MediaPlayer
 
 enum MyError: Error {
     case runtimeError(String)
@@ -9,9 +10,10 @@ enum MyError: Error {
 
 /// Please read the Capacitor iOS Plugin Development Guide
 /// here: https://capacitor.ionicframework.com/docs/plugins/ios
+// swiftlint:disable type_body_length file_length
 @objc(NativeAudio)
 public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
-    private let pluginVersion: String = "7.7.7"
+    private let pluginVersion: String = "7.8.0"
     public let identifier = "NativeAudio"
     public let jsName = "NativeAudio"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -54,6 +56,11 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
     // Add observer for audio session interruptions
     private var interruptionObserver: Any?
 
+    // Notification center support
+    private var showNotification = false
+    private var notificationMetadataMap: [String: [String: String]] = [:]
+    private var currentlyPlayingAssetId: String?
+
     @objc override public func load() {
         super.load()
         audioQueue.setSpecific(key: queueKey, value: true)
@@ -63,6 +70,7 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
         // Don't setup audio session on load - defer until first use
         // setupAudioSession()
         setupInterruptionHandling()
+        setupRemoteCommandCenter()
 
         NotificationCenter.default.addObserver(forName: UIApplication.didEnterBackgroundNotification, object: nil, queue: .main) { [weak self] _ in
             guard let strongSelf = self else { return }
@@ -143,6 +151,89 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
         }
     }
 
+    // swiftlint:disable function_body_length
+    private func setupRemoteCommandCenter() {
+        let commandCenter = MPRemoteCommandCenter.shared()
+
+        // Play command
+        commandCenter.playCommand.addTarget { [weak self] _ in
+            guard let self = self, let assetId = self.currentlyPlayingAssetId else {
+                return .noSuchContent
+            }
+
+            self.audioQueue.sync {
+                guard let asset = self.audioList[assetId] as? AudioAsset else {
+                    return
+                }
+
+                if !asset.isPlaying() {
+                    asset.resume()
+                    self.updatePlaybackState(isPlaying: true)
+                }
+            }
+            return .success
+        }
+
+        // Pause command
+        commandCenter.pauseCommand.addTarget { [weak self] _ in
+            guard let self = self, let assetId = self.currentlyPlayingAssetId else {
+                return .noSuchContent
+            }
+
+            self.audioQueue.sync {
+                guard let asset = self.audioList[assetId] as? AudioAsset else {
+                    return
+                }
+
+                asset.pause()
+                self.updatePlaybackState(isPlaying: false)
+            }
+            return .success
+        }
+
+        // Stop command
+        commandCenter.stopCommand.addTarget { [weak self] _ in
+            guard let self = self, let assetId = self.currentlyPlayingAssetId else {
+                return .noSuchContent
+            }
+
+            self.audioQueue.sync {
+                guard let asset = self.audioList[assetId] as? AudioAsset else {
+                    return
+                }
+
+                asset.stop()
+                self.clearNowPlayingInfo()
+                self.currentlyPlayingAssetId = nil
+                self.updatePlaybackState(isPlaying: false)
+            }
+            return .success
+        }
+
+        // Toggle play/pause command
+        commandCenter.togglePlayPauseCommand.addTarget { [weak self] _ in
+            guard let self = self, let assetId = self.currentlyPlayingAssetId else {
+                return .noSuchContent
+            }
+
+            self.audioQueue.sync {
+                guard let asset = self.audioList[assetId] as? AudioAsset else {
+                    return
+                }
+
+                if asset.isPlaying() {
+                    asset.pause()
+                    self.updatePlaybackState(isPlaying: false)
+                } else {
+                    asset.resume()
+                    self.updatePlaybackState(isPlaying: true)
+                }
+            }
+            return .success
+        }
+    }
+    // swiftlint:enable function_body_length
+
     @objc func configure(_ call: CAPPluginCall) {
         // Save original category on first configure call
         if !audioSessionInitialized {
@@ -158,6 +249,7 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
         let focus = call.getBool(Constant.FocusAudio) ?? false
         let background = call.getBool(Constant.Background) ?? false
         let ignoreSilent = call.getBool(Constant.IgnoreSilent) ?? true
+        self.showNotification = call.getBool(Constant.ShowNotification) ?? false
 
         // Use a single audio session configuration block for better atomicity
         do {
@@ -283,6 +375,14 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
                 } else {
                     audioAsset.play(time: time, delay: delay)
                 }
+
+                // Update notification center if enabled
+                if self.showNotification {
+                    self.currentlyPlayingAssetId = audioId
+                    self.updateNowPlayingInfo(audioId: audioId, audioAsset: audioAsset)
+                    self.updatePlaybackState(isPlaying: true)
+                }
+
                 call.resolve()
             } else if let audioNumber = asset as? NSNumber {
                 self.activateSession()
@@ -350,6 +450,12 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
             }
             self.activateSession()
             audioAsset.resume()
+
+            // Update notification when resumed
+            if self.showNotification {
+                self.updatePlaybackState(isPlaying: true)
+            }
+
             call.resolve()
         }
     }
@@ -362,6 +468,12 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
             }
 
             audioAsset.pause()
+
+            // Update notification when paused
+            if self.showNotification {
+                self.updatePlaybackState(isPlaying: false)
+            }
+
             self.endSession()
             call.resolve()
         }
@@ -378,6 +490,13 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
 
             do {
                 try self.stopAudio(audioId: audioId)
+
+                // Clear notification when stopped
+                if self.showNotification {
+                    self.clearNowPlayingInfo()
+                    self.currentlyPlayingAssetId = nil
+                }
+
                 self.endSession()
                 call.resolve()
             } catch {
@@ -468,6 +587,7 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
         }
     }
 
+    // swiftlint:disable cyclomatic_complexity function_body_length
     @objc private func preloadAsset(_ call: CAPPluginCall, isComplex complex: Bool) {
         // Common default values to ensure consistency
         let audioId = call.getString(Constant.AssetIdKey) ?? ""
@@ -487,6 +607,26 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
             return
         }
 
+        // Store notification metadata if provided
+        if let metadata = call.getObject(Constant.NotificationMetadata) {
+            var metadataDict: [String: String] = [:]
+            if let title = metadata["title"] as? String {
+                metadataDict["title"] = title
+            }
+            if let artist = metadata["artist"] as? String {
+                metadataDict["artist"] = artist
+            }
+            if let album = metadata["album"] as? String {
+                metadataDict["album"] = album
+            }
+            if let artworkUrl = metadata["artworkUrl"] as? String {
+                metadataDict["artworkUrl"] = artworkUrl
+            }
+            if !metadataDict.isEmpty {
+                notificationMetadataMap[audioId] = metadataDict
+            }
+        }
+
         if complex {
             volume = min(max(call.getFloat("volume") ?? Constant.DefaultVolume, Constant.MinVolume), Constant.MaxVolume)
             channels = max(call.getInt("channels") ?? Constant.DefaultChannels, 1)
@@ -593,6 +733,7 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
             call.resolve()
         }
     }
+    // swiftlint:enable cyclomatic_complexity function_body_length
 
     private func stopAudio(audioId: String) throws {
         var asset: AudioAsset?
@@ -648,6 +789,9 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
             }
         }
 
+        // Clear notification center
+        clearNowPlayingInfo()
+
         // Restore original audio session settings if we changed them
         if audioSessionInitialized, let originalCategory = originalAudioCategory {
             do {
@@ -670,4 +814,87 @@ public class NativeAudio: CAPPlugin, AVAudioPlayerDelegate, CAPBridgedPlugin {
         call.resolve()
     }
 
+    // MARK: - Now Playing Info Methods
+
+    private func updateNowPlayingInfo(audioId: String, audioAsset: AudioAsset) {
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+
+            var nowPlayingInfo = [String: Any]()
+
+            // Get metadata from the map
+            if let metadata = self.notificationMetadataMap[audioId] {
+                if let title = metadata["title"] {
+                    nowPlayingInfo[MPMediaItemPropertyTitle] = title
+                }
+                if let artist = metadata["artist"] {
+                    nowPlayingInfo[MPMediaItemPropertyArtist] = artist
+                }
+                if let album = metadata["album"] {
+                    nowPlayingInfo[MPMediaItemPropertyAlbumTitle] = album
+                }
+
+                // Load artwork if provided
+                if let artworkUrl = metadata["artworkUrl"] {
+                    self.loadArtwork(from: artworkUrl) { image in
+                        if let image = image {
+                            nowPlayingInfo[MPMediaItemPropertyArtwork] = MPMediaItemArtwork(boundsSize: image.size) { _ in
+                                return image
+                            }
+                            MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
+                        }
+                    }
+                }
+            }
+
+            // Add playback info
+            nowPlayingInfo[MPMediaItemPropertyPlaybackDuration] = audioAsset.getDuration()
+            nowPlayingInfo[MPNowPlayingInfoPropertyElapsedPlaybackTime] = audioAsset.getCurrentTime()
+            nowPlayingInfo[MPNowPlayingInfoPropertyPlaybackRate] = 1.0
+
+            MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
+        }
+    }
+
+    private func clearNowPlayingInfo() {
+        DispatchQueue.main.async {
+            MPNowPlayingInfoCenter.default().nowPlayingInfo = nil
+        }
+    }
+
+    private func updatePlaybackState(isPlaying: Bool) {
+        DispatchQueue.main.async {
+            var nowPlayingInfo = MPNowPlayingInfoCenter.default().nowPlayingInfo ?? [String: Any]()
+            nowPlayingInfo[MPNowPlayingInfoPropertyPlaybackRate] = isPlaying ? 1.0 : 0.0
+            MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
+        }
+    }
+
+    private func loadArtwork(from urlString: String, completion: @escaping (UIImage?) -> Void) {
+        // Check if it's a local file path or URL
+        if let url = URL(string: urlString) {
+            if url.scheme == nil || url.isFileURL {
+                // Local file
+                let path = url.path
+                if FileManager.default.fileExists(atPath: path) {
+                    if let image = UIImage(contentsOfFile: path) {
+                        completion(image)
+                        return
+                    }
+                }
+            } else {
+                // Remote URL
+                URLSession.shared.dataTask(with: url) { data, _, _ in
+                    if let data = data, let image = UIImage(data: data) {
+                        completion(image)
+                    } else {
+                        completion(nil)
+                    }
+                }.resume()
+                return
+            }
+        }
+        completion(nil)
+    }
+
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/native-audio",
-  "version": "7.7.7",
+  "version": "7.8.0",
   "description": "A native plugin for native audio engine",
   "license": "MIT",
   "main": "dist/plugin.cjs.js",