feat: AudioManager.getSystemVolume() — synchronous system volume read

packages/react-native-audio-api/android/src/main/java/com/swmansion/audioapi/AudioAPIModule.kt

@@ -147,6 +147,8 @@ class AudioAPIModule(
     MediaSessionManager.observeVolumeChanges(enabled)
   }
 
+  override fun getSystemVolume(): Double = MediaSessionManager.getSystemVolume()
+
   override fun requestRecordingPermissions(promise: Promise) {
     val permissionRequestListener = PermissionRequestListener(promise)
     MediaSessionManager.requestRecordingPermissions(permissionRequestListener)

packages/react-native-audio-api/android/src/main/java/com/swmansion/audioapi/system/MediaSessionManager.kt

@@ -83,6 +83,14 @@ object MediaSessionManager {
     this.notificationRegistry = NotificationRegistry(this.reactContext, this.audioAPIModule)
   }
 
+  /** The system output volume on the volumeChange event's own scale:
+   * STREAM_MUSIC volume as a 0..1 fraction of its maximum. */
+  fun getSystemVolume(): Double {
+    val current = audioManager.getStreamVolume(AudioManager.STREAM_MUSIC).toDouble()
+    val max = audioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC).toDouble()
+    return if (max > 0) current / max else 0.0
+  }
+
   fun getDevicePreferredSampleRate(): Double {
     val sampleRate = this.audioManager.getProperty(AudioManager.PROPERTY_OUTPUT_SAMPLE_RATE)
     return sampleRate.toDouble()

packages/react-native-audio-api/ios/audioapi/ios/AudioAPIModule.mm

@@ -92,6 +92,11 @@ - (dispatch_queue_t)methodQueue
   return [self.audioSessionManager getDevicePreferredSampleRate];
 }
 
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getSystemVolume)
+{
+  return [self.audioSessionManager getSystemVolume];
+}
+
 RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isFfmpegEnabled)
 {
 #if RN_AUDIO_API_FFMPEG_DISABLED

packages/react-native-audio-api/ios/audioapi/ios/system/AudioSessionManager.h

@@ -40,6 +40,7 @@
 - (void)disableSessionManagement;
 
 - (NSNumber *)getDevicePreferredSampleRate;
+- (NSNumber *)getSystemVolume;
 - (NSString *)inputDiagnosticsSnapshot;
 
 - (void)requestRecordingPermissions:(RCTPromiseResolveBlock)resolve

packages/react-native-audio-api/ios/audioapi/ios/system/AudioSessionManager.mm

@@ -214,6 +214,11 @@ - (NSNumber *)getDevicePreferredSampleRate
   return [NSNumber numberWithFloat:[self.audioSession sampleRate]];
 }
 
+- (NSNumber *)getSystemVolume
+{
+  return [NSNumber numberWithFloat:[self.audioSession outputVolume]];
+}
+
 - (NSString *)inputDiagnosticsSnapshot
 {
   AVAudioSessionRouteDescription *route = [self.audioSession currentRoute];

packages/react-native-audio-api/src/specs/NativeAudioAPIModule.ts

@@ -32,6 +32,7 @@ interface Spec extends TurboModule {
   observeAudioInterruptions(focusType: AudioFocusType, enabled: boolean): void;
   activelyReclaimSession(enabled: boolean): void;
   observeVolumeChanges(enabled: boolean): void;
+  getSystemVolume(): number;
 
   // Permissions
   requestRecordingPermissions(): Promise<PermissionStatus>;

packages/react-native-audio-api/src/system/AudioManager.ts

@@ -81,6 +81,22 @@ class AudioManager implements IAudioManager {
     NativeAudioAPIModule.observeVolumeChanges(enabled);
   }
 
+  /**
+   * Synchronously reads the current system output volume as a 0..1 value,
+   * on the same scale the `volumeChange` event reports: AVAudioSession's
+   * outputVolume on iOS, the STREAM_MUSIC volume as a fraction of its
+   * maximum on Android. Complements `observeVolumeChanges`, which only
+   * reports on changes: this answers "what is it right now" before any
+   * change has fired.
+   *
+   * iOS note: a cold read before any volume-change event can report a stale
+   * or zero value on some iOS versions; treat the event stream as the truth
+   * once it speaks.
+   */
+  getSystemVolume(): number {
+    return NativeAudioAPIModule.getSystemVolume();
+  }
+
   addSystemEventListener<Name extends SystemEventName>(
     name: Name,
     callback: SystemEventCallback<Name>

packages/react-native-audio-api/src/system/types.ts

@@ -80,6 +80,7 @@ export interface IAudioManager {
   observeAudioInterruptions(enabled: boolean): void;
   activelyReclaimSession(enabled: boolean): void;
   observeAudioInterruptions(param: AudioFocusType | boolean | null): void;
+  getSystemVolume(): number;
   addSystemEventListener<Name extends SystemEventName>(
     name: Name,
     callback: SystemEventCallback<Name>