software-mansion · poneciak57 · Mar 19, 2026 · Mar 19, 2026 · Mar 20, 2026 · Mar 23, 2026
diff --git a/apps/common-app/src/demos/PedalBoard/PedalBoard.tsx b/apps/common-app/src/demos/PedalBoard/PedalBoard.tsx
@@ -3,7 +3,6 @@ import {
   AudioBufferSourceNode,
   AudioBuffer,
   GainNode,
-  RecorderAdapterNode,
   AudioRecorder,
   AudioManager
 } from 'react-native-audio-api';
@@ -31,7 +30,7 @@ export default function PedalBoard() {
   const [isLoading, setIsLoading] = useState(false);
   const [audioBuffer, setAudioBuffer] = useState<AudioBuffer | null>(null);
 
-  const sourceNodeRef = useRef<AudioBufferSourceNode | RecorderAdapterNode>(null);
+  const sourceNodeRef = useRef<AudioBufferSourceNode | AudioRecorder>(null);
   const recorderRef = useRef<AudioRecorder | null>(null);
   const pedalInputNodesRef = useRef<GainNode[]>([]);
   const pedalOutputNodesRef = useRef<GainNode[]>([]);
@@ -84,7 +83,11 @@ export default function PedalBoard() {
       return;
     }
     const sourceNode = sourceNodeRef.current;
-    sourceNode.connect(pedalInputNodesRef.current[0]);
+    if (sourceNode instanceof AudioRecorder) {
+      sourceNode.connect(audioContext, pedalInputNodesRef.current[0]);
+    } else {
+      sourceNode.connect(pedalInputNodesRef.current[0]);
+    }
     for (let i = 0; i < PEDALS.length; i++) {
       pedalInputNodesRef.current[i].connect(pedalOutputNodesRef.current[i]);
     }
@@ -123,11 +126,9 @@ export default function PedalBoard() {
       }
       if (permissionsGranted) {
         const recorder = new AudioRecorder();
-        const adapter = audioContext.createRecorderAdapter();
-        recorder.connect(adapter);
+        sourceNodeRef.current = recorder;
         recorderRef.current = recorder;
-        sourceNodeRef.current = adapter;
-        sourceNodeRef.current.connect(pedalInputNodesRef.current[0]);
+        recorder.connect(audioContext, pedalInputNodesRef.current[0]);
         if (audioContext.state === 'suspended') {
           audioContext.resume();
         }

diff --git a/apps/common-app/src/demos/PedalBoard/ReverbPedal.tsx b/apps/common-app/src/demos/PedalBoard/ReverbPedal.tsx
@@ -47,7 +47,7 @@ export default function ReverbPedal({
     } else if (level < 0.66) {
       desiredDuration = 0.7;
     } else {
-      desiredDuration = 1;
+      desiredDuration = 5;
     }
     if (convolverNodeRef.current?.buffer) {
       if (convolverNodeRef.current.buffer.duration === desiredDuration) {

diff --git a/apps/common-app/src/examples/AudioFile/AudioPlayer.ts b/apps/common-app/src/examples/AudioFile/AudioPlayer.ts
@@ -50,6 +50,10 @@ class AudioPlayer {
     });
     this.sourceNode.buffer = this.audioBuffer;
     this.sourceNode.playbackRate.value = this.playbackRate;
+    const volume1 = this.audioContext.createGain();
+    const volume2 = this.audioContext.createGain();
+    volume1.gain.value = 0.5;
+    volume2.gain.value = 0.5;
     this.volumeNode = this.audioContext.createGain();
     this.volumeNode.gain.value = this.volume;
 

diff --git a/apps/common-app/src/examples/Record/Record.tsx b/apps/common-app/src/examples/Record/Record.tsx
@@ -71,9 +71,7 @@ const Record: FC = () => {
       return;
     }
 
-    const adapter = audioContext.createRecorderAdapter();
-    adapter.connect(audioContext.destination);
-    audioRecorder.connect(adapter);
+    audioRecorder.connect(audioContext, audioContext.destination);
 
     const result = audioRecorder.start();
 

diff --git a/packages/audiodocs/docs/core/base-audio-context.mdx b/packages/audiodocs/docs/core/base-audio-context.mdx
@@ -158,7 +158,11 @@ Creates [`PeriodicWave`](/docs/effects/periodic-wave). This waveform specifies a
 
 ### `createRecorderAdapter`
 
-Creates [`RecorderAdapterNode`](/docs/sources/recorder-adapter-node).
+Creates a `RecorderAdapterNode` — an [`AudioNode`](/docs/core/audio-node) that
+adapts an [`AudioRecorder`](/docs/inputs/audio-recorder) into the audio graph.
+Feed it using [`AudioRecorder.connect`](/docs/inputs/audio-recorder#connect) and
+connect it downstream like any other node. Produces silence until a recorder is
+connected to it.
 
 #### Returns `RecorderAdapterNode`
 

diff --git a/packages/audiodocs/docs/guides/create-your-own-effect.mdx b/packages/audiodocs/docs/guides/create-your-own-effect.mdx
@@ -52,9 +52,7 @@ public:
   explicit MyProcessorNode(const std::shared_ptr<BaseAudioContext> &context);
 
 protected:
-  std::shared_ptr<DSPAudioBuffer>
-  processNode(const std::shared_ptr<DSPAudioBuffer> &buffer,
-              int framesToProcess) override;
+  void processNode(int framesToProcess) override;
 
 // highlight-start
 private:
@@ -79,14 +77,11 @@ private:
 namespace audioapi {
     MyProcessorNode::MyProcessorNode(const std::shared_ptr<BaseAudioContext> &context)
         //highlight-next-line
-        : AudioNode(context), gain(0.5) {
-        isInitialized_.store(true, std::memory_order_release);
-    }
+        : AudioNode(context), gain(0.5) {}
 
-    std::shared_ptr<DSPAudioBuffer> MyProcessorNode::processNode(const std::shared_ptr<DSPAudioBuffer> &buffer,
-                                    int framesToProcess) {
+    void MyProcessorNode::processNode(int framesToProcess) {
       // highlight-start
-      for (int channel = 0; channel < buffer->getNumberOfChannels(); ++channel) {
+      for (int channel = 0; channel < audioBuffer_->getNumberOfChannels(); ++channel) {
         auto *audioArray = bus->getChannel(channel);
         for (size_t i = 0; i < framesToProcess; ++i) {
           // Apply gain to each sample in the audio array

diff --git a/packages/audiodocs/docs/inputs/audio-recorder.mdx b/packages/audiodocs/docs/inputs/audio-recorder.mdx
@@ -303,9 +303,7 @@ const MyRecorder: React.FC = () => {
       return;
     }
 
-    const adapter = audioContext.createRecorderAdapter();
-    adapter.connect(audioContext.destination);
-    audioRecorder.connect(adapter);
+    audioRecorder.connect(audioContext, audioContext.destination);
 
     if (audioContext.state === 'suspended') {
       await audioContext.resume();
@@ -638,11 +636,19 @@ export default MyRecorder;
       </div></td>
       <td>
         <div class="text-content">
-          Connects AudioRecorder with [RecorderAdapterNode](/docs/sources/recorder-adapter-node) instance that can be used for further audio processing.
+          Routes captured audio into an audio graph. Two forms are supported:
+
+          1. `connect(adapter)` — connects the recorder to an adapter node you created yourself with `audioContext.createRecorderAdapter()`. Each adapter can only be connected once.
+          2. `connect(context, destination)` — convenience form that creates the adapter node internally, wires the recorder to it, connects it to `destination`, and returns the adapter so you can `disconnect()` it later if needed.
         </div>
         ```tsx
+          // Form 1: explicit adapter
           const adapter = audioContext.createRecorderAdapter();
           audioRecorder.connect(adapter);
+          adapter.connect(audioContext.destination);
+
+          // Form 2: convenience — adapter created under the hood
+          const adapter = audioRecorder.connect(audioContext, audioContext.destination);
         ```
       </td>
     </tr>

diff --git a/packages/audiodocs/docs/other/testing.mdx b/packages/audiodocs/docs/other/testing.mdx
@@ -1,5 +1,3 @@
-
-
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
@@ -99,13 +97,6 @@ describe('Audio Recording Tests', () => {
 
     expect(result.status).toBe('success');
 
-    // Set up recording chain
-    const oscillator = context.createOscillator();
-    const recorderAdapter = context.createRecorderAdapter();
-
-    oscillator.connect(recorderAdapter);
-    recorder.connect(recorderAdapter);
-
     // Test recording workflow
     const startResult = recorder.start();
     expect(startResult.status).toBe('success');

diff --git a/packages/audiodocs/docs/sources/recorder-adapter-node.mdx b/packages/audiodocs/docs/sources/recorder-adapter-node.mdx
diff --git a/packages/audiodocs/docs/worklets/worklet-node.mdx b/packages/audiodocs/docs/worklets/worklet-node.mdx
@@ -51,15 +51,14 @@ async function App() {
         // !VERY IMPORTANT: please read the Known Issue section below
     };
     const workletNode = audioContext.createWorkletNode(worklet, 1024, 2, 'UIRuntime');
-    const adapterNode = audioContext.createRecorderAdapter();
 
     const canSetAudioSessionActivity = await AudioManager.setAudioSessionActivity(true);
     if (!canSetAudioSessionActivity) {
         throw new Error("Could not activate the audio session");
     }
-    adapterNode.connect(workletNode);
-    workletNode.connect(audioContext.destination);
-    recorder.connect(adapterNode);
+    recorder
+      .connect(audioContext, workletNode)
+      .connect(audioContext.destination);
     recorder.start();
     audioContext.resume();
 }

diff --git a/packages/audiodocs/docs/worklets/worklet-processing-node.mdx b/packages/audiodocs/docs/worklets/worklet-processing-node.mdx
@@ -70,14 +70,12 @@ function App() {
         gainWorklet,
         'AudioRuntime'
     );
-    const adapterNode = audioContext.createRecorderAdapter();
 
-    adapterNode.connect(workletProcessingNode);
-    workletProcessingNode.connect(audioContext.destination);
-    recorder.connect(adapterNode);
+    recorder
+      .connect(audioContext, workletProcessingNode)
+      .connect(audioContext.destination);
     recorder.start();
 }
-}
 ```
 
 ## Worklet Parameters Explanation

diff --git a/packages/custom-node-generator/templates/basic/shared/MyProcessorNode.cpp b/packages/custom-node-generator/templates/basic/shared/MyProcessorNode.cpp
@@ -3,13 +3,9 @@
 namespace audioapi {
 MyProcessorNode::MyProcessorNode(
     const std::shared_ptr<BaseAudioContext> &context)
-    : AudioNode(context) {
-  isInitialized_.store(true, std::memory_order_release);
-}
+    : AudioNode(context) {}
 
-std::shared_ptr<DSPAudioBuffer>
-MyProcessorNode::processNode(const std::shared_ptr<DSPAudioBuffer> &buffer,
-                             int framesToProcess) {
+void MyProcessorNode::processNode(int framesToProcess) {
   // put your processing logic here
 }
 } // namespace audioapi
diff --git a/packages/custom-node-generator/templates/basic/shared/MyProcessorNode.h b/packages/custom-node-generator/templates/basic/shared/MyProcessorNode.h
@@ -10,8 +10,6 @@ class MyProcessorNode : public AudioNode {
   explicit MyProcessorNode(const std::shared_ptr<BaseAudioContext> &context);
 
 protected:
-  std::shared_ptr<DSPAudioBuffer>
-  processNode(const std::shared_ptr<DSPAudioBuffer> &buffer,
-              int framesToProcess) override;
+  void processNode(int framesToProcess) override;
 };
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/RNAudioAPI.podspec b/packages/react-native-audio-api/RNAudioAPI.podspec
@@ -32,7 +32,7 @@ Pod::Spec.new do |s|
   s.source       = { :git => "https://github.com/software-mansion/react-native-audio-api.git", :tag => "#{s.version}" }
 
   s.subspec "audioapi" do |ss|
-    ss.source_files = "common/cpp/audioapi/**/*.{cpp,c,h,hpp}"
+    ss.source_files = "common/cpp/audioapi/**/*.{cpp,c,h,hpp}", "common/cpp/test/src/graph/AudioThreadGuard.cpp"
     ss.exclude_files = $RN_AUDIO_API_FFMPEG_DISABLED ? ["common/cpp/audioapi/libs/ffmpeg/**"] : []
     ss.header_dir = "audioapi"
     ss.header_mappings_dir = "common/cpp/audioapi"
@@ -103,6 +103,7 @@ Pod::Spec.new do |s|
     .join(' '),
     "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
     "GCC_PREPROCESSOR_DEFINITIONS" => '$(inherited) HAVE_ACCELERATE=1',
+    "GCC_PREPROCESSOR_DEFINITIONS[config=Debug]" => '$(inherited) HAVE_ACCELERATE=1 DEBUG=1',
     'OTHER_CFLAGS' => "$(inherited) #{fabric_flags} #{version_flag} #{worklets_preprocessor_flag} #{ffmpeg_flag} #{static_external_libs_flag}",
   }
 

diff --git a/packages/react-native-audio-api/android/src/main/cpp/audioapi/CMakeLists.txt b/packages/react-native-audio-api/android/src/main/cpp/audioapi/CMakeLists.txt
@@ -146,6 +146,11 @@ if (RN_AUDIO_API_FFMPEG_DISABLED)
   )
 endif()
 
+target_compile_definitions(
+  react-native-audio-api
+  PRIVATE $<$<CONFIG:Debug>:DEBUG>
+)
+
 if (RN_AUDIO_API_STATIC_EXTERNAL_LIBS_DISABLED)
   target_compile_definitions(
     react-native-audio-api

diff --git a/...eact-native-audio-api/android/src/main/cpp/audioapi/android/core/AndroidAudioRecorder.cpp b/...eact-native-audio-api/android/src/main/cpp/audioapi/android/core/AndroidAudioRecorder.cpp
@@ -445,7 +445,7 @@ void AndroidAudioRecorder::clearOnAudioReadyCallback() {
 /// If the recorder is already active, it will initialize the adapter node immediately.
 /// This method should be called from the JS thread only.
 /// @param node Shared pointer to the RecorderAdapterNode to connect.
-void AndroidAudioRecorder::connect(const std::shared_ptr<RecorderAdapterNode> &node) {
+void AndroidAudioRecorder::connect(const std::shared_ptr<utils::graph::NodeHandle> &node) {
   std::scoped_lock adapterLock(adapterNodeMutex_);
   adapterNode_ = node;
   isConnected_.store(true, std::memory_order_release);

diff --git a/.../react-native-audio-api/android/src/main/cpp/audioapi/android/core/AndroidAudioRecorder.h b/.../react-native-audio-api/android/src/main/cpp/audioapi/android/core/AndroidAudioRecorder.h
@@ -44,7 +44,7 @@ class AndroidAudioRecorder : public oboe::AudioStreamCallback, public AudioRecor
       uint64_t callbackId) override;
   void clearOnAudioReadyCallback() override;
 
-  void connect(const std::shared_ptr<RecorderAdapterNode> &node) override;
+  void connect(const std::shared_ptr<utils::graph::NodeHandle> &node) override;
   void disconnect() override;
 
   oboe::DataCallbackResult

diff --git a/packages/react-native-audio-api/android/src/main/cpp/audioapi/android/core/AudioPlayer.cpp b/packages/react-native-audio-api/android/src/main/cpp/audioapi/android/core/AudioPlayer.cpp
@@ -12,14 +12,11 @@
 namespace audioapi {
 
 AudioPlayer::AudioPlayer(
-    const std::function<void(std::shared_ptr<DSPAudioBuffer>, int)> &renderAudio,
+    const std::function<void(DSPAudioBuffer *, int)> &renderAudio,
     float sampleRate,
     int channelCount)
-    : renderAudio_(renderAudio),
-      sampleRate_(sampleRate),
-      channelCount_(channelCount),
-      isRunning_(false) {
-  isInitialized_ = openAudioStream();
+    : renderAudio_(renderAudio), sampleRate_(sampleRate), channelCount_(channelCount) {
+  isInitialized_.store(openAudioStream(), std::memory_order_release);
 }
 
 bool AudioPlayer::openAudioStream() {
@@ -86,7 +83,7 @@ void AudioPlayer::suspend() {
 }
 
 void AudioPlayer::cleanup() {
-  isInitialized_ = false;
+  isInitialized_.store(false, std::memory_order_release);
 
   if (mStream_ != nullptr) {
     mStream_->close();
@@ -101,7 +98,7 @@ bool AudioPlayer::isRunning() const {
 
 DataCallbackResult
 AudioPlayer::onAudioReady(AudioStream *oboeStream, void *audioData, int32_t numFrames) {
-  if (!isInitialized_) {
+  if (!isInitialized_.load(std::memory_order_acquire)) {
     return DataCallbackResult::Continue;
   }
 
@@ -112,7 +109,7 @@ AudioPlayer::onAudioReady(AudioStream *oboeStream, void *audioData, int32_t numF
     auto framesToProcess = std::min(numFrames - processedFrames, RENDER_QUANTUM_SIZE);
 
     if (isRunning_.load(std::memory_order_acquire)) {
-      renderAudio_(buffer_, framesToProcess);
+      renderAudio_(buffer_.get(), framesToProcess);
     } else {
       buffer_->zero();
     }
@@ -130,7 +127,7 @@ void AudioPlayer::onErrorAfterClose(oboe::AudioStream *stream, oboe::Result erro
   if (error == oboe::Result::ErrorDisconnected) {
     cleanup();
     if (openAudioStream()) {
-      isInitialized_ = true;
+      isInitialized_.store(true, std::memory_order_release);
       resume();
     }
   }