@edkimmel/expo-audio-stream 0.6.2 → 0.6.4

package/android/src/main/java/expo/modules/audiostream/AudioRecorderManager.kt

@@ -36,6 +36,7 @@ class AudioRecorderManager(
 
     // Flag to control whether actual audio data or silence is sent
     private var isSilent = false
+    @Volatile private var micGain: Float = 1.0f
     private var frequencyBandAnalyzer: FrequencyBandAnalyzer? = null
     private val gainNormalizer = GainNormalizer()
 
@@ -154,9 +155,10 @@ class AudioRecorderManager(
         // Generate a unique ID for this recording stream
         streamUuid = java.util.UUID.randomUUID().toString()
 
-        audioRecord?.startRecording()
-        // Apply audio effects after starting recording using the manager
+        // AEC and other effects must be attached before startRecording() so the
+        // hardware echo canceller processes audio from the very first captured frame.
         audioRecord?.let { audioEffectsManager.setupAudioEffects(it) }
+        audioRecord?.startRecording()
 
         isPaused.set(false)
         isRecording.set(true)
@@ -385,8 +387,11 @@ class AudioRecorderManager(
     }
 
     private fun emitAudioData(audioData: ByteArray, length: Int) {
-        // If silent mode is active, replace audioData with zeros (using concise expression)
-        val dataToEncode = if (isSilent) ByteArray(length) else audioData
+        val dataToEncode = when {
+            isSilent -> ByteArray(length)
+            micGain != 1.0f -> applyMicGain(audioData, length, micGain)
+            else -> audioData
+        }
 
         val encodedBuffer = audioDataEncoder.encodeToBase64(dataToEncode)
 
@@ -471,6 +476,25 @@ class AudioRecorderManager(
     /**
      * Toggles between sending actual audio data and silence
      */
+    fun setMicrophoneGain(gain: Float) {
+        micGain = gain.coerceIn(0.0f, 1.0f)
+    }
+
+    private fun applyMicGain(data: ByteArray, length: Int, gain: Float): ByteArray {
+        val result = ByteArray(length)
+        var i = 0
+        while (i + 1 < length) {
+            val lo = data[i].toInt() and 0xFF
+            val hi = data[i + 1].toInt()       // sign-extends
+            val sample = (hi shl 8) or lo      // little-endian Int16
+            val scaled = (sample * gain).toInt().coerceIn(-32768, 32767)
+            result[i]     = (scaled and 0xFF).toByte()
+            result[i + 1] = (scaled shr 8).toByte()
+            i += 2
+        }
+        return result
+    }
+
     fun toggleSilence(isSilent: Boolean) {
         this.isSilent = isSilent
         Log.d(Constants.TAG, "Silence mode toggled: $isSilent")

package/android/src/main/java/expo/modules/audiostream/ExpoPlayAudioStreamModule.kt

@@ -168,10 +168,13 @@ class ExpoPlayAudioStreamModule : Module(), EventSender {
         }
 
         Function("toggleSilence") { isSilent: Boolean ->
-            // Just toggle silence without returning any value
             audioRecorderManager.toggleSilence(isSilent)
         }
 
+        Function("setMicrophoneGain") { gain: Double ->
+            audioRecorderManager.setMicrophoneGain(gain.toFloat())
+        }
+
         // ── Native Audio Pipeline V3 ────────────────────────────────────
 
         AsyncFunction("connectPipeline") { options: Map<String, Any?>, promise: Promise ->

package/build/index.d.ts

@@ -50,6 +50,11 @@ export declare class ExpoPlayAudioStream {
      * @throws {Error} If the microphone fails to toggle silence.
      */
     static toggleSilence(isSilent: boolean): void;
+    /**
+     * Sets the microphone capture gain (0.0 = silent, 1.0 = full).
+     * Takes effect immediately on the next captured audio chunk.
+     */
+    static setMicrophoneGain(gain: number): void;
     /**
      * Requests microphone permission from the user.
      * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -124,6 +124,13 @@ export class ExpoPlayAudioStream {
     static toggleSilence(isSilent) {
         ExpoPlayAudioStreamModule.toggleSilence(isSilent);
     }
+    /**
+     * Sets the microphone capture gain (0.0 = silent, 1.0 = full).
+     * Takes effect immediately on the next captured audio chunk.
+     */
+    static setMicrophoneGain(gain) {
+        ExpoPlayAudioStreamModule.setMicrophoneGain(Math.max(0, Math.min(1, gain)));
+    }
     /**
      * Requests microphone permission from the user.
      * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\n// Type alias for backwards compatibility\ntype Subscription = EventSubscription;\nimport {\n  AudioDataEvent,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n} from \"./types\";\n\nimport {\n  addAudioEventListener,\n  addMicrophoneErrorListener,\n  AudioEventPayload,\n  AudioEvents,\n  subscribeToEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n} from \"./events\";\n\nexport class ExpoPlayAudioStream {\n  /**\n   * Destroys the audio stream module, cleaning up all resources.\n   * This should be called when the module is no longer needed.\n   * It will reset all internal state and release audio resources.\n   */\n  static async destroy() {\n    await ExpoPlayAudioStreamModule.destroy();\n  }\n\n  /**\n   * Starts microphone streaming.\n   * @param {RecordingConfig} recordingConfig - The recording configuration.\n   * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.\n   * @throws {Error} If the recording fails to start.\n   */\n  static async startMicrophone(recordingConfig: RecordingConfig): Promise<{\n    recordingResult: StartRecordingResult;\n    subscription?: Subscription;\n  }> {\n    let subscription: Subscription | undefined;\n    try {\n      const { onAudioStream, onError, ...options } = recordingConfig;\n\n      const subscriptions: EventSubscription[] = [];\n\n      if (onAudioStream && typeof onAudioStream === \"function\") {\n        subscriptions.push(\n          addAudioEventListener(async (event: AudioEventPayload) => {\n            const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, error } = event;\n            // Only suppress AudioData error events when onError is wired up — the\n            // MicrophoneError subscription will handle them. Without onError (old\n            // integration or old native binary), fall through so the missing-encoded\n            // path below preserves the pre-v0.6.0 behavior.\n            if (error && onError) return;\n            if (!encoded) {\n              console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n              throw new Error(\"Encoded audio data is missing\");\n            }\n            onAudioStream({\n              data: encoded,\n              position,\n              fileUri,\n              eventDataSize: deltaSize,\n              totalSize,\n              soundLevel,\n              frequencyBands,\n            });\n          })\n        );\n      }\n\n      if (onError && typeof onError === \"function\") {\n        subscriptions.push(\n          addMicrophoneErrorListener((event) => {\n            onError(event);\n          })\n        );\n      }\n\n      if (subscriptions.length > 0) {\n        subscription = { remove: () => subscriptions.forEach((s) => s.remove()) };\n      }\n\n      const result = await ExpoPlayAudioStreamModule.startMicrophone(options);\n\n      return { recordingResult: result, subscription };\n    } catch (error) {\n      console.error(error);\n      subscription?.remove();\n      throw new Error(`Failed to start recording: ${error}`);\n    }\n  }\n\n  /**\n   * Stops the current microphone streaming.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone streaming fails to stop.\n   */\n  static async stopMicrophone(): Promise<AudioRecording | null> {\n    try {\n      return await ExpoPlayAudioStreamModule.stopMicrophone();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to stop mic stream: ${error}`);\n    }\n  }\n\n  /**\n   * Subscribes to audio events emitted during recording/streaming.\n   * @param onMicrophoneStream - Callback function that will be called when audio data is received.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events\n   */\n  static subscribeToAudioEvents(\n    onMicrophoneStream: (event: AudioDataEvent) => Promise<void>\n  ): Subscription {\n    return addAudioEventListener(async (event: AudioEventPayload) => {\n      const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands } =\n        event;\n      if (!encoded) {\n        console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n        throw new Error(\"Encoded audio data is missing\");\n      }\n      onMicrophoneStream?.({\n        data: encoded,\n        position,\n        fileUri,\n        eventDataSize: deltaSize,\n        totalSize,\n        soundLevel,\n        frequencyBands,\n      });\n    });\n  }\n\n  /**\n   * Subscribes to events emitted by the audio stream module, for advanced use cases.\n   * @param eventName - The name of the event to subscribe to.\n   * @param onEvent - Callback function that will be called when the event is emitted.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.\n   */\n  static subscribe<T extends unknown>(\n    eventName: string,\n    onEvent: (event: T | undefined) => Promise<void>\n  ): Subscription {\n    return subscribeToEvent(eventName, onEvent);\n  }\n\n  /**\n   * Prompts the user to select the microphone mode.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone mode fails to prompt.\n   */\n  static promptMicrophoneModes() {\n    ExpoPlayAudioStreamModule.promptMicrophoneModes();\n  }\n\n  /**\n   * Toggles the silence state of the microphone.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone fails to toggle silence.\n   */\n  static toggleSilence(isSilent: boolean) {\n    ExpoPlayAudioStreamModule.toggleSilence(isSilent);\n  }\n\n  /**\n   * Requests microphone permission from the user.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.\n   */\n  static async requestPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.requestPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to request permissions: ${error}`);\n    }\n  }\n\n  /**\n   * Gets the current microphone permission status.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.\n   */\n  static async getPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.getPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to get permissions: ${error}`);\n    }\n  }\n}\n\nexport {\n  AudioDataEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  AudioEvents,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n};\n\n// Re-export Subscription type for backwards compatibility\nexport type { EventSubscription } from \"expo-modules-core\";\nexport type { Subscription } from \"./events\";\nexport { addMicrophoneErrorListener } from \"./events\";\nexport type { MicrophoneErrorEventPayload } from \"./events\";\n\n// Export native audio pipeline V3\nexport { Pipeline } from \"./pipeline\";\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelinePlaybackStoppedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from \"./pipeline\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\n// Type alias for backwards compatibility\ntype Subscription = EventSubscription;\nimport {\n  AudioDataEvent,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n} from \"./types\";\n\nimport {\n  addAudioEventListener,\n  addMicrophoneErrorListener,\n  AudioEventPayload,\n  AudioEvents,\n  subscribeToEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n} from \"./events\";\n\nexport class ExpoPlayAudioStream {\n  /**\n   * Destroys the audio stream module, cleaning up all resources.\n   * This should be called when the module is no longer needed.\n   * It will reset all internal state and release audio resources.\n   */\n  static async destroy() {\n    await ExpoPlayAudioStreamModule.destroy();\n  }\n\n  /**\n   * Starts microphone streaming.\n   * @param {RecordingConfig} recordingConfig - The recording configuration.\n   * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.\n   * @throws {Error} If the recording fails to start.\n   */\n  static async startMicrophone(recordingConfig: RecordingConfig): Promise<{\n    recordingResult: StartRecordingResult;\n    subscription?: Subscription;\n  }> {\n    let subscription: Subscription | undefined;\n    try {\n      const { onAudioStream, onError, ...options } = recordingConfig;\n\n      const subscriptions: EventSubscription[] = [];\n\n      if (onAudioStream && typeof onAudioStream === \"function\") {\n        subscriptions.push(\n          addAudioEventListener(async (event: AudioEventPayload) => {\n            const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands, error } = event;\n            // Only suppress AudioData error events when onError is wired up — the\n            // MicrophoneError subscription will handle them. Without onError (old\n            // integration or old native binary), fall through so the missing-encoded\n            // path below preserves the pre-v0.6.0 behavior.\n            if (error && onError) return;\n            if (!encoded) {\n              console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n              throw new Error(\"Encoded audio data is missing\");\n            }\n            onAudioStream({\n              data: encoded,\n              position,\n              fileUri,\n              eventDataSize: deltaSize,\n              totalSize,\n              soundLevel,\n              frequencyBands,\n            });\n          })\n        );\n      }\n\n      if (onError && typeof onError === \"function\") {\n        subscriptions.push(\n          addMicrophoneErrorListener((event) => {\n            onError(event);\n          })\n        );\n      }\n\n      if (subscriptions.length > 0) {\n        subscription = { remove: () => subscriptions.forEach((s) => s.remove()) };\n      }\n\n      const result = await ExpoPlayAudioStreamModule.startMicrophone(options);\n\n      return { recordingResult: result, subscription };\n    } catch (error) {\n      console.error(error);\n      subscription?.remove();\n      throw new Error(`Failed to start recording: ${error}`);\n    }\n  }\n\n  /**\n   * Stops the current microphone streaming.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone streaming fails to stop.\n   */\n  static async stopMicrophone(): Promise<AudioRecording | null> {\n    try {\n      return await ExpoPlayAudioStreamModule.stopMicrophone();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to stop mic stream: ${error}`);\n    }\n  }\n\n  /**\n   * Subscribes to audio events emitted during recording/streaming.\n   * @param onMicrophoneStream - Callback function that will be called when audio data is received.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events\n   */\n  static subscribeToAudioEvents(\n    onMicrophoneStream: (event: AudioDataEvent) => Promise<void>\n  ): Subscription {\n    return addAudioEventListener(async (event: AudioEventPayload) => {\n      const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, frequencyBands } =\n        event;\n      if (!encoded) {\n        console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n        throw new Error(\"Encoded audio data is missing\");\n      }\n      onMicrophoneStream?.({\n        data: encoded,\n        position,\n        fileUri,\n        eventDataSize: deltaSize,\n        totalSize,\n        soundLevel,\n        frequencyBands,\n      });\n    });\n  }\n\n  /**\n   * Subscribes to events emitted by the audio stream module, for advanced use cases.\n   * @param eventName - The name of the event to subscribe to.\n   * @param onEvent - Callback function that will be called when the event is emitted.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.\n   */\n  static subscribe<T extends unknown>(\n    eventName: string,\n    onEvent: (event: T | undefined) => Promise<void>\n  ): Subscription {\n    return subscribeToEvent(eventName, onEvent);\n  }\n\n  /**\n   * Prompts the user to select the microphone mode.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone mode fails to prompt.\n   */\n  static promptMicrophoneModes() {\n    ExpoPlayAudioStreamModule.promptMicrophoneModes();\n  }\n\n  /**\n   * Toggles the silence state of the microphone.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone fails to toggle silence.\n   */\n  static toggleSilence(isSilent: boolean) {\n    ExpoPlayAudioStreamModule.toggleSilence(isSilent);\n  }\n\n  /**\n   * Sets the microphone capture gain (0.0 = silent, 1.0 = full).\n   * Takes effect immediately on the next captured audio chunk.\n   */\n  static setMicrophoneGain(gain: number) {\n    ExpoPlayAudioStreamModule.setMicrophoneGain(Math.max(0, Math.min(1, gain)));\n  }\n\n  /**\n   * Requests microphone permission from the user.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.\n   */\n  static async requestPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.requestPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to request permissions: ${error}`);\n    }\n  }\n\n  /**\n   * Gets the current microphone permission status.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.\n   */\n  static async getPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.getPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to get permissions: ${error}`);\n    }\n  }\n}\n\nexport {\n  AudioDataEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  AudioEvents,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  FrequencyBands,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n};\n\n// Re-export Subscription type for backwards compatibility\nexport type { EventSubscription } from \"expo-modules-core\";\nexport type { Subscription } from \"./events\";\nexport { addMicrophoneErrorListener } from \"./events\";\nexport type { MicrophoneErrorEventPayload } from \"./events\";\n\n// Export native audio pipeline V3\nexport { Pipeline } from \"./pipeline\";\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelinePlaybackStoppedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from \"./pipeline\";\n"]}

package/ios/AudioPipeline.swift

@@ -69,9 +69,19 @@ class AudioPipeline: SharedAudioEngineDelegate {
     private var outputFormat: AVAudioFormat?
     private var jitterBuffer: JitterBuffer?
 
-    /// Number of interleaved Int16 samples per scheduled buffer.
+    /// Number of interleaved Int16 samples read from the JitterBuffer per scheduled buffer
+    /// (at pipeline sample rate, e.g. 16 kHz).
     let frameSizeSamples: Int
 
+    /// Hardware output sample rate — read at connect time from the engine's output node.
+    /// The player node connects at this rate so AVAudioEngine injects no hidden resampler,
+    /// keeping the AEC echo reference deterministically timed.
+    private var hardwareSampleRate: Double = 48000
+
+    /// Number of frames written to the hardware-rate PCM buffer per scheduled buffer.
+    /// Always >= frameSizeSamples; computed as hardwareSampleRate / 50 (20 ms chunks).
+    private var hwFramesPerBuffer: Int = 960
+
     // ── Threading / state ───────────────────────────────────────────────
     private var running = false
     private let turnLock = NSLock()
@@ -178,10 +188,21 @@ class AudioPipeline: SharedAudioEngineDelegate {
             // (ensureAudioSessionInitialized). Just ensure it's active.
             try AVAudioSession.sharedInstance().setActive(true)
 
-            // ── 4. Create format and attach player node to shared engine ─
+            // ── 4. Read hardware rate and create hardware-rate format ───
+            // Connecting at the native hardware rate prevents AVAudioEngine from
+            // injecting a hidden resampler between the player node and the hardware
+            // output. A hidden resampler shifts buffer timestamps and desynchronises
+            // the AEC echo reference, causing the adaptive filter to converge slowly
+            // or not at all. The scheduling loop handles the 16kHz→48kHz conversion
+            // via linear interpolation before handing buffers to the player node.
+            let rawHwRate = sharedEngine.engine?.outputNode.outputFormat(forBus: 0).sampleRate ?? 0
+            let resolvedHwRate = rawHwRate > 0 ? rawHwRate : 48000
+            hardwareSampleRate = resolvedHwRate
+            hwFramesPerBuffer = max(1, Int(resolvedHwRate / 50.0))
+
             guard let format = AVAudioFormat(
                 commonFormat: .pcmFormatFloat32,
-                sampleRate: Double(sampleRate),
+                sampleRate: resolvedHwRate,
                 channels: AVAudioChannelCount(channelCount),
                 interleaved: false
             ) else {
@@ -219,8 +240,9 @@ class AudioPipeline: SharedAudioEngineDelegate {
             startFrequencyBandTimer()
 
             setState(.idle)
-            Logger.debug("[\(AudioPipeline.TAG)] Connected — sampleRate=\(sampleRate) " +
-                "ch=\(channelCount) frameSamples=\(frameSizeSamples) " +
+            Logger.debug("[\(AudioPipeline.TAG)] Connected — pipelineRate=\(sampleRate) " +
+                "hwRate=\(Int(resolvedHwRate)) ch=\(channelCount) " +
+                "pipelineFrames=\(frameSizeSamples) hwFrames=\(hwFramesPerBuffer) " +
                 "targetBuffer=\(targetBufferMs)ms")
     }
 
@@ -311,14 +333,27 @@ class AudioPipeline: SharedAudioEngineDelegate {
         // Old node is invalid (detached during teardown). Create a fresh one.
         scheduleGeneration += 1
 
-        guard let sharedEngine = sharedEngine,
-              let format = AVAudioFormat(
-                  commonFormat: .pcmFormatFloat32,
-                  sampleRate: Double(sampleRate),
-                  channels: AVAudioChannelCount(channelCount),
-                  interleaved: false
-              ) else {
-            Logger.debug("[\(AudioPipeline.TAG)] engineDidRebuild — cannot create format or engine missing, treating as dead")
+        guard let sharedEngine = sharedEngine else {
+            Logger.debug("[\(AudioPipeline.TAG)] engineDidRebuild — engine missing, treating as dead")
+            running = false
+            setState(.error)
+            listener?.onError(code: "ENGINE_DIED", message: "Failed to recreate audio node after engine rebuild")
+            return
+        }
+
+        // Re-read hardware rate from the new engine (route may have changed).
+        let rawHwRate = sharedEngine.engine?.outputNode.outputFormat(forBus: 0).sampleRate ?? 0
+        let resolvedHwRate = rawHwRate > 0 ? rawHwRate : hardwareSampleRate
+        hardwareSampleRate = resolvedHwRate
+        hwFramesPerBuffer = max(1, Int(resolvedHwRate / 50.0))
+
+        guard let format = AVAudioFormat(
+            commonFormat: .pcmFormatFloat32,
+            sampleRate: resolvedHwRate,
+            channels: AVAudioChannelCount(channelCount),
+            interleaved: false
+        ) else {
+            Logger.debug("[\(AudioPipeline.TAG)] engineDidRebuild — cannot create format, treating as dead")
             running = false
             setState(.error)
             listener?.onError(code: "ENGINE_DIED", message: "Failed to recreate audio node after engine rebuild")
@@ -540,28 +575,35 @@ class AudioPipeline: SharedAudioEngineDelegate {
             }
         }
 
-        // Convert to non-interleaved Float32 for AVAudioEngine
-        let framesPerBuffer = frameSizeSamples / channelCount
+        // Build a hardware-rate PCM buffer. The scheduling loop resamples from
+        // pipeline rate (e.g. 16 kHz) to hardware rate (e.g. 48 kHz) so the
+        // player node connects at the native rate and the engine never inserts a
+        // hidden resampler that would desynchronise the AEC echo reference.
+        let pipelineFrames = frameSizeSamples / channelCount  // frames at pipeline rate
+        let hwFrames       = hwFramesPerBuffer                 // frames at hardware rate
         guard let pcmBuffer = AVAudioPCMBuffer(
             pcmFormat: format,
-            frameCapacity: AVAudioFrameCount(framesPerBuffer)
+            frameCapacity: AVAudioFrameCount(hwFrames)
         ) else { return }
-        pcmBuffer.frameLength = AVAudioFrameCount(framesPerBuffer)
+        pcmBuffer.frameLength = AVAudioFrameCount(hwFrames)
 
         if let channelData = pcmBuffer.floatChannelData {
             if isInterrupted {
-                // Write silence during interruption
                 for ch in 0..<channelCount {
-                    for i in 0..<framesPerBuffer {
-                        channelData[ch][i] = 0
-                    }
+                    for i in 0..<hwFrames { channelData[ch][i] = 0 }
                 }
             } else {
-                // De-interleave Int16 → non-interleaved Float32
-                for frame in 0..<framesPerBuffer {
+                // Linear interpolation: pipeline rate → hardware rate
+                let ratio = hardwareSampleRate / Double(sampleRate)
+                for i in 0..<hwFrames {
+                    let virtualIndex = Double(i) / ratio
+                    let indexLow  = Int(virtualIndex)
+                    let indexHigh = min(indexLow + 1, pipelineFrames - 1)
+                    let weight    = Float(virtualIndex - Double(indexLow))
                     for ch in 0..<channelCount {
-                        let sampleIndex = frame * channelCount + ch
-                        channelData[ch][frame] = Float(renderSamples[sampleIndex]) / 32768.0
+                        let sampleLow  = Float(renderSamples[indexLow  * channelCount + ch]) / 32768.0
+                        let sampleHigh = Float(renderSamples[indexHigh * channelCount + ch]) / 32768.0
+                        channelData[ch][i] = sampleLow + weight * (sampleHigh - sampleLow)
                     }
                 }
             }

package/ios/ExpoPlayAudioStreamModule.swift

@@ -31,6 +31,7 @@ public class ExpoPlayAudioStreamModule: Module, MicrophoneDataDelegate, Pipeline
     }
 
     private var isAudioSessionInitialized: Bool = false
+    private var micTotalDataSize: Int = 0
 
     // ── PipelineEventSender conformance ───────────────────────────────
     func sendPipelineEvent(_ eventName: String, _ params: [String: Any]) {
@@ -150,6 +151,7 @@ public class ExpoPlayAudioStreamModule: Module, MicrophoneDataDelegate, Pipeline
                         "sampleRate": result.sampleRate ?? 48000,
                         "mimeType": result.mimeType ?? "",
                     ]
+                    micTotalDataSize = 0
                     promise.resolve(resultDict)
                 }
             } else {
@@ -165,6 +167,10 @@ public class ExpoPlayAudioStreamModule: Module, MicrophoneDataDelegate, Pipeline
             microphone.toggleSilence(isSilent: isSilent)
         }
 
+        Function("setMicrophoneGain") { (gain: Double) in
+            microphone.setMicrophoneGain(Float(gain))
+        }
+
         // ── Pipeline functions ────────────────────────────────────────────
 
         AsyncFunction("connectPipeline") { (options: [String: Any], promise: Promise) in
@@ -324,13 +330,15 @@ public class ExpoPlayAudioStreamModule: Module, MicrophoneDataDelegate, Pipeline
 
     func onMicrophoneData(_ microphoneData: Data, _ soundLevel: Float?, _ frequencyBands: FrequencyBands?) {
         let encodedData = microphoneData.base64EncodedString()
+        let deltaSize = microphoneData.count
+        micTotalDataSize += deltaSize
         var eventBody: [String: Any] = [
             "fileUri": "",
             "lastEmittedSize": 0,
             "position": 0,
             "encoded": encodedData,
-            "deltaSize": 0,
-            "totalSize": 0,
+            "deltaSize": deltaSize,
+            "totalSize": micTotalDataSize,
             "mimeType": "",
             "soundLevel": soundLevel ?? -160
         ]

package/ios/Microphone.swift

@@ -30,6 +30,9 @@ class Microphone: SharedAudioEngineDelegate {
 
     private var isRecording: Bool = false
     private var isSilent: Bool = false
+    // Read on the audio render thread, written from the JS thread.
+    // Float is 4 bytes / naturally aligned — atomic on ARM64, no lock needed.
+    private var micGain: Float = 1.0
     private var frequencyBandAnalyzer: FrequencyBandAnalyzer?
     private var frequencyBandConfig: (lowCrossoverHz: Float, highCrossoverHz: Float)?
 
@@ -124,6 +127,10 @@ class Microphone: SharedAudioEngineDelegate {
         self.isSilent = isSilent
     }
 
+    func setMicrophoneGain(_ gain: Float) {
+        micGain = max(0.0, min(1.0, gain))
+    }
+
     func startRecording(settings: RecordingSettings, intervalMilliseconds: Int,
                         frequencyBandConfig: (lowCrossoverHz: Float, highCrossoverHz: Float)? = nil) -> StartRecordingResult? {
         guard !isRecording else {
@@ -213,12 +220,27 @@ class Microphone: SharedAudioEngineDelegate {
         let hardwareFormat = inputNode.inputFormat(forBus: 0)
         recordingSettings?.sampleRate = hardwareFormat.sampleRate
 
+        // outputFormat is what the tap actually receives — under VoiceProcessingIO
+        // this may differ from inputFormat (VP may output at a different rate and
+        // adds internal metadata channels beyond channel 0).
+        let nodeOutputFormat = inputNode.outputFormat(forBus: 0)
+
         let intervalSamples = AVAudioFrameCount(
-            Double(intervalMilliseconds) / 1000.0 * hardwareFormat.sampleRate
+            Double(intervalMilliseconds) / 1000.0 * nodeOutputFormat.sampleRate
         )
         let tapBufferSize = max(intervalSamples, 256)
 
-        inputNode.installTap(onBus: 0, bufferSize: tapBufferSize, format: nil) { [weak self] (buffer, time) in
+        // Explicit mono Float32 format strips VP metadata channels. Passing format: nil
+        // here would deliver the raw VP output channels, corrupting the audio stream
+        // with echo-tracking metadata that bleeds into downstream processing.
+        let tapFormat = AVAudioFormat(
+            commonFormat: .pcmFormatFloat32,
+            sampleRate: nodeOutputFormat.sampleRate,
+            channels: 1,
+            interleaved: false
+        )
+
+        inputNode.installTap(onBus: 0, bufferSize: tapBufferSize, format: tapFormat) { [weak self] (buffer, time) in
             guard let self = self else { return }
             guard buffer.frameLength > 0 else {
                 Logger.debug("[Microphone] Received empty buffer in tap callback")
@@ -279,7 +301,8 @@ class Microphone: SharedAudioEngineDelegate {
 
         let data: Data
         if isSilent {
-            let byteCount = Int(currentBuffer.frameCapacity) * Int(currentBuffer.format.streamDescription.pointee.mBytesPerFrame)
+            let bytesPerSample = targetBitDepth / 8
+            let byteCount = Int(currentBuffer.frameLength) * Int(currentBuffer.format.channelCount) * bytesPerSample
             data = Data(repeating: 0, count: byteCount)
         } else if targetBitDepth == 16 && currentBuffer.format.commonFormat == .pcmFormatFloat32,
                   let floatData = currentBuffer.floatChannelData {
@@ -288,7 +311,7 @@ class Microphone: SharedAudioEngineDelegate {
             var int16Data = Data(capacity: frameCount * channelCount * 2)
             for frame in 0..<frameCount {
                 for ch in 0..<channelCount {
-                    let sample = max(-1.0, min(1.0, floatData[ch][frame]))
+                    let sample = max(-1.0, min(1.0, floatData[ch][frame] * micGain))
                     var int16Sample = Int16(sample * 32767.0)
                     int16Data.append(Data(bytes: &int16Sample, count: 2))
                 }

package/ios/SharedAudioEngine.swift

@@ -130,10 +130,15 @@ class SharedAudioEngine {
     }
 
     private func configureOnQueue(playbackMode: PlaybackMode) throws {
-        if isConfigured && self.playbackMode == playbackMode && engine?.isRunning == true {
+        let needsVP = playbackMode == .conversation || playbackMode == .voiceProcessing
+        let vpActive = !needsVP || (engine?.inputNode.isVoiceProcessingEnabled == true)
+        if isConfigured && self.playbackMode == playbackMode && engine?.isRunning == true && vpActive {
             Logger.debug("[\(SharedAudioEngine.TAG)] Already configured for \(playbackMode) and engine running, skipping")
             return
         }
+        if isConfigured && !vpActive {
+            Logger.debug("[\(SharedAudioEngine.TAG)] Voice processing dropped (setCategory side-effect) — forcing reconfiguration")
+        }
 
         if isConfigured && engine?.isRunning != true {
             Logger.debug("[\(SharedAudioEngine.TAG)] Engine marked configured but not running — forcing reconfiguration")
@@ -151,7 +156,6 @@ class SharedAudioEngine {
         // Done before connecting nodes so the audio graph incorporates VP from the start.
         if playbackMode == .conversation || playbackMode == .voiceProcessing {
             try engine.inputNode.setVoiceProcessingEnabled(true)
-            try engine.outputNode.setVoiceProcessingEnabled(true)
             Logger.debug("[\(SharedAudioEngine.TAG)] Voice processing enabled")
         }
 
@@ -270,7 +274,6 @@ class SharedAudioEngine {
         if playbackMode == .conversation || playbackMode == .voiceProcessing {
             if let engine = engine {
                 try? engine.inputNode.setVoiceProcessingEnabled(false)
-                try? engine.outputNode.setVoiceProcessingEnabled(false)
             }
         }
 
@@ -350,7 +353,6 @@ class SharedAudioEngine {
             if playbackMode == .conversation || playbackMode == .voiceProcessing {
                 do {
                     try engine.inputNode.setVoiceProcessingEnabled(true)
-                    try engine.outputNode.setVoiceProcessingEnabled(true)
                 } catch {
                     Logger.debug("[\(SharedAudioEngine.TAG)] Voice processing re-enable failed: \(error)")
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edkimmel/expo-audio-stream",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Expo Play Audio Stream module",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/index.ts

@@ -184,6 +184,14 @@ export class ExpoPlayAudioStream {
     ExpoPlayAudioStreamModule.toggleSilence(isSilent);
   }
 
+  /**
+   * Sets the microphone capture gain (0.0 = silent, 1.0 = full).
+   * Takes effect immediately on the next captured audio chunk.
+   */
+  static setMicrophoneGain(gain: number) {
+    ExpoPlayAudioStreamModule.setMicrophoneGain(Math.max(0, Math.min(1, gain)));
+  }
+
   /**
    * Requests microphone permission from the user.
    * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.

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

@@ -1,2 +0,0 @@
-#Thu Jun 04 15:44:34 EDT 2026
-gradle.version=8.9