react-native-audio-api 0.11.0-alpha.1 → 0.11.0-nightly-bfab178-20251107

package/README.md

@@ -19,19 +19,8 @@ check out the [Getting Started](https://docs.swmansion.com/react-native-audio-ap
 
 ### Planned
 
-### <img src="https://img.shields.io/badge/Coming_in-0.9.0-orange" />
-
-- **JS Audio Worklets V1 🐎**<br />
-  Receive events and data callbacks from audio thread to synchronize with UI on UI thread.
-
 ### <img src="https://img.shields.io/badge/Coming_in-x.x.x-orange" />
 
-- **Convolver Node 🐐**<br />
-  Realistic reverb and spatial effects in the browser by applying impulse responses. It makes audio sound like it’s being played in real spaces, from small rooms to cathedrals, or through hardware like amps and speakers
-
-- **Decoding and utility modules 🔧**<br />
-  Decode and modify audio data without the need to create AudioContext first through a set of utility classes
-
 - **DynamicCompressorNode 〽️**<br />
   Reduce the volume of loud sounds and boost quieter nodes to balance the audio signal, avoid clipping or distorted sounds
 
@@ -47,9 +36,22 @@ 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.10.0"><img src="https://img.shields.io/badge/Released_in-0.10.0-green" /></a>
+
+- **Decoding and utility modules 🔧**<br />
+  Decode and modify audio data without the need to create AudioContext first through a set of utility classes
+
+- **Convolver Node 🐐**<br />
+  Realistic reverb and spatial effects in the browser by applying impulse responses. It makes audio sound like it’s being played in real spaces, from small rooms to cathedrals, or through hardware like amps and speakers
+
 - **JS Audio Worklets V2 🐎**<br />
   Customize the process pipeline with JS functions running on audio thread.
 
+### <a href="https://github.com/software-mansion/react-native-audio-api/releases/tag/0.9.0"><img src="https://img.shields.io/badge/Released_in-0.9.0-green" /></a>
+
+- **JS Audio Worklets V1 🐎**<br />
+  Receive events and data callbacks from audio thread to synchronize with UI on UI thread.
+
 ### <a href="https://github.com/software-mansion/react-native-audio-api/releases/tag/0.8.0"><img src="https://img.shields.io/badge/Released_in-0.8.0-green" /></a>
 
 - **Decoding support for m4a/mp4/aac/ogg/opus 📁** <br />

package/RNAudioAPI.podspec

@@ -1,4 +1,5 @@
 require "json"
+require_relative './scripts/rnaa_utils'
 
 package_json = JSON.parse(File.read(File.join(__dir__, "package.json")))
 
@@ -8,6 +9,8 @@ folly_flags = "-DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-
 fabric_flags = $new_arch_enabled ? '-DRCT_NEW_ARCH_ENABLED' : ''
 version_flag = "-DAUDIOAPI_VERSION=#{package_json['version']}"
 
+worklets_preprocessor_flag = check_if_worklets_enabled() ? '-DRN_AUDIO_API_ENABLE_WORKLETS=1' : ''
+
 Pod::Spec.new do |s|
   s.name         = "RNAudioAPI"
   s.version      = package_json["version"]
@@ -29,15 +32,23 @@ Pod::Spec.new do |s|
       sss.header_dir = "audioapi"
       sss.header_mappings_dir = "ios/audioapi"
     end
+
+    ss.subspec "audioapi_dsp" do |sss|
+      sss.source_files = "common/cpp/audioapi/dsp/**/*.{cpp}"
+      sss.header_dir = "audioapi/dsp"
+      sss.header_mappings_dir = "common/cpp/audioapi/dsp"
+      sss.compiler_flags = "-O3"
+    end
   end
 
   s.ios.frameworks = 'CoreFoundation', 'CoreAudio', 'AudioToolbox', 'Accelerate', 'MediaPlayer', 'AVFoundation'
 
   s.compiler_flags = "#{folly_flags}"
 
-  # s.prepare_command = <<-CMD TODO: re-add when we have prebuilt libs put somewhere public
-  #   ruby -r './scripts/download-audioapi-libs.rb'
-  # CMD
+  s.prepare_command = <<-CMD
+    chmod +x scripts/download-prebuilt-binaries.sh
+    scripts/download-prebuilt-binaries.sh ios
+  CMD
 
   # Assumes Pods dir is nested under ios project dir
   ios_dir = File.join(Pod::Config.instance.project_pods_root, '..')
@@ -46,13 +57,11 @@ Pod::Spec.new do |s|
   external_dir_relative = "common/cpp/audioapi/external"
   lib_dir = "$(PROJECT_DIR)/#{rn_audio_dir_relative}/#{external_dir_relative}/$(PLATFORM_NAME)"
 
-  external_dir = File.join(__dir__, "common/cpp/audioapi/external")
-
   s.ios.vendored_frameworks = [
-    'common/cpp/audioapi/external/libavcodec.xcframework',
-    'common/cpp/audioapi/external/libavformat.xcframework',
-    'common/cpp/audioapi/external/libavutil.xcframework',
-    'common/cpp/audioapi/external/libswresample.xcframework'
+    'common/cpp/audioapi/external/ffmpeg_ios/libavcodec.xcframework',
+    'common/cpp/audioapi/external/ffmpeg_ios/libavformat.xcframework',
+    'common/cpp/audioapi/external/ffmpeg_ios/libavutil.xcframework',
+    'common/cpp/audioapi/external/ffmpeg_ios/libswresample.xcframework'
   ]
 s.pod_target_xcconfig = {
   "USE_HEADERMAP" => "YES",
@@ -68,8 +77,8 @@ s.pod_target_xcconfig = {
     $(PODS_TARGET_SRCROOT)/#{external_dir_relative}/include/vorbis
     $(PODS_TARGET_SRCROOT)/#{external_dir_relative}/ffmpeg_include
   ].join(" "),
-  'OTHER_CFLAGS' => "$(inherited) #{folly_flags} #{fabric_flags} #{version_flag}",
-  'OTHER_CPLUSPLUSFLAGS' => "$(inherited) #{folly_flags} #{fabric_flags} #{version_flag}"
+  'OTHER_CFLAGS' => "$(inherited) #{folly_flags} #{fabric_flags} #{version_flag} #{worklets_preprocessor_flag}",
+  'OTHER_CPLUSPLUSFLAGS' => "$(inherited) #{folly_flags} #{fabric_flags} #{version_flag} #{worklets_preprocessor_flag}",
 }
 
 s.user_target_xcconfig = {
@@ -88,10 +97,6 @@ s.user_target_xcconfig = {
     $(inherited)
     $(PODS_ROOT)/Headers/Public/RNAudioAPI
     $(PODS_TARGET_SRCROOT)/common/cpp
-    #{external_dir}/include
-    #{external_dir}/include/opus
-    #{external_dir}/include/vorbis
-    #{external_dir}/ffmpeg_include
   ].join(' ')
 }
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.

package/android/build.gradle

@@ -74,6 +74,30 @@ def resolveReactNativeWorkletsDirectory() {
   return null;
 }
 
+def validateWorkletsVersion() {
+  def validationScript = file("${projectDir}/../scripts/validate-worklets-version.js")
+  if (!validationScript.exists()) {
+    logger.error("[AudioAPI] Worklets validation script not found at ${validationScript.absolutePath}")
+    return false
+  }
+
+  try {
+    def process = ["node", validationScript.absolutePath].execute()
+    process.waitForProcessOutput(System.out, System.err)
+    def exitCode = process.exitValue()
+
+    if (exitCode == 0) {
+      return true
+    } else {
+      logger.warn("[AudioAPI] Worklets version validation failed")
+      return false
+    }
+  } catch (Exception e) {
+    logger.error("[AudioAPI] Failed to validate worklets version: ${e.message}")
+    return false
+  }
+}
+
 def toPlatformFileString(String path) {
   if (Os.isFamily(Os.FAMILY_WINDOWS)) {
       path = path.replace(File.separatorChar, '/' as char)
@@ -92,7 +116,7 @@ static def supportsNamespace() {
 
 def reactNativeRootDir = resolveReactNativeDirectory()
 def reactNativeWorkletsRootDir = resolveReactNativeWorkletsDirectory()
-def isWorkletsAvailable = reactNativeWorkletsRootDir != null
+def isWorkletsAvailable = reactNativeWorkletsRootDir != null && validateWorkletsVersion()
 
 def reactProperties = new Properties()
 file("$reactNativeRootDir/ReactAndroid/gradle.properties").withInputStream { reactProperties.load(it) }
@@ -123,7 +147,7 @@ android {
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
-    
+
     buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
     buildConfigField "boolean", "RN_AUDIO_API_ENABLE_WORKLETS", "${isWorkletsAvailable}"
 
@@ -277,10 +301,16 @@ def assertMinimalReactNativeVersion = task assertMinimalReactNativeVersionTask {
     }
 }
 
+task downloadPrebuiltBinaries(type: Exec) {
+  commandLine 'chmod', '+x', '../scripts/download-prebuilt-binaries.sh'
+  commandLine 'bash', '../scripts/download-prebuilt-binaries.sh'
+  args 'android'
+}
+
 // Make preBuild depend on the download task
 tasks.preBuild {
     dependsOn assertMinimalReactNativeVersion
-    // dependsOn downloadStaticPrebuiltLibraries TODO: re-add when we have prebuilt libs put somewhere public
+    dependsOn downloadPrebuiltBinaries
 }
 
 task cleanCmakeCache() {

package/android/src/main/cpp/audioapi/CMakeLists.txt

@@ -3,14 +3,17 @@ cmake_minimum_required(VERSION 3.12.0)
 file(GLOB_RECURSE ANDROID_CPP_SOURCES CONFIGURE_DEPENDS "${ANDROID_CPP_DIR}/audioapi/*.cpp")
 file(GLOB_RECURSE COMMON_CPP_SOURCES CONFIGURE_DEPENDS "${COMMON_CPP_DIR}/audioapi/*.cpp" "${COMMON_CPP_DIR}/audioapi/*.c")
 
+set_source_files_properties(
+  ${COMMON_CPP_SOURCES}/dsp/*.cpp
+  PROPERTIES
+  COMPILE_FLAGS "-O3"
+)
+
 set(INCLUDE_DIR ${COMMON_CPP_DIR}/audioapi/external/include)
 set(FFMPEG_INCLUDE_DIR ${COMMON_CPP_DIR}/audioapi/external/ffmpeg_include)
 set(EXTERNAL_DIR ${COMMON_CPP_DIR}/audioapi/external)
 set(JNI_LIBS_DIR ${COMMON_CPP_DIR}/../../android/src/main/jniLibs)
 
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wl,-Bsymbolic")
-set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wl,-Bsymbolic")
-
 add_library(react-native-audio-api SHARED ${ANDROID_CPP_SOURCES} ${COMMON_CPP_SOURCES})
 
 foreach(lib IN ITEMS opus opusfile ogg vorbis vorbisenc vorbisfile crypto ssl)

package/android/src/main/cpp/audioapi/android/AudioAPIModule.cpp

@@ -51,6 +51,7 @@ void AudioAPIModule::registerNatives() {
       makeNativeMethod(
           "invokeHandlerWithEventNameAndEventBody",
           AudioAPIModule::invokeHandlerWithEventNameAndEventBody),
+      makeNativeMethod("closeAllContexts", AudioAPIModule::closeAllContexts),
   });
 }
 
@@ -101,4 +102,8 @@ void AudioAPIModule::invokeHandlerWithEventNameAndEventBody(
         eventName->toStdString(), body);
   }
 }
+
+void AudioAPIModule::closeAllContexts() {
+  AudioAPIModuleInstaller::closeAllContexts();
+}
 } // namespace audioapi

package/android/src/main/cpp/audioapi/android/AudioAPIModule.h

@@ -34,6 +34,7 @@ class AudioAPIModule : public jni::HybridClass<AudioAPIModule> {
 
   void injectJSIBindings();
   void invokeHandlerWithEventNameAndEventBody(jni::alias_ref<jni::JString> eventName, jni::alias_ref<jni::JMap<jstring, jobject>> eventBody);
+  void closeAllContexts();
 
  private:
   friend HybridBase;

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

@@ -1,9 +1,4 @@
-#include <android/log.h>
 #include <audioapi/android/core/AndroidAudioRecorder.h>
-#include <audioapi/android/core/utils/AndroidFileWriterBackend.h>
-#include <audioapi/android/core/utils/AndroidRecorderCallback.h>
-#include <audioapi/android/core/utils/ffmpegBackend/FFmpegFileWriter.h>
-#include <audioapi/android/core/utils/miniaudioBackend/MiniAudioFileWriter.h>
 #include <audioapi/core/sources/RecorderAdapterNode.h>
 #include <audioapi/core/utils/Constants.h>
 #include <audioapi/events/AudioEventHandlerRegistry.h>
@@ -15,22 +10,22 @@
 namespace audioapi {
 
 AndroidAudioRecorder::AndroidAudioRecorder(
+    float sampleRate,
+    int bufferLength,
     const std::shared_ptr<AudioEventHandlerRegistry> &audioEventHandlerRegistry)
-    : AudioRecorder(audioEventHandlerRegistry) {
+    : AudioRecorder(sampleRate, bufferLength, audioEventHandlerRegistry) {
   AudioStreamBuilder builder;
-
   builder.setSharingMode(SharingMode::Exclusive)
       ->setDirection(Direction::Input)
       ->setFormat(AudioFormat::Float)
       ->setFormatConversionAllowed(true)
       ->setPerformanceMode(PerformanceMode::None)
+      ->setChannelCount(1)
       ->setSampleRateConversionQuality(SampleRateConversionQuality::Medium)
       ->setDataCallback(this)
+      ->setSampleRate(static_cast<int>(sampleRate))
       ->openStream(mStream_);
 
-  streamSampleRate_ = mStream_->getSampleRate();
-  streamChannelCount_ = mStream_->getChannelCount();
-  streamMaxBufferSizeInFrames_ = mStream_->getBufferSizeInFrames();
   nativeAudioRecorder_ = jni::make_global(NativeAudioRecorder::create());
 }
 
@@ -44,162 +39,55 @@ AndroidAudioRecorder::~AndroidAudioRecorder() {
   }
 }
 
-std::string AndroidAudioRecorder::start() {
-  if (isRecording()) {
-    return filePath_;
-  }
-
-  if (!mStream_ || !nativeAudioRecorder_) {
-    __android_log_print(
-        ANDROID_LOG_ERROR,
-        "AndroidAudioRecorder",
-        "Audio stream is not initialized.\n");
-    return filePath_;
-  }
-
-  if (usesFileOutput()) {
-    filePath_ = fileWriter_->openFile(
-        streamSampleRate_, streamChannelCount_, streamMaxBufferSizeInFrames_);
-  }
-
-  if (usesCallback()) {
-    // TODO: create circular buffer and converter?
-    callback_->prepare(
-        streamSampleRate_, streamChannelCount_, streamMaxBufferSizeInFrames_);
-  }
-
-  if (isConnected()) {
-    // TODO: set adapter node properties?
-  }
-
-  nativeAudioRecorder_->start();
-  mStream_->requestStart();
-  state_.store(RecorderState::Recording);
-
-  return filePath_;
-}
-
-std::tuple<std::string, double, double> AndroidAudioRecorder::stop() {
-  std::string filePath = filePath_;
-  double outputFileSize = 0.0;
-  double outputDuration = 0.0;
-
-  if (!isRecording()) {
-    return {filePath_, 0.0, 0.0};
-  }
-
-  if (!mStream_ || !nativeAudioRecorder_) {
-    __android_log_print(
-        ANDROID_LOG_ERROR,
-        "AndroidAudioRecorder",
-        "Audio stream is not initialized.\n");
-    return {filePath_, 0.0, 0.0};
-  }
-
-  nativeAudioRecorder_->stop();
-  mStream_->requestStop();
-  state_.store(RecorderState::Idle);
-
-  if (usesFileOutput()) {
-    auto [size, duration] = fileWriter_->closeFile();
-    outputFileSize = size;
-    outputDuration = duration;
-  }
-
-  if (usesCallback()) {
-    callback_->cleanup();
+void AndroidAudioRecorder::start() {
+  if (isRunning_.load()) {
+    return;
   }
 
-  filePath_ = "";
-  return {filePath, outputFileSize, outputDuration};
-}
-
-void AndroidAudioRecorder::enableFileOutput(
-    float sampleRate,
-    size_t channelCount,
-    size_t bitRate,
-    size_t iosFlags,
-    size_t androidFlags) {
-  uint8_t format = static_cast<uint8_t>(androidFlags & 0xF);
-
-  if (format == 1) {
-    fileWriter_ = std::make_shared<MiniAudioFileWriter>(
-        sampleRate, channelCount, bitRate, androidFlags);
-  } else {
-    fileWriter_ = std::make_shared<FFmpegAudioFileWriter>(
-        sampleRate, channelCount, bitRate, androidFlags);
+  if (mStream_) {
+    jni::ThreadScope::WithClassLoader(
+        [this]() { nativeAudioRecorder_->start(); });
+    mStream_->requestStart();
   }
 
-  fileOutputEnabled_.store(true);
+  isRunning_.store(true);
 }
 
-void AndroidAudioRecorder::disableFileOutput() {
-  fileOutputEnabled_.store(false);
-  fileWriter_ = nullptr;
-}
-
-void AndroidAudioRecorder::pause() {
-  if (!isRecording()) {
+void AndroidAudioRecorder::stop() {
+  if (!isRunning_.load()) {
     return;
   }
 
-  mStream_->pause(0);
-  state_.store(RecorderState::Paused);
-}
+  isRunning_.store(false);
 
-void AndroidAudioRecorder::resume() {
-  if (!isPaused()) {
-    return;
+  if (mStream_) {
+    jni::ThreadScope::WithClassLoader(
+        [this]() { nativeAudioRecorder_->stop(); });
+    mStream_->requestStop();
   }
 
-  mStream_->start(0);
-  state_.store(RecorderState::Recording);
-}
-
-void AndroidAudioRecorder::setOnAudioReadyCallback(
-    float sampleRate,
-    size_t bufferLength,
-    size_t channelCount,
-    uint64_t callbackId) {
-  callback_ = std::make_shared<AndroidRecorderCallback>(
-      audioEventHandlerRegistry_,
-      sampleRate,
-      bufferLength,
-      channelCount,
-      callbackId);
-  callbackOutputEnabled_.store(true);
-}
-
-void AndroidAudioRecorder::clearOnAudioReadyCallback() {
-  callbackOutputEnabled_.store(false);
-  callback_ = nullptr;
+  sendRemainingData();
 }
 
 DataCallbackResult AndroidAudioRecorder::onAudioReady(
     oboe::AudioStream *oboeStream,
     void *audioData,
     int32_t numFrames) {
-  if (isPaused()) {
-    return DataCallbackResult::Continue;
+  if (isRunning_.load()) {
+    auto *inputChannel = static_cast<float *>(audioData);
+    writeToBuffers(inputChannel, numFrames);
   }
 
-  if (usesFileOutput()) {
-    fileWriter_->writeAudioData(audioData, numFrames);
-  }
+  while (circularBuffer_->getNumberOfAvailableFrames() >= bufferLength_) {
+    auto bus = std::make_shared<AudioBus>(bufferLength_, 1, sampleRate_);
+    auto *outputChannel = bus->getChannel(0)->getData();
 
-  if (usesCallback()) {
-    callback_->receiveAudioData(audioData, numFrames);
-  }
+    circularBuffer_->pop_front(outputChannel, bufferLength_);
 
-  return DataCallbackResult::Continue;
-}
-
-double AndroidAudioRecorder::getCurrentDuration() const {
-  if (usesFileOutput()) {
-    return fileWriter_->getCurrentDuration();
+    invokeOnAudioReadyCallback(bus, bufferLength_);
   }
 
-  return 0.0;
+  return DataCallbackResult::Continue;
 }
 
 } // namespace audioapi

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

@@ -5,8 +5,6 @@
 #include <oboe/Oboe.h>
 #include <functional>
 #include <memory>
-#include <string>
-#include <tuple>
 
 #include <audioapi/android/core/NativeAudioRecorder.hpp>
 
@@ -15,53 +13,28 @@ namespace audioapi {
 using namespace oboe;
 
 class AudioBus;
-class CircularAudioArray;
-class AndroidRecorderCallback;
-class AndroidFileWriterBackend;
-class AudioEventHandlerRegistry;
 
 class AndroidAudioRecorder : public AudioStreamDataCallback, public AudioRecorder {
  public:
-  explicit AndroidAudioRecorder(const std::shared_ptr<AudioEventHandlerRegistry> &audioEventHandlerRegistry);
-  ~AndroidAudioRecorder() override;
+    AndroidAudioRecorder(float sampleRate,
+                         int bufferLength,
+                         const std::shared_ptr<AudioEventHandlerRegistry> &audioEventHandlerRegistry
+                        );
 
-  std::string start() override;
-  std::tuple<std::string, double, double> stop() override;
+    ~AndroidAudioRecorder() override;
 
-  void enableFileOutput(
-      float sampleRate,
-      size_t channelCount,
-      size_t bitRate,
-      size_t iosFlags,
-      size_t androidFlags) override;
-  void disableFileOutput() override;
+    void start() override;
+    void stop() override;
 
-  void pause() override;
-  void resume() override;
-
-  void setOnAudioReadyCallback(float sampleRate, size_t bufferLength, size_t channelCount, uint64_t callbackId)
-      override;
-  void clearOnAudioReadyCallback() override;
-
-  double getCurrentDuration() const override;
-
-  DataCallbackResult onAudioReady(
-          AudioStream *oboeStream,
-          void *audioData,
-          int32_t numFrames) override;
+    DataCallbackResult onAudioReady(
+            AudioStream *oboeStream,
+            void *audioData,
+            int32_t numFrames) override;
 
  private:
-  std::string filePath_;
-  std::shared_ptr<AudioStream> mStream_;
-
-  std::shared_ptr<AndroidFileWriterBackend> fileWriter_;
-  std::shared_ptr<AndroidRecorderCallback> callback_;
-
-  int32_t streamSampleRate_;
-  int32_t streamChannelCount_;
-  int32_t streamMaxBufferSizeInFrames_;
+    std::shared_ptr<AudioStream> mStream_;
 
-  facebook::jni::global_ref<NativeAudioRecorder> nativeAudioRecorder_;
+    facebook::jni::global_ref<NativeAudioRecorder> nativeAudioRecorder_;
 };
 
 } // namespace audioapi

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

@@ -4,6 +4,7 @@
 #include <audioapi/core/utils/Constants.h>
 #include <audioapi/utils/AudioArray.h>
 #include <audioapi/utils/AudioBus.h>
+#include <jni.h>
 
 namespace audioapi {
 
@@ -49,7 +50,8 @@ bool AudioPlayer::openAudioStream() {
 
 bool AudioPlayer::start() {
   if (mStream_) {
-    nativeAudioPlayer_->start();
+    jni::ThreadScope::WithClassLoader(
+        [this]() { nativeAudioPlayer_->start(); });
     auto result = mStream_->requestStart();
     return result == oboe::Result::OK;
   }
@@ -59,7 +61,7 @@ bool AudioPlayer::start() {
 
 void AudioPlayer::stop() {
   if (mStream_) {
-    nativeAudioPlayer_->stop();
+    jni::ThreadScope::WithClassLoader([this]() { nativeAudioPlayer_->stop(); });
     mStream_->requestStop();
   }
 }

package/android/src/main/cpp/audioapi/android/core/NativeAudioRecorder.hpp

@@ -22,15 +22,15 @@ class NativeAudioRecorder : public jni::JavaClass<NativeAudioRecorder> {
     return newInstance();
   }
 
-  void start() {
-    static const auto method = javaClassStatic()->getMethod<void()>("start");
-    method(self());
-  }
-
-  void stop() {
-    static const auto method = javaClassStatic()->getMethod<void()>("stop");
-    method(self());
-  }
+    void start() {
+        static const auto method = javaClassStatic()->getMethod<void()>("start");
+        method(self());
+    }
+
+    void stop() {
+        static const auto method = javaClassStatic()->getMethod<void()>("stop");
+        method(self());
+    }
 };
 
 } // namespace audioapi

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

@@ -5,6 +5,7 @@
 #include <audioapi/utils/AudioArray.h>
 #include <audioapi/utils/AudioBus.h>
 
+#define MINIAUDIO_IMPLEMENTATION
 #include <audioapi/libs/miniaudio/decoders/libopus/miniaudio_libopus.h>
 #include <audioapi/libs/miniaudio/decoders/libvorbis/miniaudio_libvorbis.h>
 #include <audioapi/libs/miniaudio/miniaudio.h>
@@ -98,6 +99,11 @@ std::shared_ptr<AudioBuffer> AudioDecoder::decodeWithFilePath(
       sizeof(customBackends) / sizeof(customBackends[0]);
 
   if (ma_decoder_init_file(path.c_str(), &config, &decoder) != MA_SUCCESS) {
+    __android_log_print(
+        ANDROID_LOG_ERROR,
+        "AudioDecoder",
+        "Failed to initialize decoder for file: %s",
+        path.c_str());
     ma_decoder_uninit(&decoder);
     return nullptr;
   }