react-native-mp3-player 1.0.1 → 1.0.3

package/README.md

@@ -9,7 +9,9 @@ React Native audio player with **reliable iOS background playback**, media contr
 
 ## Features
 
-- **iOS background playback** – Audio continues when the app is in the background (no ~50s cutoff). Uses `AVAudioSession` with `.longFormAudio` and interruption handling.
+- **Background playback (iOS & Android)** – Audio continues when the app is in the background or the screen is locked. No patches required; compatible with current Xcode and Android 14/15.
+- **iOS** – Uses `AVAudioSession` with `.longFormAudio` and interruption handling; lock screen and Control Center work natively.
+- **Android** – Uses Media3 `MediaLibraryService` with `foregroundServiceType="mediaPlayback"`; system media notification, lock screen, and Android Auto are supported.
 - **Multi-platform** – Android, iOS, Windows.
 - **Media controls** – Lock screen, notification, Bluetooth, Android Auto.
 - **Queue & playback** – Add, remove, reorder tracks; play, pause, seek, repeat, crossfade (where supported).
@@ -33,6 +35,15 @@ For audio to continue when the app is backgrounded or the screen is locked (and
 2. The package configures **AVAudioSession** (category `.playback` with options for Bluetooth, AirPlay, ducking) and handles **interruptions** and **background transitions** so that playback can continue when the app is backgrounded.
 3. **Lock screen and Control Center** controls (play, pause, seek, 15-second skip) are handled **natively**, so they work even when the JavaScript thread is suspended (e.g. screen locked). When the app returns to the foreground, events are emitted so your UI stays in sync.
 
+### Android background playback
+
+The package is built for **Android 14+** compatibility and works when the app is in the background or the screen is off:
+
+1. **Foreground service:** The library declares `FOREGROUND_SERVICE_MEDIA_PLAYBACK` and uses `android:foregroundServiceType="mediaPlayback"` on the playback service, as required since Android 14. No extra setup in your app is needed.
+2. **Media3 / ExoPlayer:** Playback runs in a **MediaLibraryService** (Media3), which correctly starts as a foreground service with type `mediaPlayback`, so background playback and the media notification are allowed by the system.
+3. **Media controls:** The service is advertised via **MediaSessionService** and **MediaLibraryService** so the system media notification, lock screen, Bluetooth, and Android Auto can discover and control playback.
+4. **Target SDK:** The library compiles with `compileSdkVersion` 35 and defaults to `targetSdkVersion` 34. Your app can override these via `react-native-mp3-player`’s build extras if needed. **Android 15:** Do not start the media service from a `BOOT_COMPLETED` receiver; the platform no longer allows that for media playback.
+
 ## Quick start
 
 ```javascript

package/android/src/main/AndroidManifest.xml

@@ -17,6 +17,7 @@
             android:foregroundServiceType="mediaPlayback">
             <intent-filter>
                 <action android:name="android.intent.action.MEDIA_BUTTON" />
+                <action android:name="androidx.media3.session.MediaSessionService" />
                 <action android:name="androidx.media3.session.MediaLibraryService" />
                 <action android:name="android.media.browse.MediaBrowserService" />
             </intent-filter>

package/ios/RNTrackPlayer/Models/MetadataAdapter.swift

@@ -1,6 +1,6 @@
 //
 //  MetadataAdapter.swift
-//  react-native-track-player
+//  react-native-mp3-player
 //
 //  Created by David Chavez on 01.08.23.
 //  Copyright © 2023 Double Symmetry. All rights reserved.

package/ios/RNTrackPlayer/TrackPlayer.mm

@@ -1,9 +1,9 @@
 #import "TrackPlayer.h"
 
-#if __has_include("react_native_track_player-Swift.h")
-#import "react_native_track_player-Swift.h"
+#if __has_include("react_native_mp3_player-Swift.h")
+#import "react_native_mp3_player-Swift.h"
 #else
-#import "react_native_track_player/react_native_track_player-Swift.h"
+#import "react_native_mp3_player/react_native_mp3_player-Swift.h"
 #endif
 
 @interface NativeTrackPlayer () <RNTPDelegate>

package/ios/SwiftAudioEx/Sources/SwiftAudioEx/AudioTap.swift

@@ -86,12 +86,12 @@ extension AVPlayerWrapper {
         
         
         // https://stackoverflow.com/questions/79679383/unmanaged-object-pointer-build-issues-in-xcode-26-beta
-        // XCode 26 sdk change
-        var tapRef: MTAudioProcessingTap?
+        // Xcode 16+ / 26 SDK: tapOut expects Unmanaged<MTAudioProcessingTap>? (API returns retained CF object).
+        var tapRef: Unmanaged<MTAudioProcessingTap>?
         let error = MTAudioProcessingTapCreate(kCFAllocatorDefault, &callbacks, kMTAudioProcessingTapCreationFlag_PreEffects, &tapRef)
         assert(error == noErr)
         
-        params.audioTapProcessor = tapRef
+        params.audioTapProcessor = tapRef?.takeRetainedValue()
         
         audioMix.inputParameters = [params]
         item.audioMix = audioMix

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-mp3-player",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "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",