tunzo-player 1.0.24 → 1.0.25

package/README.md

@@ -76,4 +76,36 @@ 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.
+
+### **Android (`android/app/src/main/AndroidManifest.xml`)**
+
+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:
+
+```xml
+<key>UIBackgroundModes</key>
+<array>
+    <string>audio</string>
+</array>
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
 # tunzo-player

package/dist/core/player.js

@@ -28,6 +28,8 @@ class Player {
             url = url.replace('http://', 'https://');
         }
         this.audio.src = url;
+        // @ts-ignore
+        this.audio.title = song.name || song.title || 'Unknown Title'; // Help some browsers identify the track
         this.audio.preload = 'auto'; // Improve loading
         this.audio.load(); // Ensure audio is loaded before play
         this.audio.play().then(() => {
@@ -48,6 +50,22 @@ class Player {
         // Set current time
         this.audio.ontimeupdate = () => {
             this.currentTime = this.audio.currentTime;
+            // Update position state less frequently to avoid spamming, but enough to keep sync
+            if (Math.floor(this.currentTime) % 5 === 0) {
+                this.updatePositionState();
+            }
+        };
+        // Handle buffering/stalled states
+        this.audio.onwaiting = () => {
+            if ('mediaSession' in navigator) {
+                navigator.mediaSession.playbackState = 'none'; // Or 'paused' to indicate buffering
+            }
+        };
+        this.audio.onplaying = () => {
+            this.isPlaying = true;
+            if ('mediaSession' in navigator) {
+                navigator.mediaSession.playbackState = 'playing';
+            }
         };
         // Auto-play next song
         this.audio.onended = () => {
@@ -186,20 +204,28 @@ class Player {
                 if (Array.isArray(song.image)) {
                     // Assuming image array contains objects with url/link and quality
                     song.image.forEach((img) => {
-                        const src = img.link || img.url || (typeof img === 'string' ? img : '');
+                        let src = img.link || img.url || (typeof img === 'string' ? img : '');
                         if (src) {
+                            // 🚀 Auto-convert http → https for images too
+                            if (src.startsWith('http://')) {
+                                src = src.replace('http://', 'https://');
+                            }
                             artwork.push({ src, sizes: '500x500', type: 'image/jpeg' });
                         }
                     });
                 }
                 else if (typeof song.image === 'string') {
-                    artwork.push({ src: song.image, sizes: '500x500', type: 'image/jpeg' });
+                    let src = song.image;
+                    if (src.startsWith('http://')) {
+                        src = src.replace('http://', 'https://');
+                    }
+                    artwork.push({ src: src, sizes: '500x500', type: 'image/jpeg' });
                 }
             }
             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 || '',
+                album: ((_a = song.album) === null || _a === void 0 ? void 0 : _a.name) || song.album || 'Unknown Album',
                 artwork: artwork.length > 0 ? artwork : undefined
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tunzo-player",
-    "version": "1.0.24",
+    "version": "1.0.25",
     "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

@@ -42,6 +42,8 @@ export class Player {
     }
 
     this.audio.src = url;
+    // @ts-ignore
+    this.audio.title = song.name || song.title || 'Unknown Title'; // Help some browsers identify the track
     this.audio.preload = 'auto'; // Improve loading
     this.audio.load(); // Ensure audio is loaded before play
     this.audio.play().then(() => {
@@ -64,6 +66,24 @@ export class Player {
     // Set current time
     this.audio.ontimeupdate = () => {
       this.currentTime = this.audio.currentTime;
+      // Update position state less frequently to avoid spamming, but enough to keep sync
+      if (Math.floor(this.currentTime) % 5 === 0) {
+        this.updatePositionState();
+      }
+    };
+
+    // Handle buffering/stalled states
+    this.audio.onwaiting = () => {
+      if ('mediaSession' in navigator) {
+        navigator.mediaSession.playbackState = 'none'; // Or 'paused' to indicate buffering
+      }
+    };
+
+    this.audio.onplaying = () => {
+      this.isPlaying = true;
+      if ('mediaSession' in navigator) {
+        navigator.mediaSession.playbackState = 'playing';
+      }
     };
 
     // Auto-play next song
@@ -226,20 +246,28 @@ export class Player {
         if (Array.isArray(song.image)) {
           // Assuming image array contains objects with url/link and quality
           song.image.forEach((img: any) => {
-            const src = img.link || img.url || (typeof img === 'string' ? img : '');
+            let src = img.link || img.url || (typeof img === 'string' ? img : '');
             if (src) {
+              // 🚀 Auto-convert http → https for images too
+              if (src.startsWith('http://')) {
+                src = src.replace('http://', 'https://');
+              }
               artwork.push({ src, sizes: '500x500', type: 'image/jpeg' });
             }
           });
         } else if (typeof song.image === 'string') {
-          artwork.push({ src: song.image, sizes: '500x500', type: 'image/jpeg' });
+          let src = song.image;
+          if (src.startsWith('http://')) {
+            src = src.replace('http://', 'https://');
+          }
+          artwork.push({ src: src, sizes: '500x500', type: 'image/jpeg' });
         }
       }
 
       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 || '',
+        album: song.album?.name || song.album || 'Unknown Album',
         artwork: artwork.length > 0 ? artwork : undefined
       });
     }