tunzo-player 1.0.29 → 1.0.31

package/README.md

@@ -76,11 +76,16 @@ yarn add tunzo-player
 | 3     | High (160kbps)    |
 | 4     | Ultra (320kbps)   |
 
-| 4     | Ultra (320kbps)   |
-
 ## 📱 Native Configuration (Ionic/Capacitor)
 
-To ensure background audio works correctly on Android and iOS (preventing the app from pausing when the screen locks), you must configure your native projects.
+To ensure background audio works correctly on Android and iOS, you need to install the KeepAwake plugin in your main app.
+
+### **Installation**
+
+```bash
+npm install @capacitor-community/keep-awake
+npx cap sync
+```
 
 ### **Android (`android/app/src/main/AndroidManifest.xml`)**
 
@@ -88,11 +93,8 @@ Add the following permissions inside the `<manifest>` tag:
 
 ```xml
 <uses-permission android:name="android.permission.WAKE_LOCK" />
-<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
 ```
 
-**Note:** Modern Android versions might require a foreground service notification to keep the audio alive indefinitely. The `MediaSession` API implemented in this package helps, but for guaranteed persistence, consider using a native audio plugin if issues persist.
-
 ### **iOS (`ios/App/App/Info.plist`)**
 
 Add `audio` to the `UIBackgroundModes` key to allow background playback:
@@ -104,8 +106,11 @@ Add `audio` to the `UIBackgroundModes` key to allow background playback:
 </array>
 ```
 
+**Note:** The player uses HTML5 Audio with MediaSession API for lock screen controls. This works with MP4/AAC audio streams (like JioSaavn) on both Android and iOS.
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please open an issue or submit a pull request.
 
 # tunzo-player
+

package/dist/core/player.js

@@ -206,33 +206,43 @@ class Player {
         }
     }
     static updateMediaSessionMetadata(song) {
-        var _a;
+        var _a, _b;
         if ('mediaSession' in navigator) {
+            // Extract artwork from image array
             const artwork = [];
-            if (song.image) {
-                if (Array.isArray(song.image)) {
-                    song.image.forEach((img) => {
-                        let src = img.link || img.url || (typeof img === 'string' ? img : '');
-                        if (src) {
-                            if (src.startsWith('http://')) {
-                                src = src.replace('http://', 'https://');
-                            }
-                            artwork.push({ src, sizes: '500x500', type: 'image/jpeg' });
-                        }
-                    });
-                }
-                else if (typeof song.image === 'string') {
-                    let src = song.image;
+            if (song.image && Array.isArray(song.image)) {
+                // Get the highest quality image (last in array, usually 500x500)
+                const highQualityImage = song.image[song.image.length - 1];
+                if (highQualityImage && highQualityImage.url) {
+                    let src = highQualityImage.url;
                     if (src.startsWith('http://')) {
                         src = src.replace('http://', 'https://');
                     }
-                    artwork.push({ src: src, sizes: '500x500', type: 'image/jpeg' });
+                    // Skip placeholder images
+                    if (!src.includes('_i/share-image')) {
+                        artwork.push({
+                            src,
+                            sizes: highQualityImage.quality || '500x500',
+                            type: 'image/jpeg'
+                        });
+                    }
                 }
             }
+            // Extract artist name from artists.primary array
+            let artistName = 'Unknown Artist';
+            if (((_a = song.artists) === null || _a === void 0 ? void 0 : _a.primary) && Array.isArray(song.artists.primary) && song.artists.primary.length > 0) {
+                artistName = song.artists.primary.map((artist) => artist.name).join(', ');
+            }
+            else if (song.primaryArtists) {
+                artistName = song.primaryArtists;
+            }
+            else if (song.artist) {
+                artistName = song.artist;
+            }
             navigator.mediaSession.metadata = new MediaMetadata({
                 title: song.name || song.title || 'Unknown Title',
-                artist: song.primaryArtists || song.artist || 'Unknown Artist',
-                album: ((_a = song.album) === null || _a === void 0 ? void 0 : _a.name) || song.album || 'Unknown Album',
+                artist: artistName,
+                album: ((_b = song.album) === null || _b === void 0 ? void 0 : _b.name) || 'Unknown Album',
                 artwork: artwork.length > 0 ? artwork : undefined
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tunzo-player",
-    "version": "1.0.29",
+    "version": "1.0.31",
     "description": "A music playback service for Angular and Ionic apps with native audio control support.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/src/core/player.ts

@@ -250,31 +250,41 @@ export class Player {
 
   private static updateMediaSessionMetadata(song: any) {
     if ('mediaSession' in navigator) {
+      // Extract artwork from image array
       const artwork = [];
-      if (song.image) {
-        if (Array.isArray(song.image)) {
-          song.image.forEach((img: any) => {
-            let src = img.link || img.url || (typeof img === 'string' ? img : '');
-            if (src) {
-              if (src.startsWith('http://')) {
-                src = src.replace('http://', 'https://');
-              }
-              artwork.push({ src, sizes: '500x500', type: 'image/jpeg' });
-            }
-          });
-        } else if (typeof song.image === 'string') {
-          let src = song.image;
+      if (song.image && Array.isArray(song.image)) {
+        // Get the highest quality image (last in array, usually 500x500)
+        const highQualityImage = song.image[song.image.length - 1];
+        if (highQualityImage && highQualityImage.url) {
+          let src = highQualityImage.url;
           if (src.startsWith('http://')) {
             src = src.replace('http://', 'https://');
           }
-          artwork.push({ src: src, sizes: '500x500', type: 'image/jpeg' });
+          // Skip placeholder images
+          if (!src.includes('_i/share-image')) {
+            artwork.push({
+              src,
+              sizes: highQualityImage.quality || '500x500',
+              type: 'image/jpeg'
+            });
+          }
         }
       }
 
+      // Extract artist name from artists.primary array
+      let artistName = 'Unknown Artist';
+      if (song.artists?.primary && Array.isArray(song.artists.primary) && song.artists.primary.length > 0) {
+        artistName = song.artists.primary.map((artist: any) => artist.name).join(', ');
+      } else if (song.primaryArtists) {
+        artistName = song.primaryArtists;
+      } else if (song.artist) {
+        artistName = song.artist;
+      }
+
       navigator.mediaSession.metadata = new MediaMetadata({
         title: song.name || song.title || 'Unknown Title',
-        artist: song.primaryArtists || song.artist || 'Unknown Artist',
-        album: song.album?.name || song.album || 'Unknown Album',
+        artist: artistName,
+        album: song.album?.name || 'Unknown Album',
         artwork: artwork.length > 0 ? artwork : undefined
       });
     }