react-native-queue-player 1.2.0 → 2.0.0

package/QueuePlayer.podspec

@@ -10,7 +10,10 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  s.platforms    = { :ios => min_ios_version_supported }
+  # Declared explicitly rather than inherited from
+  # `min_ios_version_supported`, which resolves lower: AVPlayer and
+  # AVPlayerItem only drop their main-thread requirement at iOS 16.
+  s.platforms    = { :ios => '16.0' }
   s.source       = { :git => "https://github.com/ghenry22/react-native-queue-player.git", :tag => "#{s.version}" }
 
   # NOTE on cross-pod consumer-Swift access:
@@ -64,11 +67,11 @@ Pod::Spec.new do |s|
 
   # Opt-in Chromecast subspec. Consumer Podfile adds:
   #   pod 'QueuePlayer/Chromecast', :path => '...'
-  # alongside the default `pod 'QueuePlayer'`. iOS 15.0 floor matches
-  # Google Cast SDK 4.8.x's supported deployment target.
+  # alongside the default `pod 'QueuePlayer'`. The 16.0 floor tracks the
+  # library's own and sits above Google Cast SDK 4.8.x's iOS 15.0 minimum.
   s.subspec 'Chromecast' do |ss|
     ss.source_files = 'ios/Cast/Chromecast/**/*.swift'
-    ss.ios.deployment_target = '15.0'
+    ss.ios.deployment_target = '16.0'
     ss.dependency 'google-cast-sdk', '~> 4.8.4'
   end
 
@@ -87,11 +90,13 @@ Pod::Spec.new do |s|
   s.dependency 'React-jsi'
   s.dependency 'React-callinvoker'
 
-  # Cast serves consumer-supplied `file://` URLs to pull-only receivers
-  # (Chromecast / future DLNA) via a native `Network.framework` listener
-  # (`LocalMediaServer` / `MediaHTTPConnection`) — no third-party HTTP
-  # server dependency, no `:modular_headers` requirement on the consumer.
-  # Orthogonal to the streaming-only lookahead cache.
+  # The shared local-HTTP media server (`ios/MediaServer/MediaHTTPConnection`)
+  # serves media over a native `Network.framework` listener — no third-party
+  # HTTP server dependency, no `:modular_headers` requirement on the consumer.
+  # Two servers use it: Cast's `LocalMediaServer` serves consumer-supplied
+  # `file://` URLs to pull-only receivers (Chromecast / future DLNA), and the
+  # lookahead cache's `ReadThroughServer` serves the local player from the
+  # cache or, on a miss, the origin.
 
   load 'nitrogen/generated/ios/QueuePlayer+autolinking.rb'
   add_nitrogen_files(s)

package/README.md

@@ -24,13 +24,13 @@ A complete audio playback library for React Native — gapless and crossfade eng
 - **Remote-control skip mode** — choose track skip or interval skip (jump ±N seconds) for the lock screen / notification, adjustable at runtime.
 - **Sleep timer** — pause after a duration or at the end of the current track, with a volume fade; runs on a native wall-clock deadline.
 - **Now Playing format** — codec, container, sample rate, bitrate, and ReplayGain metadata for the active track.
-- **React hooks** — `useProgress`, `usePlaybackState`, `useActiveTrack`, `useCanSkip`, `useSleepTimer`, `useEqualizer`, `useVisualizerState`, `useLookaheadCache`, `useNowPlayingFormat`, `useCast`, `useAudioRoute`.
+- **React hooks** — `useProgress`, `usePlaybackState`, `useActiveTrack`, `useQueue`, `useCanSkip`, `useSleepTimer`, `useBufferState`, `useFullyBuffered`, `useEqualizer`, `useVisualizerState`, `useLookaheadCache`, `useNowPlayingFormat`, `useCast`, `useAudioRoute`.
 
 ## Requirements
 
 - React Native with the New Architecture enabled.
 - [`react-native-nitro-modules`](https://nitro.margelo.com/) (peer dependency).
-- iOS 15+ (the Chromecast subspec requires iOS 15).
+- iOS 16+ (Chromecast subspec included).
 - Android `minSdk` 24+.
 - Expo config-plugin support (the native setup is driven by the bundled Expo plugin).
 
@@ -107,7 +107,7 @@ The player is a singleton — `getTrackPlayer()` always returns the same instanc
 
 Most native setup is automatic (Nitro autolinking + the Android manifest merge + the Expo plugin). A few things you must do by hand — see the [Setup & manual configuration guide](https://ghenry22.github.io/react-native-queue-player/docs/guides/manual-setup) for full detail:
 
-- **iOS background audio** — add `audio` to `UIBackgroundModes` in your app config (`ios.infoPlist`). This is the one core background-playback step the plugin does not set for you:
+- **iOS background audio** — set automatically by the Expo plugin: it adds `audio` to `UIBackgroundModes` (on by default; pass `{ enableIosBGAudio: false }` only if your app declares `UIBackgroundModes` elsewhere). If you opt out, or use bare React Native (no plugin), set it yourself:
 
   ```json
   { "expo": { "ios": { "infoPlist": { "UIBackgroundModes": ["audio"] } } } }

package/android/consumer-rules.pro

@@ -10,7 +10,7 @@
 
 # libraop's JNI_OnLoad binds this class by literal descriptor: src/main/cpp/
 # airplay_jni.cpp calls FindClass on the string
-# "com/margelo/nitro/queueplayer/cast/airplay/AirplayJNI", then resolves all 28
+# "com/margelo/nitro/queueplayer/cast/airplay/AirplayJNI", then resolves all 19
 # entries of its JNINativeMethod table by name and signature. React Native's own
 # rules pin the native method names but let the class be renamed, and the rule
 # that pins the class name ships only in AGP's optional default ProGuard file.

package/android/src/main/cpp/airplay2_control.c

@@ -458,7 +458,7 @@ int ap2_record(ap2_session_t *session) {
 /* ---- FLUSH ---- */
 
 int ap2_flush(ap2_session_t *session) {
-    /* Build RTP-Info header per OwnTone airplay.c:2409-2415:
+    /* Build RTP-Info header per OwnTone airplay.c:
      * "RTP-Info: seq=<seqnum>;rtptime=<rtptime>" */
     char rtp_info[128];
     snprintf(rtp_info, sizeof(rtp_info),
@@ -524,7 +524,7 @@ int ap2_set_metadata(ap2_session_t *session,
         return -1;
     }
 
-    /* OwnTone airplay.c:2499 — adds RTP-Info header. */
+    /* OwnTone airplay.c — adds RTP-Info header. */
     char rtp_info[128];
     snprintf(rtp_info, sizeof(rtp_info),
              "RTP-Info: rtptime=%u\r\n",
@@ -556,7 +556,7 @@ int ap2_set_artwork(ap2_session_t *session,
                     const char *content_type) {
     if (!data || len == 0) return 0;
 
-    /* OwnTone airplay.c:2507-2548 — raw image body with format-specific CT. */
+    /* OwnTone airplay.c — raw image body with format-specific CT. */
     char rtp_info[128];
     snprintf(rtp_info, sizeof(rtp_info),
              "RTP-Info: rtptime=%u\r\n",
@@ -581,7 +581,7 @@ int ap2_set_artwork(ap2_session_t *session,
 int ap2_set_progress(ap2_session_t *session,
                      uint32_t elapsed_ms, uint32_t duration_ms) {
     /* Convert ms to RTP timestamps.
-     * Per OwnTone airplay.c:2481-2504 — "progress: start/current/end". */
+     * Per OwnTone airplay.c — "progress: start/current/end". */
     uint32_t rtp_start = session->rtp_timestamp;
     uint32_t rtp_pos = rtp_start + (uint32_t)((uint64_t)elapsed_ms * session->sample_rate / 1000);
     uint32_t rtp_end = rtp_start + (uint32_t)((uint64_t)duration_ms * session->sample_rate / 1000);

package/android/src/main/cpp/airplay2_control.h

@@ -41,7 +41,7 @@ int ap2_record(ap2_session_t *session);
 
 /**
  * FLUSH: stop audio playback on the receiver.
- * Sends RTP-Info header with current seq/rtptime per OwnTone airplay.c:2402-2418.
+ * Sends RTP-Info header with current seq/rtptime per OwnTone airplay.c.
  * @return 0 on success, -1 on failure
  */
 int ap2_flush(ap2_session_t *session);
@@ -55,7 +55,7 @@ int ap2_set_volume(ap2_session_t *session, float vol_db);
 
 /**
  * SET_PARAMETER metadata (DMAP-encoded title/artist/album).
- * Per OwnTone airplay.c:2551-2575.
+ * Per OwnTone airplay.c.
  * @return 0 on success, -1 on failure
  */
 int ap2_set_metadata(ap2_session_t *session,
@@ -63,7 +63,7 @@ int ap2_set_metadata(ap2_session_t *session,
 
 /**
  * SET_PARAMETER artwork (raw JPEG/PNG image bytes).
- * Per OwnTone airplay.c:2507-2548.
+ * Per OwnTone airplay.c.
  * @param content_type  "image/jpeg" or "image/png"
  * @return 0 on success, -1 on failure
  */
@@ -73,7 +73,7 @@ int ap2_set_artwork(ap2_session_t *session,
 
 /**
  * SET_PARAMETER progress (elapsed/duration in milliseconds).
- * Per OwnTone airplay.c:2481-2504. Converts ms to RTP timestamps.
+ * Per OwnTone airplay.c. Converts ms to RTP timestamps.
  * @return 0 on success, -1 on failure
  */
 int ap2_set_progress(ap2_session_t *session,

package/android/src/main/cpp/airplay2_jni.cpp

@@ -130,7 +130,7 @@ static jboolean nativeAp2Connect(JNIEnv *, jclass, jlong handle) {
      * ap2_connect() calls ap2_rtsp_connect() internally. */
     if (ap2_connect(s) != 0) {
         /* If pairing required, keep TCP alive for subsequent pair-setup.
-         * Per OwnTone airplay.c:1485-1539 — socket reused across auth. */
+         * Per OwnTone airplay.c — socket reused across auth. */
         if (s->pairing_required) {
             __android_log_print(ANDROID_LOG_INFO, TAG,
                 "Connect: pairing required (auth_mode=%d), keeping TCP alive",
@@ -204,11 +204,6 @@ static void nativeAp2Destroy(JNIEnv *, jclass, jlong handle) {
 // Pairing
 // ---------------------------------------------------------------------------
 
-static jboolean nativeAp2NeedsPairing(JNIEnv *, jclass, jlong handle) {
-    auto *s = toSession(handle);
-    return (s && s->pairing_required && !s->has_auth_key) ? JNI_TRUE : JNI_FALSE;
-}
-
 static jboolean nativeAp2PairPinStart(JNIEnv *, jclass, jlong handle) {
     auto *s = toSession(handle);
     if (!s) return JNI_FALSE;
@@ -270,11 +265,6 @@ static jstring nativeAp2PairSetup(JNIEnv *env, jclass,
     return result;
 }
 
-static jint nativeAp2GetPairingState(JNIEnv *, jclass, jlong handle) {
-    auto *s = toSession(handle);
-    return s ? static_cast<jint>(s->state) : 0;
-}
-
 static jint nativeAp2GetAuthMode(JNIEnv *, jclass, jlong handle) {
     auto *s = toSession(handle);
     return s ? static_cast<jint>(s->auth_mode) : 0;
@@ -341,7 +331,7 @@ static void nativeAp2SetVolume(JNIEnv *, jclass, jlong handle, jfloat vol) {
     s->volume = vol;
     /* Send volume over RTSP if streaming.
      * Convert 0.0-1.0 linear to dB: 0→-144 (mute), 1→0 (full).
-     * Per OwnTone airplay.c:2456-2478 — SET_PARAMETER text/parameters. */
+     * Per OwnTone airplay.c — SET_PARAMETER text/parameters. */
     if (s->state >= AP2_STATE_RECORD) {
         float vol_db;
         if (vol <= 0.0f) {
@@ -403,7 +393,7 @@ static void nativeAp2Pause(JNIEnv *, jclass, jlong handle) {
     if (!s) return;
     ap2_audio_pause(s);
     /* Send FLUSH so receiver knows audio stopped.
-     * Per OwnTone airplay.c:3660-3662 — FLUSH after stopping audio. */
+     * Per OwnTone airplay.c — FLUSH after stopping audio. */
     if (s->state >= AP2_STATE_RECORD) {
         ap2_flush(s);
     }
@@ -466,18 +456,12 @@ static const JNINativeMethod sMethods[] = {
         "(J)V",
         reinterpret_cast<void *>(nativeAp2Destroy)},
     /* Pairing */
-    {"nativeAp2NeedsPairing",
-        "(J)Z",
-        reinterpret_cast<void *>(nativeAp2NeedsPairing)},
     {"nativeAp2PairPinStart",
         "(J)Z",
         reinterpret_cast<void *>(nativeAp2PairPinStart)},
     {"nativeAp2PairSetup",
         "(JLjava/lang/String;)Ljava/lang/String;",
         reinterpret_cast<void *>(nativeAp2PairSetup)},
-    {"nativeAp2GetPairingState",
-        "(J)I",
-        reinterpret_cast<void *>(nativeAp2GetPairingState)},
     {"nativeAp2GetAuthMode",
         "(J)I",
         reinterpret_cast<void *>(nativeAp2GetAuthMode)},

package/android/src/main/cpp/airplay2_pair.c

@@ -79,14 +79,14 @@ int ap2_probe_info(ap2_session_t *session) {
     LOGI("/info: statusFlags=0x%llx", (unsigned long long)status_flags);
 
     /* Store individual statusFlags bits for the auth decision tree.
-     * Per OwnTone airplay.c:181-190 and 3304-3345. */
+     * Per OwnTone airplay.c. */
     session->one_time_pairing = (status_flags & ((uint64_t)1 << 9)) ? 1 : 0;
     session->pin_required     = (status_flags & ((uint64_t)1 << 3)) ? 1 : 0;
     session->password_required = (status_flags & ((uint64_t)1 << 7)) ? 1 : 0;
     LOGI("/info: one_time_pairing=%d pin_required=%d password_required=%d",
          session->one_time_pairing, session->pin_required, session->password_required);
 
-    /* Decide auth mode.  Per OwnTone airplay.c:3304-3345 and pyatv:
+    /* Decide auth mode.  Per OwnTone airplay.c and pyatv:
      * ONE_TIME_PAIRING ALWAYS means PIN mode, even when PASSWORD_REQUIRED
      * is also set.  The PIN is displayed on the receiver; the password is
      * a separate concern used for HTTP Digest auth on encrypted RTSP.
@@ -100,7 +100,7 @@ int ap2_probe_info(ap2_session_t *session) {
         session->auth_mode = AP2_AUTH_PIN;
         session->pairing_required = 1;
         session->transient_ok = 0;
-        /* PIN_REQUIRED always clears auth_key — per OwnTone airplay.c:3325-3327. */
+        /* PIN_REQUIRED always clears auth_key — per OwnTone airplay.c. */
         session->has_auth_key = 0;
     } else if (session->password_required) {
         session->auth_mode = AP2_AUTH_PASSWORD;
@@ -394,7 +394,7 @@ int ap2_pair_transient(ap2_session_t *session) {
 
 int ap2_pair_pin_start(ap2_session_t *session) {
     /* POST /pair-pin-start — triggers PIN display on receiver.
-     * Per OwnTone airplay.c:3670 — AIRPLAY_SEQ_PIN_START is a separate
+     * Per OwnTone airplay.c — AIRPLAY_SEQ_PIN_START is a separate
      * sequence from AIRPLAY_SEQ_PAIR_SETUP. */
     ap2_rtsp_response_t resp;
     if (ap2_rtsp_request(session, "POST", "/pair-pin-start",
@@ -563,7 +563,7 @@ int ap2_connect(ap2_session_t *session) {
     /* Step 2: Probe /info — sets auth_mode, pairing_required, etc. */
     if (ap2_probe_info(session) != 0) return -1;
 
-    /* Step 3: Pairing — per OwnTone airplay.c:3304-3345 decision tree. */
+    /* Step 3: Pairing — per OwnTone airplay.c decision tree. */
 
     if (session->auth_mode == AP2_AUTH_PIN) {
         /* ONE_TIME_PAIRING or PIN_REQUIRED. */
@@ -588,7 +588,7 @@ int ap2_connect(ap2_session_t *session) {
             session->has_auth_key = 0;
         }
         if (session->password[0]) {
-            /* Per OwnTone airplay.c:3304-3312 — when ONE_TIME_PAIRING is set,
+            /* Per OwnTone airplay.c — when ONE_TIME_PAIRING is set,
              * always call /pair-pin-start first to put the receiver in pairing
              * mode before SRP.  This is required even for password-protected
              * receivers: without it the Mac may process the SRP exchange but
@@ -636,7 +636,7 @@ int ap2_connect(ap2_session_t *session) {
         if (ret == 0) return 0;
 
         /* Transient→normal fallback: if receiver rejected transient with 470,
-         * switch to PIN-based auth. Per OwnTone airplay.c:3434-3443. */
+         * switch to PIN-based auth. Per OwnTone airplay.c. */
         if (session->state == AP2_STATE_PAIR) {
             LOGI("Transient rejected — receiver requires PIN");
             session->auth_mode = AP2_AUTH_PIN;

package/android/src/main/cpp/airplay2_pair.h

@@ -52,7 +52,7 @@ int ap2_pair_transient(ap2_session_t *session);
 
 /**
  * POST /pair-pin-start — trigger PIN display on receiver.
- * Per OwnTone airplay.c:3670 — separate from pair-setup.
+ * Per OwnTone airplay.c — separate from pair-setup.
  * Call this for PIN-based auth BEFORE ap2_pair_setup().
  * Do NOT call this for password-based auth (password is known, not displayed).
  *
@@ -65,7 +65,7 @@ int ap2_pair_pin_start(ap2_session_t *session);
  * Generates and stores Ed25519 identity keys.
  * The credential can be a 4-digit PIN (displayed on device) or an
  * arbitrary password string — both use the same SRP mechanism.
- * Per OwnTone pair_homekit.c:1184 — strdup(pin) as SRP password.
+ * Per OwnTone pair_homekit.c — strdup(pin) as SRP password.
  *
  * @param pin        PIN or password string
  * @param auth_key   OUT: hex-encoded auth key for persistence (192 chars + NUL)

package/android/src/main/cpp/airplay2_rtsp.c

@@ -202,7 +202,7 @@ static int recv_decrypt_frame(ap2_session_t *s, uint8_t *out, size_t out_cap) {
     return ret == 0 ? (int)frame_len : -1;
 }
 
-/* ---- HTTP Digest auth (OwnTone airplay.c:684-779) ---- */
+/* ---- HTTP Digest auth (OwnTone airplay.c) ---- */
 
 /**
  * Compute MD5 hex digest of the concatenated inputs separated by ':'.
@@ -229,7 +229,7 @@ static void md5_hex(const char *a, const char *b, const char *c, char out[33]) {
 
 /**
  * Parse WWW-Authenticate: Digest realm="...", nonce="..." from response.
- * OwnTone airplay.c:805-878.
+ * OwnTone airplay.c.
  */
 static int parse_www_authenticate(ap2_session_t *s, const char *resp_buf) {
     const char *hdr = strstr(resp_buf, "WWW-Authenticate:");
@@ -279,13 +279,13 @@ static int parse_www_authenticate(ap2_session_t *s, const char *resp_buf) {
 
 /**
  * Build Authorization: Digest ... header string.
- * OwnTone airplay.c:684-779 — HA1=MD5("":realm:password), HA2=MD5(method:uri).
+ * OwnTone airplay.c — HA1=MD5("":realm:password), HA2=MD5(method:uri).
  * Returns heap-allocated string like "Authorization: Digest ...\r\n", or NULL.
  */
 static char *build_digest_header(ap2_session_t *s, const char *method, const char *uri) {
     if (!s->has_digest_auth || !s->password[0]) return NULL;
 
-    /* HA1 = MD5(username:realm:password) — username is empty per OwnTone:687 */
+    /* HA1 = MD5(username:realm:password) — username is empty per OwnTone */
     char ha1[33];
     md5_hex("", s->realm, s->password, ha1);
 
@@ -372,7 +372,7 @@ int ap2_rtsp_request_ex(ap2_session_t *session,
     const char *dn = session->device_name[0] ? session->device_name : NULL;
 
     /* Use session URL for RTSP methods, raw path for HTTP-style endpoints.
-     * Per OwnTone airplay.c:3814 — session_url for SETUP/RECORD/etc,
+     * Per OwnTone airplay.c — session_url for SETUP/RECORD/etc,
      * raw path for /info, /pair-*, /feedback, /peer-list-changed. */
     const char *uri = path;
     if (strcmp(method, "SETUP") == 0 || strcmp(method, "RECORD") == 0 ||
@@ -382,7 +382,7 @@ int ap2_rtsp_request_ex(ap2_session_t *session,
     }
 
     /* Auto-include Digest Authorization on all requests after first 401.
-     * Per OwnTone airplay.c:908-912 — auth_header_add on every request. */
+     * Per OwnTone airplay.c — auth_header_add on every request. */
     char *digest_hdr = NULL;
     char *merged_headers = NULL;
     if (session->has_digest_auth) {
@@ -399,7 +399,7 @@ int ap2_rtsp_request_ex(ap2_session_t *session,
     }
     const char *all_extra = merged_headers ? merged_headers : "";
 
-    /* DACP-ID / Client-Instance / Active-Remote — per OwnTone airplay.c:919-926.
+    /* DACP-ID / Client-Instance / Active-Remote — per OwnTone airplay.c.
      * These let the receiver persistently identify this client. */
     char dacp_hdr[192];
     if (session->dacp_id[0]) {
@@ -562,7 +562,7 @@ int ap2_rtsp_request_ex(ap2_session_t *session,
     }
 
     /* 401 Unauthorized → parse Digest challenge and retry once.
-     * Per OwnTone airplay.c:3183-3197. Must happen before freeing resp_buf. */
+     * Per OwnTone airplay.c. Must happen before freeing resp_buf. */
     if (resp->status == 401 && session->password[0] && !session->has_digest_auth) {
         if (parse_www_authenticate(session, (char *)resp_buf) == 0) {
             LOGI("Digest auth: realm=%s — retrying %s %s",

package/android/src/main/cpp/airplay2_session.c

@@ -80,7 +80,7 @@ ap2_session_t *ap2_session_create(const char *host, int port,
     pthread_mutex_init(&s->ring_mutex, NULL);
 
     /* DACP-ID / Client-Instance — 16-char uppercase hex.
-     * Active-Remote — 32-bit decimal. Per OwnTone airplay.c:919-926. */
+     * Active-Remote — 32-bit decimal. Per OwnTone airplay.c. */
     {
         uint8_t id_bytes[8];
         randombytes_buf(id_bytes, sizeof(id_bytes));
@@ -105,7 +105,7 @@ ap2_session_t *ap2_session_create(const char *host, int port,
     /* PTP clock ID — random 64-bit identifier for timing sync. */
     s->ptp_clock_id = ((uint64_t)rand() << 32) | (uint64_t)rand();
 
-    /* Random RTSP session ID — per OwnTone airplay.c:1535.
+    /* Random RTSP session ID — per OwnTone airplay.c.
      * Used in the RTSP URL: rtsp://<host>/<session_id>. */
     s->session_id = (uint32_t)rand();
     snprintf(s->session_url, sizeof(s->session_url),

package/android/src/main/cpp/airplay_jni.cpp

@@ -174,14 +174,6 @@ static struct raopcl_s *toRaop(jlong handle) {
 // JNI methods
 // ---------------------------------------------------------------------------
 
-static jstring nativeVersion(JNIEnv *env, jclass) {
-    return env->NewStringUTF("libraop-0.2.0");
-}
-
-static jboolean nativeInitSsl(JNIEnv *, jclass) {
-    return cross_ssl_load() ? JNI_TRUE : JNI_FALSE;
-}
-
 /**
  * Open a RAOP session.  Returns a handle (pointer-as-long) or 0 on failure.
  *
@@ -356,34 +348,7 @@ static jint nativeRingAvailable(JNIEnv *, jclass, jlong handle) {
     return static_cast<jint>(avail);
 }
 
-// -- Legacy methods (still needed for pause/flush/volume/metadata) --
-
-static jboolean nativeAcceptFrames(JNIEnv *, jclass, jlong handle) {
-    auto *r = toRaop(handle);
-    return (r && raopcl_accept_frames(r)) ? JNI_TRUE : JNI_FALSE;
-}
-
-static jboolean nativeSendChunk(JNIEnv *env, jclass,
-                                jlong handle,
-                                jbyteArray data, jint offset, jint length) {
-    auto *r = toRaop(handle);
-    if (!r) return JNI_FALSE;
-
-    jbyte *buf = env->GetByteArrayElements(data, nullptr);
-    if (!buf) return JNI_FALSE;
-
-    uint64_t playtime = 0;
-    // Fix: length is bytes, send_chunk expects frames (bytes / 4 for stereo S16)
-    bool ok = raopcl_send_chunk(
-        r,
-        reinterpret_cast<uint8_t *>(buf + offset),
-        static_cast<int>(length / 4),
-        &playtime
-    );
-
-    env->ReleaseByteArrayElements(data, buf, JNI_ABORT);
-    return ok ? JNI_TRUE : JNI_FALSE;
-}
+// -- Transport control --
 
 static void nativePause(JNIEnv *, jclass, jlong handle) {
     auto *r = toRaop(handle);
@@ -409,6 +374,8 @@ static jboolean nativeFlush(JNIEnv *, jclass, jlong handle) {
     return (r && raopcl_flush(r)) ? JNI_TRUE : JNI_FALSE;
 }
 
+// -- Volume & progress --
+
 static jboolean nativeSetVolume(JNIEnv *, jclass, jlong handle, jfloat vol) {
     auto *r = toRaop(handle);
     return (r && raopcl_set_volume(r, vol)) ? JNI_TRUE : JNI_FALSE;
@@ -422,41 +389,20 @@ static jboolean nativeSetProgressMs(JNIEnv *, jclass, jlong handle,
         static_cast<uint32_t>(duration))) ? JNI_TRUE : JNI_FALSE;
 }
 
-static jlong nativeGetProgressMs(JNIEnv *, jclass, jlong handle) {
-    auto *r = toRaop(handle);
-    return r ? static_cast<jlong>(raopcl_get_progress_ms(r)) : 0;
-}
+// -- State queries --
 
 static jboolean nativeIsConnected(JNIEnv *, jclass, jlong handle) {
     auto *r = toRaop(handle);
     return (r && raopcl_is_connected(r)) ? JNI_TRUE : JNI_FALSE;
 }
 
-static jboolean nativeIsPlaying(JNIEnv *, jclass, jlong handle) {
-    auto *r = toRaop(handle);
-    return (r && raopcl_is_playing(r)) ? JNI_TRUE : JNI_FALSE;
-}
-
-static jint nativeGetState(JNIEnv *, jclass, jlong handle) {
-    auto *r = toRaop(handle);
-    return r ? static_cast<jint>(raopcl_state(r)) : 0;
-}
-
-static jint nativeGetLatency(JNIEnv *, jclass, jlong handle) {
-    auto *r = toRaop(handle);
-    return r ? static_cast<jint>(raopcl_latency(r)) : 0;
-}
-
-static jint nativeGetSampleRate(JNIEnv *, jclass, jlong handle) {
-    auto *r = toRaop(handle);
-    return r ? static_cast<jint>(raopcl_sample_rate(r)) : 0;
-}
-
 static jboolean nativeKeepalive(JNIEnv *, jclass, jlong handle) {
     auto *r = toRaop(handle);
     return (r && raopcl_keepalive(r)) ? JNI_TRUE : JNI_FALSE;
 }
 
+// -- Configuration --
+
 static jint nativeGetLastRtspStatus(JNIEnv *, jclass, jlong handle) {
     auto *r = toRaop(handle);
     return r ? static_cast<jint>(raopcl_last_rtsp_status(r)) : 0;
@@ -484,6 +430,8 @@ static void nativeSetPassword(JNIEnv *env, jclass, jlong handle, jstring jPasswd
     }
 }
 
+// -- Metadata --
+
 static jboolean nativeSetDaap(JNIEnv *env, jclass, jlong handle,
                               jstring jTitle, jstring jArtist, jstring jAlbum) {
     auto *r = toRaop(handle);
@@ -533,8 +481,6 @@ static jboolean nativeSetArtwork(JNIEnv *env, jclass, jlong handle,
 // RegisterNatives table
 // ---------------------------------------------------------------------------
 static const JNINativeMethod sMethods[] = {
-    {"nativeVersion",       "()Ljava/lang/String;",                 reinterpret_cast<void *>(nativeVersion)},
-    {"nativeInitSsl",       "()Z",                                  reinterpret_cast<void *>(nativeInitSsl)},
     {"nativeOpen",          "(Ljava/lang/String;IIIIIZIIIF)J",      reinterpret_cast<void *>(nativeOpen)},
     {"nativeConnect",       "(JLjava/lang/String;I)Z",              reinterpret_cast<void *>(nativeConnect)},
     {"nativeDisconnect",    "(J)Z",                                 reinterpret_cast<void *>(nativeDisconnect)},
@@ -542,19 +488,12 @@ static const JNINativeMethod sMethods[] = {
     {"nativeFeedPcm",       "(J[BII)I",                             reinterpret_cast<void *>(nativeFeedPcm)},
     {"nativeBytesSent",     "(J)J",                                 reinterpret_cast<void *>(nativeBytesSent)},
     {"nativeRingAvailable", "(J)I",                                 reinterpret_cast<void *>(nativeRingAvailable)},
-    {"nativeAcceptFrames",  "(J)Z",                                 reinterpret_cast<void *>(nativeAcceptFrames)},
-    {"nativeSendChunk",     "(J[BII)Z",                             reinterpret_cast<void *>(nativeSendChunk)},
     {"nativePause",         "(J)V",                                 reinterpret_cast<void *>(nativePause)},
     {"nativeStop",          "(J)V",                                 reinterpret_cast<void *>(nativeStop)},
     {"nativeFlush",         "(J)Z",                                 reinterpret_cast<void *>(nativeFlush)},
     {"nativeSetVolume",     "(JF)Z",                                reinterpret_cast<void *>(nativeSetVolume)},
     {"nativeSetProgressMs", "(JII)Z",                               reinterpret_cast<void *>(nativeSetProgressMs)},
-    {"nativeGetProgressMs", "(J)J",                                 reinterpret_cast<void *>(nativeGetProgressMs)},
     {"nativeIsConnected",   "(J)Z",                                 reinterpret_cast<void *>(nativeIsConnected)},
-    {"nativeIsPlaying",     "(J)Z",                                 reinterpret_cast<void *>(nativeIsPlaying)},
-    {"nativeGetState",      "(J)I",                                 reinterpret_cast<void *>(nativeGetState)},
-    {"nativeGetLatency",    "(J)I",                                 reinterpret_cast<void *>(nativeGetLatency)},
-    {"nativeGetSampleRate", "(J)I",                                 reinterpret_cast<void *>(nativeGetSampleRate)},
     {"nativeKeepalive",     "(J)Z",                                 reinterpret_cast<void *>(nativeKeepalive)},
     {"nativeGetLastRtspStatus", "(J)I",                              reinterpret_cast<void *>(nativeGetLastRtspStatus)},
     {"nativeSetPassword",   "(JLjava/lang/String;)V",               reinterpret_cast<void *>(nativeSetPassword)},

package/android/src/main/java/com/margelo/nitro/queueplayer/AirPlayEngine.kt

@@ -66,10 +66,11 @@ internal class AirPlayEngine(
 
   private val playerListener = object : Player.Listener {
     override fun onPlaybackStateChanged(playbackState: Int) {
-      delegate?.onStateMaybeChanged(this@AirPlayEngine, playWhenReadyReason = null)
+      // End signal before the generic state callback, as in GaplessEngine.
       if (playbackState == Player.STATE_ENDED) {
         delegate?.onPlaybackEnded(this@AirPlayEngine)
       }
+      delegate?.onStateMaybeChanged(this@AirPlayEngine, playWhenReadyReason = null)
     }
 
     override fun onPlayWhenReadyChanged(playWhenReady: Boolean, reason: Int) {
@@ -129,15 +130,6 @@ internal class AirPlayEngine(
 
   // --- PlaybackEngine — lifecycle ---
 
-  override suspend fun prepare(
-    mediaItems: List<MediaItem>,
-    startIndex: Int,
-    startPositionMs: Long,
-  ) {
-    exoPlayer.setMediaItems(mediaItems, startIndex, startPositionMs)
-    exoPlayer.prepare()
-  }
-
   override fun release() {
     if (released) return
     released = true
@@ -168,6 +160,11 @@ internal class AirPlayEngine(
     startIndex: Int,
     startPositionMs: Long,
   ) {
+    if (items.isEmpty()) {
+      // Draining is not pausing: `playWhenReady` survives an empty playlist,
+      // so the next queue seated on this player would start on contact.
+      exoPlayer.pause()
+    }
     exoPlayer.setMediaItems(items, startIndex, startPositionMs)
     // ExoPlayer is IDLE after construction; prepare() is required before any
     // subsequent play() can take effect (mirrors GaplessEngine).
@@ -272,12 +269,6 @@ internal class AirPlayEngine(
 
   // ReplayGain absent on the AirPlay engine — interface defaults
   // (currentReplayGainData() = null, currentReplayGainActive() = false) apply.
-
-  // --- PlaybackEngine — handoff ---
-
-  override suspend fun handoff(to: PlaybackEngine, atTrackBoundary: Boolean) {
-    throw NotImplementedError("PlaybackEngine.handoff is not supported by AirPlayEngine")
-  }
 }
 
 /**

package/android/src/main/java/com/margelo/nitro/queueplayer/CacheMimeTypes.kt

@@ -3,7 +3,7 @@ package com.margelo.nitro.queueplayer
 import java.net.URI
 
 /**
- * MIME-type plumbing for the lookahead cache. Mirrors iOS's
+ * MIME-type handling for the lookahead cache. Mirrors iOS's
  * `LookaheadCache.extensionFromMimeType` / `extensionFromUrl` —
  * lets the Android cache record the same Content-Type signal so
  * Media3 can be told the format up front via

package/android/src/main/java/com/margelo/nitro/queueplayer/CastManager.kt

@@ -526,12 +526,8 @@ class CastManager : HybridCastManagerSpec() {
     }
     airplayScope.launch {
       try {
-        val session = backend.submitPairingPin(pin)
-        val pendingId = activeAirplaySession.get()?.let { /* keep existing */ null }
-        val receiverId = pendingId ?: lastConnectedAirplayReceiverId() ?: ""
-        if (receiverId.isNotEmpty()) {
-          installAirplaySession(session, receiverId)
-        }
+        val paired = backend.submitPairingPin(pin)
+        installAirplaySession(paired.session, paired.receiverId)
         promise.resolve(Unit)
       } catch (t: Throwable) {
         promise.reject(t)
@@ -540,14 +536,6 @@ class CastManager : HybridCastManagerSpec() {
     return promise
   }
 
-  /// Look up the most recently visible AirPlay receiver that pair-setup
-  /// would have stashed against. The pending pair's receiverId isn't
-  /// directly accessible from the public backend surface; lookup via
-  /// the discovered snapshot is good enough — the user pairs the device
-  /// they just saw in the picker.
-  private fun lastConnectedAirplayReceiverId(): String? =
-    airplayReceivers.firstOrNull()?.id
-
   override fun getLocalNetworkPermissionState(): CastLocalNetworkPermission =
     localNetworkPermissionState()