@siteed/expo-audio-studio 2.4.1 → 2.5.0

package/CHANGELOG.md

@@ -8,6 +8,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+## [2.5.0] - 2025-04-30
+### Changed
+- fix(ios): ensure complete audio data emission on recording stop/pause (#215) ([236e7aa](https://github.com/deeeed/expo-audio-stream/commit/236e7aa040d11626f06da9bbf5746cdcb6f2b457))
+- feat(audio-device): Complete Android implementation for audio device API (#214) ([cedc8d2](https://github.com/deeeed/expo-audio-stream/commit/cedc8d2fbdd5317652ee31c70ee596ec946cf22e))
+- feat(audio-device): Implement cross-platform audio device detection, selection, and fallback handling (#213) ([023b8a1](https://github.com/deeeed/expo-audio-stream/commit/023b8a1d9844bff9f57781860e38a53eb4684fda))
+- feat: Add Zero-Latency Audio Recording with `prepareRecording` API (#211) ([30cb56c](https://github.com/deeeed/expo-audio-stream/commit/30cb56c07d14e7012bff9a4c4d458d5a49cf494e))
+- docs: update api references for v2.4.1 ([b15daef](https://github.com/deeeed/expo-audio-stream/commit/b15daef29a631eb696d5a28422f9cf32b080027e))
+- chore(sherpa-onnx-demo): Restructure WebAssembly Setup and Clean Up Assets (#208) ([7c2adff](https://github.com/deeeed/expo-audio-stream/commit/7c2adffc5ff59391315cb8edaeaae2ab676dd2ba))
 ## [2.4.1] - 2025-04-08
 ### Changed
 - feat(audio-stream): enhance background audio handling and permission checks (#200) ([60befbe](https://github.com/deeeed/expo-audio-stream/commit/60befbedc9d3cbcc1fc684254d812381e5905e43))
@@ -192,7 +200,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Feature: Audio features extraction during recording.
 - Feature: Consistent WAV PCM recording format across all platforms.
 
-[unreleased]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.4.1...HEAD
+[unreleased]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.5.0...HEAD
+[2.5.0]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.4.1...@siteed/expo-audio-studio@2.5.0
 [2.4.1]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.4.0...@siteed/expo-audio-studio@2.4.1
 [2.4.0]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.3.1...@siteed/expo-audio-studio@2.4.0
 [2.3.1]: https://github.com/deeeed/expo-audio-stream/compare/@siteed/expo-audio-studio@2.3.0...@siteed/expo-audio-studio@2.3.1

package/README.md

@@ -36,6 +36,12 @@
 ## Features
 
 - Real-time audio streaming across iOS, Android, and web.
+- Audio input device detection and selection:
+  - List and select from available audio input devices
+  - View detailed device capabilities (sample rates, channels, bit depths)
+  - Support for Bluetooth, USB, and wired devices
+  - Automatic device management with fallback options
+  - Intelligent detection refresh for Bluetooth devices
 - Dual-stream recording capabilities:
   - Simultaneous raw PCM and compressed audio recording
   - Compression formats: OPUS or AAC
@@ -51,6 +57,10 @@
 - Audio features extraction during recording.
 - Consistent WAV PCM recording format across all platforms.
 - Keep recording active while app is in background
+- Zero-latency recording with preparation API:
+  - Pre-initialize audio recording to eliminate startup delay
+  - Prepare permissions, audio buffers, and sessions in advance
+  - Start recording instantly when needed
 - Rich notification system for recording status:
   - Android: Live waveform visualization in notifications
   - Android: Fully customizable notification appearance and actions
@@ -127,6 +137,19 @@ const { startRecording, stopRecording, isRecording, recordingUri } = useAudioRec
   outputFormat: 'wav',
 });
 
+// Use the prepare API for zero-latency recording
+const { prepareRecording, startRecording, stopRecording } = useSharedAudioRecorder();
+
+// First prepare the recording - this initializes all resources
+await prepareRecording({
+  sampleRate: 44100,
+  channels: 2,
+  encoding: 'pcm_16bit'
+});
+
+// Later when needed, start instantly with no delay
+await startRecording(/* same config as prepare */);
+
 // Share recording state across components
 const AudioApp = () => (
   <AudioRecorderProvider>
@@ -228,6 +251,8 @@ const permissions = await ExpoAudioStreamModule.getPermissionsAsync();
 
 For detailed documentation, please refer to the [Getting Started Guide](https://deeeed.github.io/expo-audio-stream/docs/).
 
+For developers interested in contributing or debugging the library, please see the [Contribution Guide](./CONTRIBUTE.md).
+
 ## Companion Resources
 
 ### AudioPlayground Application

package/android/src/main/java/net/siteed/audiostream/AudioAnalysisData.kt

@@ -3,11 +3,19 @@ package net.siteed.audiostream
 
 import android.os.Bundle
 import androidx.core.os.bundleOf
+import net.siteed.audiostream.LogUtils
 
+/**
+ * Represents speech-related features of an audio segment
+ */
 data class SpeechFeatures(
     val isActive: Boolean,
     val speakerId: Int? = null
 ) {
+    companion object {
+        private const val CLASS_NAME = "SpeechFeatures"
+    }
+    
     fun toDictionary(): Map<String, Any?> {
         return mapOf(
             "isActive" to isActive,
@@ -23,6 +31,9 @@ data class SpeechFeatures(
     }
 }
 
+/**
+ * A single data point in the audio analysis result
+ */
 data class DataPoint(
     val id: Long,
     val amplitude: Float,
@@ -37,6 +48,10 @@ data class DataPoint(
     val endPosition: Int? = null,
     val samples: Int = 0
 ) {
+    companion object {
+        private const val CLASS_NAME = "DataPoint"
+    }
+    
     fun toDictionary(): Map<String, Any?> {
         return mapOf(
             "id" to id,
@@ -72,6 +87,9 @@ data class DataPoint(
     }
 }
 
+/**
+ * Primary class to hold audio analysis results
+ */
 data class AudioAnalysisData(
     val segmentDurationMs: Int,
     val durationMs: Int,
@@ -85,6 +103,10 @@ data class AudioAnalysisData(
     val speechAnalysis: SpeechAnalysis? = null,
     val extractionTimeMs: Float
 ) {
+    companion object {
+        private const val CLASS_NAME = "AudioAnalysisData"
+    }
+
     data class AmplitudeRange(val min: Float, val max: Float) {
         fun toDictionary(): Map<String, Float> {
             return mapOf("min" to min, "max" to max)