@parastud/react-native-vban 0.1.1 → 0.2.0

package/android/src/main/AndroidManifest.xml

@@ -1,12 +1,20 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
+  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
   <!-- Required (API 34+) to run a mediaProjection foreground service; ignored on older versions. -->
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
+  <!-- Keep-alive service types for background receive (playback) and mic-send. -->
+  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
+  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />
 
   <application>
     <service
       android:name=".SystemAudioCaptureService"
       android:exported="false"
       android:foregroundServiceType="mediaProjection" />
+    <service
+      android:name=".VbanForegroundService"
+      android:exported="false"
+      android:foregroundServiceType="mediaPlayback|microphone" />
   </application>
 </manifest>

package/android/src/main/java/expo/modules/systemaudiocapture/VbanForegroundService.kt

@@ -0,0 +1,122 @@
+package expo.modules.systemaudiocapture
+
+import android.app.Notification
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.app.Service
+import android.content.Context
+import android.content.Intent
+import android.content.pm.ServiceInfo
+import android.os.Build
+import android.os.IBinder
+
+/**
+ * Keep-alive foreground service for the native receive + mic-send paths.
+ *
+ * Those paths run their audio loop on an in-process [Thread] (see
+ * [VbanReceiverModule] / [VbanSenderModule.startMic]). Without a foreground
+ * service Android freezes the process shortly after it's backgrounded, which
+ * stalls the audio. This service doesn't own the audio — it only holds an
+ * ongoing notification so the process stays unfrozen and keeps network access
+ * while receiving and/or mic-sending is active.
+ *
+ * State lives in static flags set by the modules; call [refresh] after changing
+ * one. The service raises the correct foreground-service type(s) and stops
+ * itself once nothing is active.
+ *
+ * (Device-audio send has its own [SystemAudioCaptureService] and does not use
+ * this one.)
+ */
+class VbanForegroundService : Service() {
+  companion object {
+    private const val ACTION_UPDATE = "expo.modules.systemaudiocapture.KEEPALIVE_UPDATE"
+    private const val CHANNEL_ID = "vban_keepalive"
+    private const val NOTIF_ID = 8124
+
+    /** True while the native receiver is running. */
+    @Volatile var receiving = false
+
+    /** True while native mic-send is running. */
+    @Volatile var sending = false
+
+    /**
+     * Reconcile the running service with the current [receiving]/[sending]
+     * flags: start/raise the foreground notification if anything is active,
+     * or tear it down if nothing is. Safe to call repeatedly.
+     */
+    fun refresh(context: Context) {
+      val intent = Intent(context, VbanForegroundService::class.java).apply {
+        action = ACTION_UPDATE
+      }
+      if (receiving || sending) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+          context.startForegroundService(intent)
+        } else {
+          context.startService(intent)
+        }
+      } else {
+        // Plain start (no startForeground obligation) — the service will
+        // observe the cleared flags and stop itself.
+        context.startService(intent)
+      }
+    }
+  }
+
+  override fun onBind(intent: Intent?): IBinder? = null
+
+  override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+    if (!receiving && !sending) {
+      stopForegroundCompat()
+      stopSelf()
+      return START_NOT_STICKY
+    }
+    startForegroundNotification()
+    // If the system kills us under pressure, don't restart with stale state —
+    // the audio threads would be gone with the process anyway.
+    return START_NOT_STICKY
+  }
+
+  private fun startForegroundNotification() {
+    val nm = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+      nm.createNotificationChannel(
+        NotificationChannel(CHANNEL_ID, "VBAN audio", NotificationManager.IMPORTANCE_LOW)
+      )
+    }
+
+    val text = when {
+      receiving && sending -> "Receiving and sending audio over the network"
+      receiving -> "Receiving audio over the network"
+      else -> "Sending microphone audio over the network"
+    }
+    val notification: Notification = Notification.Builder(this, CHANNEL_ID)
+      .setContentTitle("VBAN")
+      .setContentText(text)
+      .setSmallIcon(android.R.drawable.ic_lock_silent_mode_off)
+      .setOngoing(true)
+      .build()
+
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+      var type = 0
+      if (receiving) type = type or ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
+      if (sending) type = type or ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE
+      startForeground(NOTIF_ID, notification, type)
+    } else {
+      startForeground(NOTIF_ID, notification)
+    }
+  }
+
+  @Suppress("DEPRECATION")
+  private fun stopForegroundCompat() {
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+      stopForeground(STOP_FOREGROUND_REMOVE)
+    } else {
+      stopForeground(true)
+    }
+  }
+
+  override fun onDestroy() {
+    stopForegroundCompat()
+    super.onDestroy()
+  }
+}

package/android/src/main/java/expo/modules/systemaudiocapture/VbanReceiverModule.kt

@@ -1,9 +1,11 @@
 package expo.modules.systemaudiocapture
 
+import android.content.Context
 import android.media.AudioAttributes
 import android.media.AudioFormat
 import android.media.AudioTrack
 import expo.modules.kotlin.Promise
+import expo.modules.kotlin.exception.Exceptions
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 import java.net.DatagramPacket
@@ -24,6 +26,9 @@ class VbanReceiverModule : Module() {
   private var thread: Thread? = null
   private var socket: DatagramSocket? = null
 
+  private val context: Context
+    get() = appContext.reactContext ?: throw Exceptions.ReactContextLost()
+
   companion object {
     private val SR = intArrayOf(
       6000, 12000, 24000, 48000, 96000, 192000, 384000,
@@ -204,6 +209,10 @@ class VbanReceiverModule : Module() {
         track?.let { try { it.stop(); it.release() } catch (_: Exception) {} }
       }
     }.also { it.start() }
+
+    // Keep the process alive in the background while receiving.
+    VbanForegroundService.receiving = true
+    try { VbanForegroundService.refresh(context) } catch (_: Exception) {}
   }
 
   private fun stopReceive() {
@@ -212,5 +221,8 @@ class VbanReceiverModule : Module() {
     socket = null
     try { thread?.join(500) } catch (_: Exception) {}
     thread = null
+
+    VbanForegroundService.receiving = false
+    try { VbanForegroundService.refresh(context) } catch (_: Exception) {}
   }
 }

package/android/src/main/java/expo/modules/systemaudiocapture/VbanSenderModule.kt

@@ -73,6 +73,10 @@ class VbanSenderModule : Module() {
     AsyncFunction("stop") { promise: Promise ->
       engine?.stop()
       engine = null
+      if (VbanForegroundService.sending) {
+        VbanForegroundService.sending = false
+        try { VbanForegroundService.refresh(context) } catch (_: Exception) {}
+      }
       if (deviceActive) {
         deviceActive = false
         SystemAudioCaptureService.onStats = null
@@ -88,6 +92,10 @@ class VbanSenderModule : Module() {
     OnDestroy {
       engine?.stop()
       engine = null
+      if (VbanForegroundService.sending) {
+        VbanForegroundService.sending = false
+        try { VbanForegroundService.refresh(context) } catch (_: Exception) {}
+      }
     }
   }
 
@@ -103,6 +111,10 @@ class VbanSenderModule : Module() {
       onError = { msg -> sendEvent("onError", mapOf("message" to msg)) },
     )
     engine!!.start()
+
+    // Keep the process alive in the background while mic-sending.
+    VbanForegroundService.sending = true
+    try { VbanForegroundService.refresh(context) } catch (_: Exception) {}
   }
 
   /** Build an AudioRecord for the mic, falling back to mono if stereo isn't supported. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parastud/react-native-vban",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "VBAN (VB-Audio Network) audio-over-IP for React Native / Expo — native UDP send & receive, Android system-audio capture via MediaProjection, and a pure-TypeScript VBAN codec. Interoperates with Voicemeeter and other VBAN endpoints.",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -20,7 +20,8 @@
   ],
   "files": [
     "src",
-    "android",
+    "android/src",
+    "android/build.gradle",
     "expo-module.config.json",
     "README.md"
   ],
@@ -30,6 +31,8 @@
     "react-native": "*"
   },
   "expo": {
-    "platforms": ["android"]
+    "platforms": [
+      "android"
+    ]
   }
 }

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +0,0 @@
-#Thu Jul 02 16:24:57 IST 2026
-gradle.version=8.9