react-native-audio-api 0.11.0 → 0.11.2

package/README.md

@@ -36,6 +36,20 @@ check out the [Getting Started](https://docs.swmansion.com/react-native-audio-ap
 - **Noise Cancellation 🦇**<br />
   System-based active noise and echo cancellation support
 
+### <a href="https://github.com/software-mansion/react-native-audio-api/releases/tag/0.11.0"><img src="https://img.shields.io/badge/Released_in-0.11.0-green" /></a>
+
+- **Recording to file 📼**<br />
+  Fully customizable recording to a file. Choose a file format, quality and other parameters. Fully integrated with the audio graph.
+
+- **Playback and recording notification system 🔔**<br />
+  Control playback and recording from the notification center / lock screen and create custom notification layouts.
+
+- **Wave Shaper Node 🎸**<br />
+  Create custom nonlinear distortion effects. No need to buy guitar pedals anymore!
+
+- **IIR Filter Node 🧪**<br />
+  Implement custom digital filters using feedforward and feedback coefficients.
+
 ### <a href="https://github.com/software-mansion/react-native-audio-api/releases/tag/0.10.0"><img src="https://img.shields.io/badge/Released_in-0.10.0-green" /></a>
 
 - **Decoding and utility modules 🔧**<br />

package/RNAudioAPI.podspec

@@ -2,15 +2,18 @@ require "json"
 require_relative './scripts/rnaa_utils'
 
 package_json = JSON.parse(File.read(File.join(__dir__, "package.json")))
+$audio_api_config = find_audio_api_config()
 
 $new_arch_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'
 $RN_AUDIO_API_FFMPEG_DISABLED = ENV['DISABLE_AUDIOAPI_FFMPEG'].nil? ? false : ENV['DISABLE_AUDIOAPI_FFMPEG'] == '1' # false by default
 
-folly_flags = "-DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32"
 fabric_flags = $new_arch_enabled ? '-DRCT_NEW_ARCH_ENABLED' : ''
 version_flag = "-DAUDIOAPI_VERSION=#{package_json['version']}"
+ios_min_version = '14.0'
+
+worklets_enabled = $audio_api_config[:worklets_enabled]
+worklets_preprocessor_flag = worklets_enabled ? '-DRN_AUDIO_API_ENABLE_WORKLETS=1' : ''
 
-worklets_preprocessor_flag = check_if_worklets_enabled() ? '-DRN_AUDIO_API_ENABLE_WORKLETS=1' : ''
 ffmpeg_flag = $RN_AUDIO_API_FFMPEG_DISABLED ? '-DRN_AUDIO_API_FFMPEG_DISABLED=1' : ''
 skip_ffmpeg_argument = $RN_AUDIO_API_FFMPEG_DISABLED ? 'skipffmpeg' : ''
 
@@ -22,7 +25,7 @@ Pod::Spec.new do |s|
   s.license      = package_json["license"]
   s.authors      = package_json["author"]
 
-  s.platforms    = { :ios => min_ios_version_supported }
+  s.platforms    = { :ios => ios_min_version }
   s.source       = { :git => "https://github.com/software-mansion/react-native-audio-api.git", :tag => "#{s.version}" }
 
   s.subspec "audioapi" do |ss|
@@ -45,9 +48,11 @@ Pod::Spec.new do |s|
     end
   end
 
-  s.ios.frameworks = 'CoreFoundation', 'CoreAudio', 'AudioToolbox', 'Accelerate', 'MediaPlayer', 'AVFoundation'
+  if worklets_enabled
+    s.dependency 'RNWorklets'
+  end
 
-  s.compiler_flags = "#{folly_flags}"
+  s.ios.frameworks = 'Accelerate', 'AVFoundation', 'MediaPlayer'
 
   s.prepare_command = <<-CMD
     chmod +x scripts/download-prebuilt-binaries.sh
@@ -67,41 +72,61 @@ Pod::Spec.new do |s|
     'common/cpp/audioapi/external/ffmpeg_ios/libavutil.xcframework',
     'common/cpp/audioapi/external/ffmpeg_ios/libswresample.xcframework'
   ]
-s.pod_target_xcconfig = {
-  "USE_HEADERMAP" => "YES",
-  "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
-  "GCC_PREPROCESSOR_DEFINITIONS" => '$(inherited) HAVE_ACCELERATE=1',
-  "HEADER_SEARCH_PATHS" => %W[
-    $(PODS_TARGET_SRCROOT)/common/cpp
-    $(PODS_TARGET_SRCROOT)/ios
-    $(PODS_ROOT)/Headers/Public/RNWorklets
-    $(PODS_ROOT)/Headers/Private/React-Core
-    $(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include
-    $(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include/opus
-    $(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include/vorbis
-  ].concat($RN_AUDIO_API_FFMPEG_DISABLED ? [] : ["$(PODS_TARGET_SRCROOT)/#{external_dir_relative}/ffmpeg_include"]).join(" "),
-  'OTHER_CFLAGS' => "$(inherited) #{folly_flags} #{fabric_flags} #{version_flag} #{worklets_preprocessor_flag} #{ffmpeg_flag}",
-  'OTHER_CPLUSPLUSFLAGS' => "$(inherited) #{folly_flags} #{fabric_flags} #{version_flag} #{worklets_preprocessor_flag} #{ffmpeg_flag}",
-}
-
-s.user_target_xcconfig = {
-  'OTHER_LDFLAGS' => %W[
-    $(inherited)
-    -force_load #{lib_dir}/libopusfile.a
-    -force_load #{lib_dir}/libopus.a
-    -force_load #{lib_dir}/libogg.a
-    -force_load #{lib_dir}/libvorbis.a
-    -force_load #{lib_dir}/libvorbisenc.a
-    -force_load #{lib_dir}/libvorbisfile.a
-    -force_load #{lib_dir}/libssl.a
-    -force_load #{lib_dir}/libcrypto.a
-  ].join(" "),
-  'HEADER_SEARCH_PATHS' => %W[
-    $(inherited)
-    $(PODS_ROOT)/Headers/Public/RNAudioAPI
-    $(PODS_TARGET_SRCROOT)/common/cpp
-  ].join(' ')
-}
+
+  s.pod_target_xcconfig = {
+    "USE_HEADERMAP" => "YES",
+    "DEFINES_MODULE" => "YES",
+    "HEADER_SEARCH_PATHS" => [
+      '"$(PODS_TARGET_SRCROOT)/ReactCommon"',
+      '"$(PODS_TARGET_SRCROOT)"',
+      '"$(PODS_ROOT)/RCT-Folly"',
+      '"$(PODS_ROOT)/boost"',
+      '"$(PODS_ROOT)/boost-for-react-native"',
+      '"$(PODS_ROOT)/DoubleConversion"',
+      '"$(PODS_ROOT)/Headers/Private/React-Core"',
+      '"$(PODS_ROOT)/Headers/Private/Yoga"',
+      "\"$(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include\"",
+      "\"$(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include/opus\"",
+      "\"$(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include/vorbis\"",
+    ]
+    .concat($RN_AUDIO_API_FFMPEG_DISABLED ? [] : ["\"$(PODS_TARGET_SRCROOT)/#{external_dir_relative}/ffmpeg_include\""])
+    .concat(worklets_enabled ? ['"$(PODS_ROOT)/Headers/Public/RNWorklets"'] : [])
+    .join(' '),
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
+    "GCC_PREPROCESSOR_DEFINITIONS" => '$(inherited) HAVE_ACCELERATE=1',
+    'OTHER_CFLAGS' => "$(inherited) #{fabric_flags} #{version_flag} #{worklets_preprocessor_flag} #{ffmpeg_flag}",
+  }
+
+  s.xcconfig = {
+    "HEADER_SEARCH_PATHS" => [
+      '"$(PODS_ROOT)/boost"',
+      '"$(PODS_ROOT)/boost-for-react-native"',
+      '"$(PODS_ROOT)/glog"',
+      '"$(PODS_ROOT)/RCT-Folly"',
+      '"$(PODS_ROOT)/Headers/Public/React-hermes"',
+      '"$(PODS_ROOT)/Headers/Public/hermes-engine"',
+      "\"$(PODS_ROOT)/#{$audio_api_config[:react_native_common_dir]}\"",
+      "\"$(PODS_ROOT)/#{$audio_api_config[:dynamic_frameworks_audio_api_dir]}/ios\"",
+      "\"$(PODS_ROOT)/#{$audio_api_config[:dynamic_frameworks_audio_api_dir]}/common/cpp\"",
+    ]
+    .concat(worklets_enabled ? [
+      '"$(PODS_ROOT)/Headers/Public/RNWorklets"',
+      "\"$(PODS_ROOT)/#{$audio_api_config[:dynamic_frameworks_worklets_dir]}/apple\"",
+      "\"$(PODS_ROOT)/#{$audio_api_config[:dynamic_frameworks_worklets_dir]}/Common/cpp\""
+    ] : [])
+    .join(' '),
+    'OTHER_LDFLAGS' => %W[
+      $(inherited)
+      -force_load #{lib_dir}/libopusfile.a
+      -force_load #{lib_dir}/libopus.a
+      -force_load #{lib_dir}/libogg.a
+      -force_load #{lib_dir}/libvorbis.a
+      -force_load #{lib_dir}/libvorbisenc.a
+      -force_load #{lib_dir}/libvorbisfile.a
+      -force_load #{lib_dir}/libssl.a
+      -force_load #{lib_dir}/libcrypto.a
+    ].join(" "),
+  }
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
   # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
   install_modules_dependencies(s)

package/android/src/main/cpp/audioapi/android/core/AndroidAudioRecorder.cpp

@@ -102,7 +102,7 @@ Result<NoneType, std::string> AndroidAudioRecorder::openAudioStream() {
 /// RN side requires their "file://" prefix, but sometimes it returned raw path.
 /// Most likely this was due to alpha version mistakes, but in case of problems leaving this here. (ㆆ _ ㆆ)
 /// @returns On success, returns the file URI where the recording is being saved (if file output is enabled).
-Result<std::string, std::string> AndroidAudioRecorder::start() {
+Result<std::string, std::string> AndroidAudioRecorder::start(const std::string &fileNameOverride) {
   std::scoped_lock startLock(callbackMutex_, fileWriterMutex_, adapterNodeMutex_);
 
   if (!isIdle()) {
@@ -120,9 +120,12 @@ Result<std::string, std::string> AndroidAudioRecorder::start() {
   }
 
   if (usesFileOutput()) {
-    auto fileResult =
-        std::static_pointer_cast<AndroidFileWriterBackend>(fileWriter_)
-            ->openFile(streamSampleRate_, streamChannelCount_, streamMaxBufferSizeInFrames_);
+    auto fileResult = std::static_pointer_cast<AndroidFileWriterBackend>(fileWriter_)
+                          ->openFile(
+                              streamSampleRate_,
+                              streamChannelCount_,
+                              streamMaxBufferSizeInFrames_,
+                              fileNameOverride);
 
     if (!fileResult.is_ok()) {
       return Result<std::string, std::string>::Err(
@@ -164,7 +167,7 @@ Result<std::tuple<std::string, double, double>, std::string> AndroidAudioRecorde
   double outputFileSize = 0.0;
   double outputDuration = 0.0;
 
-  if (!isRecording()) {
+  if (isIdle()) {
     return Result<std::tuple<std::string, double, double>, std::string>::Err(
         "Recorder is not in recording state.");
   }
@@ -228,7 +231,7 @@ Result<std::string, std::string> AndroidAudioRecorder::enableFileOutput(
   if (!isIdle()) {
     auto fileResult =
         std::static_pointer_cast<AndroidFileWriterBackend>(fileWriter_)
-            ->openFile(streamSampleRate_, streamChannelCount_, streamMaxBufferSizeInFrames_);
+            ->openFile(streamSampleRate_, streamChannelCount_, streamMaxBufferSizeInFrames_, "");
 
     if (!fileResult.is_ok()) {
       return Result<std::string, std::string>::Err(

package/android/src/main/cpp/audioapi/android/core/AndroidAudioRecorder.h

@@ -26,7 +26,7 @@ class AndroidAudioRecorder : public oboe::AudioStreamCallback, public AudioRecor
   ~AndroidAudioRecorder() override;
   void cleanup();
 
-  Result<std::string, std::string> start() override;
+  Result<std::string, std::string> start(const std::string &fileNameOverride) override;
   Result<std::tuple<std::string, double, double>, std::string> stop() override;
 
   Result<std::string, std::string> enableFileOutput(std::shared_ptr<AudioFileProperties> properties) override;

package/android/src/main/cpp/audioapi/android/core/utils/AndroidFileWriterBackend.h

@@ -17,7 +17,7 @@ class AndroidFileWriterBackend : public AudioFileWriter {
     const std::shared_ptr<AudioFileProperties> &fileProperties)
       : AudioFileWriter(audioEventHandlerRegistry, fileProperties) {}
 
-  virtual OpenFileResult openFile(float streamSampleRate, int32_t streamChannelCount, int32_t streamMaxBufferSize) = 0;
+  virtual OpenFileResult openFile(float streamSampleRate, int32_t streamChannelCount, int32_t streamMaxBufferSize, const std::string &fileNameOverride) = 0;
   virtual bool writeAudioData(void *data, int numFrames) = 0;
 
   std::string getFilePath() const override { return filePath_; }

package/android/src/main/cpp/audioapi/android/core/utils/FileOptions.cpp

@@ -63,7 +63,8 @@ std::string getFileExtension(const std::shared_ptr<AudioFileProperties> &propert
 }
 
 Result<std::string, std::string> getFilePath(
-    const std::shared_ptr<AudioFileProperties> &properties) {
+    const std::shared_ptr<AudioFileProperties> &properties,
+    const std::string &fileNameOverride) {
   std::string directory = getDirectory(properties);
   std::string subDirectory = std::format("{}/{}", directory, properties->subDirectory);
   std::string fileTimestamp = getTimestampString();
@@ -75,8 +76,11 @@ Result<std::string, std::string> getFilePath(
     return Result<std::string, std::string>::Err(result.unwrap_err());
   }
 
-  auto filePath = std::format(
-      "{}/{}_{}.{}", subDirectory, properties->fileNamePrefix, fileTimestamp, extension);
+  auto filePath = fileNameOverride.length() > 0
+      ? std::format("{}/{}.{}", subDirectory, fileNameOverride, extension)
+      : std::format(
+            "{}/{}_{}.{}", subDirectory, properties->fileNamePrefix, fileTimestamp, extension);
+
   return Result<std::string, std::string>::Ok(filePath);
 }
 

package/android/src/main/cpp/audioapi/android/core/utils/FileOptions.h

@@ -15,7 +15,7 @@ std::string getTimestampString();
 
 std::string getDirectory(const std::shared_ptr<AudioFileProperties> &properties);
 std::string getFileExtension(const std::shared_ptr<AudioFileProperties> &properties);
-Result<std::string, std::string> getFilePath(const std::shared_ptr<AudioFileProperties> &properties);
+Result<std::string, std::string> getFilePath(const std::shared_ptr<AudioFileProperties> &properties, const std::string &fileNameOverride);
 
 } // namespace android::fileoptions
 

package/android/src/main/cpp/audioapi/android/core/utils/ffmpegBackend/FFmpegFileWriter.cpp

@@ -53,14 +53,16 @@ FFmpegAudioFileWriter::~FFmpegAudioFileWriter() {
 OpenFileResult FFmpegAudioFileWriter::openFile(
     float streamSampleRate,
     int32_t streamChannelCount,
-    int32_t streamMaxBufferSize) {
+    int32_t streamMaxBufferSize,
+    const std::string &fileNameOverride) {
   streamSampleRate_ = streamSampleRate;
   streamChannelCount_ = streamChannelCount;
   streamMaxBufferSize_ = streamMaxBufferSize;
   framesWritten_.store(0, std::memory_order_release);
   nextPts_ = 0;
   Result<NoneType, std::string> result = Result<NoneType, std::string>::Ok(None);
-  Result<std::string, std::string> filePathResult = fileoptions::getFilePath(fileProperties_);
+  Result<std::string, std::string> filePathResult =
+      fileoptions::getFilePath(fileProperties_, fileNameOverride);
 
   if (!filePathResult.is_ok()) {
     return OpenFileResult::Err(filePathResult.unwrap_err());

package/android/src/main/cpp/audioapi/android/core/utils/ffmpegBackend/FFmpegFileWriter.h

@@ -29,7 +29,7 @@ class FFmpegAudioFileWriter : public AndroidFileWriterBackend {
       const std::shared_ptr<AudioFileProperties> &fileProperties);
   ~FFmpegAudioFileWriter();
 
-  OpenFileResult openFile(float streamSampleRate, int32_t streamChannelCount, int32_t streamMaxBufferSize) override;
+  OpenFileResult openFile(float streamSampleRate, int32_t streamChannelCount, int32_t streamMaxBufferSize, const std::string &fileNameOverride) override;
   CloseFileResult closeFile() override;
 
   bool writeAudioData(void *data, int numFrames) override;

package/android/src/main/cpp/audioapi/android/core/utils/miniaudioBackend/MiniAudioFileWriter.cpp

@@ -75,7 +75,8 @@ MiniAudioFileWriter::~MiniAudioFileWriter() {
 OpenFileResult MiniAudioFileWriter::openFile(
     float streamSampleRate,
     int32_t streamChannelCount,
-    int32_t streamMaxBufferSize) {
+    int32_t streamMaxBufferSize,
+    const std::string &fileNameOverride) {
   streamSampleRate_ = streamSampleRate;
   streamChannelCount_ = streamChannelCount;
   streamMaxBufferSize_ = streamMaxBufferSize;
@@ -95,7 +96,7 @@ OpenFileResult MiniAudioFileWriter::openFile(
         "Failed to initialize converter" + std::string(ma_result_description(result)));
   }
 
-  result = initializeEncoder();
+  result = initializeEncoder(fileNameOverride);
 
   if (result != MA_SUCCESS) {
     return OpenFileResult ::Err(
@@ -266,10 +267,10 @@ ma_result MiniAudioFileWriter::initializeConverterIfNeeded() {
 /// This method sets up the audio encoder for writing to the file,
 /// it should be called only on the JS thread. (during file opening)
 /// @return MA_SUCCESS if initialization was successful, otherwise an error code.
-ma_result MiniAudioFileWriter::initializeEncoder() {
+ma_result MiniAudioFileWriter::initializeEncoder(const std::string &fileNameOverride) {
   ma_result result;
   Result<std::string, std::string> filePathResult =
-      android::fileoptions::getFilePath(fileProperties_);
+      android::fileoptions::getFilePath(fileProperties_, fileNameOverride);
 
   if (!filePathResult.is_ok()) {
     return MA_ERROR;

package/android/src/main/cpp/audioapi/android/core/utils/miniaudioBackend/MiniAudioFileWriter.h

@@ -17,7 +17,7 @@ class MiniAudioFileWriter : public AndroidFileWriterBackend {
       const std::shared_ptr<AudioFileProperties> &fileProperties);
   ~MiniAudioFileWriter();
 
-  OpenFileResult openFile(float streamSampleRate, int32_t streamChannelCount, int32_t streamMaxBufferSize) override;
+  OpenFileResult openFile(float streamSampleRate, int32_t streamChannelCount, int32_t streamMaxBufferSize, const std::string &fileNameOverride) override;
   CloseFileResult closeFile() override;
 
   bool writeAudioData(void *data, int numFrames) override;
@@ -31,7 +31,7 @@ class MiniAudioFileWriter : public AndroidFileWriterBackend {
   ma_uint64 processingBufferLength_{0};
 
   ma_result initializeConverterIfNeeded();
-  ma_result initializeEncoder();
+  ma_result initializeEncoder(const std::string &fileNameOverride);
   ma_uint64 convertBuffer(void *data, int numFrames);
 
   bool isConverterRequired();

package/android/src/main/java/com/swmansion/audioapi/AudioAPIModule.kt

@@ -1,5 +1,6 @@
 package com.swmansion.audioapi
 
+import androidx.annotation.RequiresPermission
 import com.facebook.jni.HybridData
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.LifecycleEventListener
@@ -149,6 +150,7 @@ class AudioAPIModule(
   }
 
   // Notification system methods
+  @RequiresPermission(android.Manifest.permission.POST_NOTIFICATIONS)
   override fun showNotification(
     type: String?,
     key: String?,

package/common/cpp/audioapi/HostObjects/AudioNodeHostObject.cpp

@@ -19,6 +19,12 @@ AudioNodeHostObject::AudioNodeHostObject(const std::shared_ptr<AudioNode> &node)
       JSI_EXPORT_FUNCTION(AudioNodeHostObject, disconnect));
 }
 
+// Explicitly define destructor here, as they to exist in order to act as a
+// "key function" for the audio classes - this allow for RTTI to work
+// properly across dynamic library boundaries (i.e. dynamic_cast that is used by
+// isHostObject method), android specific issue
+AudioNodeHostObject::~AudioNodeHostObject() = default;
+
 JSI_PROPERTY_GETTER_IMPL(AudioNodeHostObject, numberOfInputs) {
   return {node_->getNumberOfInputs()};
 }

package/common/cpp/audioapi/HostObjects/AudioNodeHostObject.h

@@ -14,6 +14,7 @@ class AudioNode;
 class AudioNodeHostObject : public JsiHostObject {
  public:
   explicit AudioNodeHostObject(const std::shared_ptr<AudioNode> &node);
+  ~AudioNodeHostObject() override;
 
   JSI_PROPERTY_GETTER_DECL(numberOfInputs);
   JSI_PROPERTY_GETTER_DECL(numberOfOutputs);

package/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp

@@ -62,6 +62,12 @@ BaseAudioContextHostObject::BaseAudioContextHostObject(
       JSI_EXPORT_FUNCTION(BaseAudioContextHostObject, createWaveShaper));
 }
 
+// Explicitly define destructors here, as they to exist in order to act as a
+// "key function" for the audio classes - this allow for RTTI to work
+// properly across dynamic library boundaries (i.e. dynamic_cast that is used by
+// isHostObject method), android specific issue
+BaseAudioContextHostObject::~BaseAudioContextHostObject() = default;
+
 JSI_PROPERTY_GETTER_IMPL(BaseAudioContextHostObject, destination) {
   auto destination = std::make_shared<AudioDestinationNodeHostObject>(context_->getDestination());
   return jsi::Object::createFromHostObject(runtime, destination);

package/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.h

@@ -21,6 +21,8 @@ class BaseAudioContextHostObject : public JsiHostObject {
       jsi::Runtime *runtime,
       const std::shared_ptr<react::CallInvoker> &callInvoker);
 
+  ~BaseAudioContextHostObject() override;
+
   JSI_PROPERTY_GETTER_DECL(destination);
   JSI_PROPERTY_GETTER_DECL(state);
   JSI_PROPERTY_GETTER_DECL(sampleRate);

package/common/cpp/audioapi/HostObjects/inputs/AudioRecorderHostObject.cpp

@@ -41,7 +41,8 @@ AudioRecorderHostObject::AudioRecorderHostObject(
 }
 
 JSI_HOST_FUNCTION_IMPL(AudioRecorderHostObject, start) {
-  auto result = audioRecorder_->start();
+  auto fileNameOverride = count > 0 ? args[0].getString(runtime).utf8(runtime) : "";
+  auto result = audioRecorder_->start(fileNameOverride);
   auto jsResult = jsi::Object(runtime);
 
   jsResult.setProperty(

package/common/cpp/audioapi/core/inputs/AudioRecorder.h

@@ -25,7 +25,7 @@ class AudioRecorder {
       : audioEventHandlerRegistry_(audioEventHandlerRegistry) {}
   virtual ~AudioRecorder() = default;
 
-  virtual Result<std::string, std::string> start() = 0;
+  virtual Result<std::string, std::string> start(const std::string &fileNameOverride) = 0;
   virtual Result<std::tuple<std::string, double, double>, std::string> stop() = 0;
 
   virtual Result<std::string, std::string> enableFileOutput(

package/ios/audioapi/ios/AudioAPIModule.mm

@@ -123,7 +123,28 @@ RCT_EXPORT_METHOD(
         resolve reject : (RCTPromiseRejectBlock)reject)
 {
   dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
-    auto success = [self.audioSessionManager setActive:enabled];
+    NSError *error = nil;
+
+    auto success = [self.audioSessionManager setActive:enabled error:&error];
+
+    if (!success) {
+      NSDictionary *meta = @{
+        @"nativeCode" : @(error.code),
+        @"nativeDomain" : error.domain ?: @"",
+        @"nativeDesc" : error.description ?: @"",
+      };
+
+      NSError *jsError =
+          [NSError errorWithDomain:@"AudioAPIModule"
+                              code:error.code
+                          userInfo:@{
+                            NSLocalizedDescriptionKey : @"Failed to set audio session active state",
+                            @"meta" : meta,
+                          }];
+
+      reject(@"E_AUDIO_SESSION", @"Failed to set audio session active state", jsError);
+      return;
+    }
 
     resolve(@(success));
   });

package/ios/audioapi/ios/core/IOSAudioRecorder.h

@@ -27,7 +27,7 @@ class IOSAudioRecorder : public AudioRecorder {
   IOSAudioRecorder(const std::shared_ptr<AudioEventHandlerRegistry> &audioEventHandlerRegistry);
   ~IOSAudioRecorder() override;
 
-  Result<std::string, std::string> start() override;
+  Result<std::string, std::string> start(const std::string &fileNameOverride = "") override;
   Result<std::tuple<std::string, double, double>, std::string> stop() override;
 
   Result<std::string, std::string> enableFileOutput(

package/ios/audioapi/ios/core/IOSAudioRecorder.mm

@@ -71,7 +71,7 @@ IOSAudioRecorder::~IOSAudioRecorder()
 /// @brief Starts the audio recording process and prepares necessary resources.
 /// This method should be called from the JS thread only.
 /// @returns Result containing the file path if recording started successfully, or an error message.
-Result<std::string, std::string> IOSAudioRecorder::start()
+Result<std::string, std::string> IOSAudioRecorder::start(const std::string &fileNameOverride)
 {
   if (!isIdle()) {
     return Result<std::string, std::string>::Err("Recorder is already recording");
@@ -104,7 +104,7 @@ Result<std::string, std::string> IOSAudioRecorder::start()
 
   if (usesFileOutput()) {
     auto fileResult = std::static_pointer_cast<IOSFileWriter>(fileWriter_)
-                          ->openFile(inputFormat, maxInputBufferLength);
+                          ->openFile(inputFormat, maxInputBufferLength, fileNameOverride);
 
     if (fileResult.is_err()) {
       return Result<std::string, std::string>::Err(
@@ -191,8 +191,9 @@ Result<std::string, std::string> IOSAudioRecorder::enableFileOutput(
   fileWriter_ = std::make_shared<IOSFileWriter>(audioEventHandlerRegistry_, properties);
 
   if (!isIdle()) {
-    auto result = std::static_pointer_cast<IOSFileWriter>(fileWriter_)
-                      ->openFile([nativeRecorder_ getInputFormat], [nativeRecorder_ getBufferSize]);
+    auto result =
+        std::static_pointer_cast<IOSFileWriter>(fileWriter_)
+            ->openFile([nativeRecorder_ getInputFormat], [nativeRecorder_ getBufferSize], "");
 
     if (result.is_err()) {
       return Result<std::string, std::string>::Err(

package/ios/audioapi/ios/core/utils/FileOptions.h

@@ -22,7 +22,9 @@ NSInteger getBitDepth(const std::shared_ptr<AudioFileProperties> &properties);
 float getSampleRate(const std::shared_ptr<AudioFileProperties> &properties);
 
 NSDictionary *getFileSettings(const std::shared_ptr<AudioFileProperties> &properties);
-NSURL *getFileURL(const std::shared_ptr<AudioFileProperties> &properties);
+NSURL *getFileURL(
+    const std::shared_ptr<AudioFileProperties> &properties,
+    const std::string &fileNameOverride);
 NSSearchPathDirectory getDirectory(const std::shared_ptr<AudioFileProperties> &properties);
 
 NSString *getDateString();

package/ios/audioapi/ios/core/utils/FileOptions.mm

@@ -139,7 +139,9 @@ NSDictionary *getFileSettings(const std::shared_ptr<AudioFileProperties> &proper
   return settings;
 }
 
-NSURL *getFileURL(const std::shared_ptr<AudioFileProperties> &properties)
+NSURL *getFileURL(
+    const std::shared_ptr<AudioFileProperties> &properties,
+    const std::string &fileNameOverride)
 {
   NSError *error = nil;
 
@@ -164,8 +166,12 @@ NSURL *getFileURL(const std::shared_ptr<AudioFileProperties> &properties)
   NSString *timestamp = getTimestampString();
   NSString *fileExtension = getFileExtension(properties);
 
-  NSString *fileName =
-      [NSString stringWithFormat:@"%@_%@.%@", fileNamePrefix, timestamp, fileExtension];
+  NSString *fileName = fileNameOverride.length() > 0
+      ? [NSString stringWithFormat:@"%@.%@",
+                                   [NSString stringWithUTF8String:fileNameOverride.c_str()],
+                                   fileExtension]
+      : [NSString stringWithFormat:@"%@_%@.%@", fileNamePrefix, timestamp, fileExtension];
+
   return [directoryURL URLByAppendingPathComponent:fileName];
 }
 

package/ios/audioapi/ios/core/utils/IOSFileWriter.h

@@ -29,7 +29,8 @@ class IOSFileWriter : public AudioFileWriter {
 
   Result<std::string, std::string> openFile(
       AVAudioFormat *bufferFormat,
-      size_t maxInputBufferLength);
+      size_t maxInputBufferLength,
+      const std::string &fileNameOverride);
   Result<std::tuple<double, double>, std::string> closeFile() override;
 
   bool writeAudioData(const AudioBufferList *audioBufferList, int numFrames);

package/ios/audioapi/ios/core/utils/IOSFileWriter.mm

@@ -32,7 +32,10 @@ IOSFileWriter::~IOSFileWriter()
 /// @param bufferFormat The audio format of the input buffer.
 /// @param maxInputBufferLength The maximum length of the input buffer in frames.
 /// @returns An OpenFileResult indicating success with the file path or an error message.
-OpenFileResult IOSFileWriter::openFile(AVAudioFormat *bufferFormat, size_t maxInputBufferLength)
+OpenFileResult IOSFileWriter::openFile(
+    AVAudioFormat *bufferFormat,
+    size_t maxInputBufferLength,
+    const std::string &fileNameOverride)
 {
   @autoreleasepool {
     if (audioFile_ != nil) {
@@ -44,7 +47,7 @@ OpenFileResult IOSFileWriter::openFile(AVAudioFormat *bufferFormat, size_t maxIn
 
     NSError *error = nil;
     NSDictionary *settings = ios::fileoptions::getFileSettings(fileProperties_);
-    fileURL_ = ios::fileoptions::getFileURL(fileProperties_);
+    fileURL_ = ios::fileoptions::getFileURL(fileProperties_, fileNameOverride);
 
     if (fileProperties_->sampleRate == 0 || fileProperties_->channelCount == 0) {
       return OpenFileResult::Err(

package/ios/audioapi/ios/system/AudioEngine.mm

@@ -38,7 +38,7 @@ static AudioEngine *_sharedInstance = nil;
   self.sourceFormats = nil;
   self.inputNode = nil;
 
-  [self.sessionManager setActive:false];
+  [self.sessionManager setActive:false error:nil];
   self.sessionManager = nil;
 }
 
@@ -182,7 +182,9 @@ static AudioEngine *_sharedInstance = nil;
     return true;
   }
 
-  if (![self.sessionManager setActive:true]) {
+  if (![self.sessionManager setActive:true error:&error]) {
+    // TODO: return user facing error
+    NSLog(@"Error while activating audio session: %@", [error debugDescription]);
     return false;
   }
 

package/ios/audioapi/ios/system/AudioSessionManager.h

@@ -28,7 +28,7 @@
                        options:(NSArray *)options
                   allowHaptics:(BOOL)allowHaptics;
 
-- (bool)setActive:(bool)active;
+- (bool)setActive:(bool)active error:(NSError **)error;
 - (void)markInactive;
 - (void)disableSessionManagement;
 

package/ios/audioapi/ios/system/AudioSessionManager.mm

@@ -109,15 +109,14 @@ static AudioSessionManager *_sharedInstance = nil;
   }
 }
 
-- (bool)setActive:(bool)active
+- (bool)setActive:(bool)active error:(NSError **)error
 {
+  bool success = false;
+
   if (!self.shouldManageSession) {
     return true;
   }
 
-  NSError *error = nil;
-  bool success = false;
-
   if (self.isActive == active) {
     return true;
   }
@@ -130,18 +129,12 @@ static AudioSessionManager *_sharedInstance = nil;
     }
   }
 
-  success = [self.audioSession setActive:active error:&error];
+  success = [self.audioSession setActive:active error:error];
 
   if (success) {
     self.isActive = active;
   }
 
-  if (error != nil) {
-    NSLog(@"[AudioSessionManager] setting session as %@ failed", active ? @"ACTIVE" : @"INACTIVE");
-  } else {
-    NSLog(@"[AudioSessionManager] session is %@", active ? @"ACTIVE" : @"INACTIVE");
-  }
-
   return success;
 }