@stream-io/video-react-native-sdk 1.30.5 → 1.31.1-beta.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [1.31.0](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-react-native-sdk-1.30.5...@stream-io/video-react-native-sdk-1.31.0) (2026-03-31)
+
+### Dependency Updates
+
+- `@stream-io/noise-cancellation-react-native` updated to version `0.6.0`
+- `@stream-io/video-filters-react-native` updated to version `0.11.0`
+
+### Features
+
+- screen share audio ([#2157](https://github.com/GetStream/stream-video-js/issues/2157)) ([ba3b9d8](https://github.com/GetStream/stream-video-js/commit/ba3b9d8c2168d7c1cd66050524a5dc0a0f7e3e6e))
+
 ## [1.30.5](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-react-native-sdk-1.30.4...@stream-io/video-react-native-sdk-1.30.5) (2026-03-27)
 
 ### Dependency Updates

package/android/src/main/AndroidManifest.xml

@@ -2,6 +2,13 @@
         package="com.streamvideo.reactnative">
 
     <uses-permission android:name="android.permission.INTERNET" />
-    <uses-permission android:name="android.permission.DEVICE_POWER" />
     <uses-permission android:name="android.permission.WAKE_LOCK" />
+
+    <application>
+        <service
+            android:name="com.streamvideo.reactnative.keepalive.StreamCallKeepAliveHeadlessService"
+            android:exported="false"
+            android:stopWithTask="true"
+            android:foregroundServiceType="mediaPlayback|camera|microphone" />
+    </application>
 </manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -1,2 +1,13 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
+
+    <application>
+        <service
+            android:name="com.streamvideo.reactnative.keepalive.StreamCallKeepAliveHeadlessService"
+            android:exported="false"
+            android:stopWithTask="true"
+            android:foregroundServiceType="mediaPlayback|camera|microphone" />
+    </application>
 </manifest>

package/android/src/main/java/com/streamvideo/reactnative/StreamVideoReactNativeModule.kt

@@ -1,5 +1,6 @@
 package com.streamvideo.reactnative
 
+import android.app.Activity
 import android.content.BroadcastReceiver
 import android.content.Context
 import android.content.Intent
@@ -9,12 +10,14 @@ import android.graphics.Bitmap
 import android.media.AudioAttributes
 import android.media.AudioFormat
 import android.media.AudioTrack
+import android.media.projection.MediaProjectionManager
 import android.net.Uri
 import android.os.BatteryManager
 import android.os.Build
 import android.os.PowerManager
 import android.util.Base64
 import android.util.Log
+import androidx.core.content.ContextCompat
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
@@ -23,8 +26,10 @@ import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.DeviceEventManagerModule.RCTDeviceEventEmitter
 import com.oney.WebRTCModule.WebRTCModule
+import com.oney.WebRTCModule.WebRTCModuleOptions
+import com.streamvideo.reactnative.screenshare.ScreenAudioCapture
+import com.streamvideo.reactnative.keepalive.StreamCallKeepAliveHeadlessService
 import com.streamvideo.reactnative.util.CallAlivePermissionsHelper
-import com.streamvideo.reactnative.util.CallAliveServiceChecker
 import com.streamvideo.reactnative.util.PiPHelper
 import com.streamvideo.reactnative.util.RingtoneUtil
 import com.streamvideo.reactnative.util.YuvFrame
@@ -52,6 +57,9 @@ class StreamVideoReactNativeModule(reactContext: ReactApplicationContext) :
     private var busyToneAudioTrack: AudioTrack? = null
     private var busyToneJob: Job? = null
 
+    // Screen share audio mixing
+    private var screenAudioCapture: ScreenAudioCapture? = null
+
     private var thermalStatusListener: PowerManager.OnThermalStatusChangedListener? = null
 
     private var batteryChargingStateReceiver = object : BroadcastReceiver() {
@@ -115,11 +123,47 @@ class StreamVideoReactNativeModule(reactContext: ReactApplicationContext) :
             promise.resolve(false)
             return
         }
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
-            val isForegroundServiceDeclared = CallAliveServiceChecker.isForegroundServiceDeclared(reactApplicationContext)
-            promise.resolve(isForegroundServiceDeclared)
-        } else {
+        // Service is declared in the SDK's own AndroidManifest and merged by default.
+        // Permissions are expected to be provided by the app (or via Expo config plugin).
+        promise.resolve(true)
+    }
+
+
+    @ReactMethod
+    fun startKeepCallAliveService(
+        callCid: String,
+        channelId: String,
+        channelName: String,
+        title: String,
+        body: String,
+        smallIconName: String?,
+        promise: Promise
+    ) {
+        try {
+            val intent = StreamCallKeepAliveHeadlessService.buildStartIntent(
+                reactApplicationContext,
+                callCid,
+                channelId,
+                channelName,
+                title,
+                body,
+                smallIconName
+            )
+            ContextCompat.startForegroundService(reactApplicationContext, intent)
             promise.resolve(true)
+        } catch (e: Exception) {
+            promise.reject(NAME, "Failed to start keep call alive foreground service", e)
+        }
+    }
+
+    @ReactMethod
+    fun stopKeepCallAliveService(promise: Promise) {
+        try {
+            val intent = StreamCallKeepAliveHeadlessService.buildStopIntent(reactApplicationContext)
+            val stopped = reactApplicationContext.stopService(intent)
+            promise.resolve(stopped)
+        } catch (e: Exception) {
+            promise.reject(NAME, "Failed to stop keep call alive foreground service", e)
         }
     }
 
@@ -148,6 +192,7 @@ class StreamVideoReactNativeModule(reactContext: ReactApplicationContext) :
         reactApplicationContext.unregisterReceiver(batteryChargingStateReceiver)
         stopThermalStatusUpdates()
         stopBusyToneInternal() // Clean up busy tone on invalidate
+        stopScreenShareAudioMixingInternal() // Clean up screen share audio on invalidate
         super.invalidate()
     }
 
@@ -484,6 +529,83 @@ class StreamVideoReactNativeModule(reactContext: ReactApplicationContext) :
         return ShortArray(totalSamples)
     }
 
+    @ReactMethod
+    fun startScreenShareAudioMixing(promise: Promise) {
+        try {
+            if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
+                promise.reject("API_LEVEL", "Screen audio capture requires Android 10 (API 29)+")
+                return
+            }
+
+            if (screenAudioCapture != null) {
+                Log.w(NAME, "Screen share audio mixing is already active")
+                promise.resolve(null)
+                return
+            }
+
+            val module = reactApplicationContext.getNativeModule(WebRTCModule::class.java)!!
+
+            // Get the MediaProjection permission result Intent from WebRTC
+            val permissionIntent = module.userMediaImpl?.mediaProjectionPermissionResultData
+            if (permissionIntent == null) {
+                promise.reject("NO_PROJECTION", "No MediaProjection permission available. Start screen sharing first.")
+                return
+            }
+
+            // Create a MediaProjection for audio capture
+            val mediaProjectionManager = reactApplicationContext.getSystemService(
+                Context.MEDIA_PROJECTION_SERVICE
+            ) as MediaProjectionManager
+            val mediaProjection = mediaProjectionManager.getMediaProjection(
+                Activity.RESULT_OK, permissionIntent
+            )
+            if (mediaProjection == null) {
+                promise.reject("PROJECTION_ERROR", "Failed to create MediaProjection for audio capture")
+                return
+            }
+
+            screenAudioCapture = ScreenAudioCapture(mediaProjection).also { it.start() }
+
+            // Register the screen audio bytes provider so the AudioBufferCallback
+            // in WebRTCModule mixes screen audio into the mic buffer.
+            WebRTCModuleOptions.getInstance().screenAudioBytesProvider =
+                WebRTCModuleOptions.ScreenAudioBytesProvider { bytesRequested ->
+                screenAudioCapture?.getScreenAudioBytes(bytesRequested)
+            }
+
+            Log.d(NAME, "Screen share audio mixing started")
+            promise.resolve(null)
+        } catch (e: Exception) {
+            Log.e(NAME, "Error starting screen share audio mixing: ${e.message}")
+            promise.reject("ERROR", e.message, e)
+        }
+    }
+
+    @ReactMethod
+    fun stopScreenShareAudioMixing(promise: Promise) {
+        try {
+            stopScreenShareAudioMixingInternal()
+            promise.resolve(null)
+        } catch (e: Exception) {
+            Log.e(NAME, "Error stopping screen share audio mixing: ${e.message}")
+            promise.reject("ERROR", e.message, e)
+        }
+    }
+
+    private fun stopScreenShareAudioMixingInternal() {
+        try {
+            // Clear the provider so the AudioBufferCallback stops mixing
+            WebRTCModuleOptions.getInstance().screenAudioBytesProvider = null
+
+            screenAudioCapture?.stop()
+            screenAudioCapture = null
+
+            Log.d(NAME, "Screen share audio mixing stopped")
+        } catch (e: Exception) {
+            Log.e(NAME, "Error in stopScreenShareAudioMixingInternal: ${e.message}")
+        }
+    }
+
     companion object {
         private const val NAME = "StreamVideoReactNative"
         private const val SAMPLE_RATE = 22050

package/android/src/main/java/com/streamvideo/reactnative/audio/utils/WebRtcAudioUtils.kt

@@ -55,14 +55,78 @@ object WebRtcAudioUtils {
      * what might be the root cause.
      */
     fun logAudioState(tag: String, reactContext: ReactContext) {
+        Log.d(tag, getAudioStateLog(reactContext))
+    }
+
+    /**
+     * Returns a string containing information about the current audio state.
+     * Similar to logAudioState but returns the information instead of logging it.
+     */
+    fun getAudioStateLog(reactContext: ReactContext): String {
+        val audioManager = reactContext.getSystemService(Context.AUDIO_SERVICE) as AudioManager
+        val sb = StringBuilder()
+
+        // Volume control stream
         reactContext.currentActivity?.let {
-            Log.d(tag, "volumeControlStream: " + streamTypeToString(it.volumeControlStream))
+            sb.appendLine("volumeControlStream: ${streamTypeToString(it.volumeControlStream)}")
         }
-        val audioManager = reactContext.getSystemService(Context.AUDIO_SERVICE) as AudioManager
-        logDeviceInfo(tag)
-        logAudioStateBasic(tag, reactContext, audioManager)
-        logAudioStateVolume(tag, audioManager)
-        logAudioDeviceInfo(tag, audioManager)
+
+        // Device info
+        sb.appendLine("Android SDK: ${Build.VERSION.SDK_INT}, Release: ${Build.VERSION.RELEASE}, Brand: ${Build.BRAND}, Device: ${Build.DEVICE}, Id: ${Build.ID}, Hardware: ${Build.HARDWARE}, Manufacturer: ${Build.MANUFACTURER}, Model: ${Build.MODEL}, Product: ${Build.PRODUCT}")
+
+        // Basic audio state
+        sb.appendLine("Audio State: audio mode: ${modeToString(audioManager.mode)}, has mic: ${hasMicrophone(reactContext)}, mic muted: ${audioManager.isMicrophoneMute}, music active: ${audioManager.isMusicActive}, speakerphone: ${audioManager.isSpeakerphoneOn}, BT SCO: ${audioManager.isBluetoothScoOn}")
+
+        // Volume info
+        val fixedVolume = audioManager.isVolumeFixed
+        sb.appendLine("  fixed volume=$fixedVolume")
+        if (!fixedVolume) {
+            val streams = intArrayOf(
+                AudioManager.STREAM_VOICE_CALL,
+                AudioManager.STREAM_MUSIC,
+                AudioManager.STREAM_RING,
+                AudioManager.STREAM_ALARM,
+                AudioManager.STREAM_NOTIFICATION,
+                AudioManager.STREAM_SYSTEM
+            )
+            for (stream in streams) {
+                val info = StringBuilder()
+                info.append("  ${streamTypeToString(stream)}: ")
+                info.append("volume=${audioManager.getStreamVolume(stream)}")
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+                    info.append(", min=${audioManager.getStreamMinVolume(stream)}")
+                }
+                info.append(", max=${audioManager.getStreamMaxVolume(stream)}")
+                info.append(", muted=${audioManager.isStreamMute(stream)}")
+                sb.appendLine(info.toString())
+            }
+        }
+
+        // Audio devices
+        val inputDevices = audioManager.getDevices(AudioManager.GET_DEVICES_INPUTS)
+        val outputDevices = audioManager.getDevices(AudioManager.GET_DEVICES_OUTPUTS)
+        val devices = inputDevices + outputDevices
+        if (devices.isNotEmpty()) {
+            sb.appendLine("Audio Devices:")
+            for (device in devices) {
+                val info = StringBuilder()
+                info.append("  ${deviceTypeToString(device.type)}")
+                info.append(if (device.isSource) "(in): " else "(out): ")
+                if (device.channelCounts.isNotEmpty()) {
+                    info.append("channels=${device.channelCounts.contentToString()}, ")
+                }
+                if (device.encodings.isNotEmpty()) {
+                    info.append("encodings=${device.encodings.contentToString()}, ")
+                }
+                if (device.sampleRates.isNotEmpty()) {
+                    info.append("sample rates=${device.sampleRates.contentToString()}, ")
+                }
+                info.append("id=${device.id}")
+                sb.appendLine(info.toString())
+            }
+        }
+
+        return sb.toString()
     }
 
     /** Converts AudioDeviceInfo types to local string representation.  */

package/android/src/main/java/com/streamvideo/reactnative/callmanager/StreamInCallManagerModule.kt

@@ -168,10 +168,12 @@ class StreamInCallManagerModule(reactContext: ReactApplicationContext) :
 
     @ReactMethod
     fun logAudioState() {
-        WebRtcAudioUtils.logAudioState(
-            TAG,
-            reactApplicationContext,
-        )
+        Log.d(TAG, getAudioStateLog())
+    }
+
+    @ReactMethod(isBlockingSynchronousMethod = true)
+    fun getAudioStateLog(): String {
+        return WebRtcAudioUtils.getAudioStateLog(reactApplicationContext)
     }
 
     @Suppress("unused")

package/android/src/main/java/com/streamvideo/reactnative/keepalive/KeepAliveNotification.kt

@@ -0,0 +1,83 @@
+package com.streamvideo.reactnative.keepalive
+
+import android.app.Notification
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.app.PendingIntent
+import android.content.Context
+import android.content.Intent
+import android.content.pm.PackageManager
+import android.os.Build
+import androidx.core.app.NotificationCompat
+
+internal object KeepAliveNotification {
+    private const val DEFAULT_CHANNEL_DESCRIPTION = "Stream call keep-alive"
+
+    fun ensureChannel(
+        context: Context,
+        channelId: String,
+        channelName: String
+    ) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
+        val manager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
+        val existing = manager.getNotificationChannel(channelId)
+        if (existing != null) return
+
+        val channel = NotificationChannel(
+            channelId,
+            channelName,
+            NotificationManager.IMPORTANCE_LOW
+        ).apply {
+            description = DEFAULT_CHANNEL_DESCRIPTION
+            setShowBadge(false)
+        }
+        manager.createNotificationChannel(channel)
+    }
+
+    fun buildOngoingNotification(
+        context: Context,
+        channelId: String,
+        title: String,
+        body: String,
+        smallIconName: String?
+    ): Notification {
+        val launchIntent = context.packageManager.getLaunchIntentForPackage(context.packageName)
+        val pendingIntentFlags =
+            PendingIntent.FLAG_UPDATE_CURRENT or
+               PendingIntent.FLAG_IMMUTABLE
+        val contentIntent = if (launchIntent != null) {
+            PendingIntent.getActivity(context, 0, launchIntent, pendingIntentFlags)
+        } else {
+            // Fallback: empty intent to avoid crash if launch activity is missing for some reason
+            PendingIntent.getActivity(context, 0, Intent(), pendingIntentFlags)
+        }
+
+        val iconResId = resolveSmallIconResId(context, smallIconName)
+        return NotificationCompat.Builder(context, channelId)
+            .setContentTitle(title)
+            .setContentText(body)
+            .setOngoing(true)
+            .setOnlyAlertOnce(true)
+            .setCategory(NotificationCompat.CATEGORY_CALL)
+            .setContentIntent(contentIntent)
+            .setSmallIcon(iconResId)
+            .build()
+    }
+
+    private fun resolveSmallIconResId(context: Context, smallIconName: String?): Int {
+        val resources = context.resources
+        val packageName = context.packageName
+        if (!smallIconName.isNullOrBlank()) {
+            val id = resources.getIdentifier(smallIconName, "drawable", packageName)
+            if (id != 0) return id
+        }
+        // Default to the app icon
+        return try {
+            val appInfo = context.packageManager.getApplicationInfo(packageName, 0)
+            appInfo.icon
+        } catch (_: PackageManager.NameNotFoundException) {
+            android.R.drawable.ic_dialog_info
+        }
+    }
+}
+

package/android/src/main/java/com/streamvideo/reactnative/keepalive/StreamCallKeepAliveHeadlessService.kt

@@ -0,0 +1,149 @@
+package com.streamvideo.reactnative.keepalive
+
+import android.Manifest
+import android.content.Intent
+import android.content.pm.PackageManager
+import android.content.pm.ServiceInfo
+import android.os.Build
+import android.util.Log
+import androidx.annotation.RequiresApi
+import androidx.core.app.ServiceCompat
+import androidx.core.content.ContextCompat
+import com.facebook.react.HeadlessJsTaskService
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.jstasks.HeadlessJsTaskConfig
+
+/**
+ * Foreground service that runs a React Native HeadlessJS task to keep a call alive.
+ *
+ */
+class StreamCallKeepAliveHeadlessService : HeadlessJsTaskService() {
+
+    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+        val safeIntent = intent ?: Intent()
+        val channelId = safeIntent.getStringExtra(EXTRA_CHANNEL_ID) ?: DEFAULT_CHANNEL_ID
+        val channelName = safeIntent.getStringExtra(EXTRA_CHANNEL_NAME) ?: DEFAULT_CHANNEL_NAME
+        val title = safeIntent.getStringExtra(EXTRA_TITLE) ?: DEFAULT_TITLE
+        val body = safeIntent.getStringExtra(EXTRA_BODY) ?: DEFAULT_BODY
+        val smallIconName = safeIntent.getStringExtra(EXTRA_SMALL_ICON_NAME)
+
+        KeepAliveNotification.ensureChannel(this, channelId, channelName)
+        val notification = KeepAliveNotification.buildOngoingNotification(
+            context = this,
+            channelId = channelId,
+            title = title,
+            body = body,
+            smallIconName = smallIconName
+        )
+
+        startForegroundCompat(notification)
+
+        // Ensure HeadlessJS task is started
+        return super.onStartCommand(safeIntent, flags, startId)
+    }
+
+    override fun getTaskConfig(intent: Intent?): HeadlessJsTaskConfig? {
+        val callCid = intent?.getStringExtra(EXTRA_CALL_CID) ?: return null
+        val data = Arguments.createMap().apply {
+            putString("callCid", callCid)
+        }
+        // We intentionally allow long-running work (the JS task can return a never-resolving Promise).
+        return HeadlessJsTaskConfig(
+            TASK_NAME,
+            data,
+            0, // timeout (0 = no timeout)
+            true // allowedInForeground
+        )
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        stopForeground(STOP_FOREGROUND_REMOVE)
+    }
+
+    @RequiresApi(Build.VERSION_CODES.R)
+    private fun computeForegroundServiceTypes(): Int {
+        var types = ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
+
+        val hasCameraPermission =
+            ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) == PackageManager.PERMISSION_GRANTED
+        if (hasCameraPermission) {
+            types = types or ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA
+        }
+
+        val hasMicrophonePermission =
+            ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO) == PackageManager.PERMISSION_GRANTED
+        if (hasMicrophonePermission) {
+            types = types or ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE
+        }
+
+        return types
+    }
+
+    private fun startForegroundCompat(notification: android.app.Notification) {
+        try {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                val types =
+                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) computeForegroundServiceTypes()
+                    else ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
+                startForeground(NOTIFICATION_ID, notification, types)
+            } else {
+                startForeground(NOTIFICATION_ID, notification)
+            }
+        } catch (e: Exception) {
+            // Avoid crashing the app if the system rejects starting a foreground service (e.g.
+            // background start restrictions, invalid notification/channel, or permission issues).
+            Log.e(
+                TAG,
+                "startForegroundCompat: Failed to start foreground service: ${e.message}",
+                e
+            )
+        }
+    }
+
+    companion object {
+        private const val TAG = "StreamCallKeepAliveHeadlessService"
+
+        const val TASK_NAME = "StreamVideoKeepCallAlive"
+
+        const val EXTRA_CALL_CID = "callCid"
+        const val EXTRA_CHANNEL_ID = "channelId"
+        const val EXTRA_CHANNEL_NAME = "channelName"
+        const val EXTRA_TITLE = "title"
+        const val EXTRA_BODY = "body"
+        const val EXTRA_SMALL_ICON_NAME = "smallIconName"
+
+        private const val NOTIFICATION_ID = 6061
+
+        private const val DEFAULT_CHANNEL_ID = "stream_call_foreground_service"
+        private const val DEFAULT_CHANNEL_NAME = "Call in progress"
+        private const val DEFAULT_TITLE = "Call in progress"
+        private const val DEFAULT_BODY = "Tap to return to the call"
+
+        fun buildStartIntent(
+            context: android.content.Context,
+            callCid: String,
+            channelId: String,
+            channelName: String,
+            title: String,
+            body: String,
+            smallIconName: String?
+        ): Intent {
+            return Intent(context, StreamCallKeepAliveHeadlessService::class.java).apply {
+                putExtra(EXTRA_CALL_CID, callCid)
+                putExtra(EXTRA_CHANNEL_ID, channelId)
+                putExtra(EXTRA_CHANNEL_NAME, channelName)
+                putExtra(EXTRA_TITLE, title)
+                putExtra(EXTRA_BODY, body)
+                if (!smallIconName.isNullOrBlank()) {
+                    putExtra(EXTRA_SMALL_ICON_NAME, smallIconName)
+                }
+            }
+        }
+
+        fun buildStopIntent(context: android.content.Context): Intent {
+            return Intent(context, StreamCallKeepAliveHeadlessService::class.java)
+        }
+    }
+}
+

package/android/src/main/java/com/streamvideo/reactnative/screenshare/ScreenAudioCapture.kt

@@ -0,0 +1,111 @@
+package com.streamvideo.reactnative.screenshare
+
+import android.annotation.SuppressLint
+import android.media.AudioAttributes
+import android.media.AudioFormat
+import android.media.AudioPlaybackCaptureConfiguration
+import android.media.AudioRecord
+import android.media.projection.MediaProjection
+import android.os.Build
+import android.util.Log
+import androidx.annotation.RequiresApi
+import java.nio.ByteBuffer
+
+/**
+ * Captures system media audio using [AudioPlaybackCaptureConfiguration].
+ *
+ * Uses the given [MediaProjection] to set up an [AudioRecord] that captures
+ * audio from media playback, games, and other apps (USAGE_MEDIA, USAGE_GAME,
+ * USAGE_UNKNOWN) but not notifications, alarms, or system sounds.
+ *
+ * Audio is captured in a pull-based manner via [getScreenAudioBytes], which
+ * reads exactly the requested number of bytes using [AudioRecord.READ_BLOCKING].
+ * This is designed to be called from the WebRTC audio processing thread.
+ *
+ * Format: 48kHz, mono, PCM 16-bit (matching WebRTC's audio pipeline).
+ *
+ * Requires Android 10 (API 29+).
+ */
+@RequiresApi(Build.VERSION_CODES.Q)
+class ScreenAudioCapture(private val mediaProjection: MediaProjection) {
+
+    private var audioRecord: AudioRecord? = null
+    private var screenAudioBuffer: ByteBuffer? = null
+
+    companion object {
+        private const val TAG = "ScreenAudioCapture"
+        const val SAMPLE_RATE = 48000
+        private const val CHANNEL_CONFIG = AudioFormat.CHANNEL_IN_MONO
+        private const val AUDIO_FORMAT = AudioFormat.ENCODING_PCM_16BIT
+    }
+
+    @SuppressLint("MissingPermission")
+    fun start() {
+        val playbackConfig = AudioPlaybackCaptureConfiguration.Builder(mediaProjection)
+            .addMatchingUsage(AudioAttributes.USAGE_MEDIA)
+            .addMatchingUsage(AudioAttributes.USAGE_GAME)
+            .addMatchingUsage(AudioAttributes.USAGE_UNKNOWN)
+            .build()
+
+        val audioFormat = AudioFormat.Builder()
+            .setSampleRate(SAMPLE_RATE)
+            .setChannelMask(CHANNEL_CONFIG)
+            .setEncoding(AUDIO_FORMAT)
+            .build()
+
+        audioRecord = AudioRecord.Builder()
+            .setAudioFormat(audioFormat)
+            .setAudioPlaybackCaptureConfig(playbackConfig)
+            .build()
+
+        if (audioRecord?.state != AudioRecord.STATE_INITIALIZED) {
+            Log.e(TAG, "AudioRecord failed to initialize")
+            audioRecord?.release()
+            audioRecord = null
+            return
+        }
+
+        audioRecord?.startRecording()
+        Log.d(TAG, "Screen audio capture started")
+    }
+
+    /**
+     * Pull-based read: returns a [ByteBuffer] containing exactly [bytesRequested] bytes
+     * of captured screen audio.
+     *
+     * Called from the WebRTC audio processing thread. Uses [AudioRecord.READ_BLOCKING]
+     * so it will block until the requested bytes are available.
+     *
+     * @return A [ByteBuffer] with screen audio data, or `null` if capture is not active.
+     */
+    fun getScreenAudioBytes(bytesRequested: Int): ByteBuffer? {
+        val record = audioRecord ?: return null
+        if (bytesRequested <= 0) return null
+
+        val buffer = screenAudioBuffer?.takeIf { it.capacity() >= bytesRequested }
+            ?: ByteBuffer.allocateDirect(bytesRequested).also { screenAudioBuffer = it }
+
+        buffer.clear()
+        buffer.limit(bytesRequested)
+
+        val bytesRead = record.read(buffer, bytesRequested, AudioRecord.READ_BLOCKING)
+        if (bytesRead > 0) {
+            buffer.position(0)
+            buffer.limit(bytesRead)
+            return buffer
+        }
+        return null
+    }
+
+    fun stop() {
+        try {
+            audioRecord?.stop()
+        } catch (e: Exception) {
+            Log.w(TAG, "Error stopping AudioRecord: ${e.message}")
+        }
+        audioRecord?.release()
+        audioRecord = null
+        screenAudioBuffer = null
+        Log.d(TAG, "Screen audio capture stopped")
+    }
+}