diff --git a/tests/android/MiniaudioTester/.gitignore b/tests/android/MiniaudioTester/.gitignore
new file mode 100644
index 00000000..aa724b77
--- /dev/null
+++ b/tests/android/MiniaudioTester/.gitignore
@@ -0,0 +1,15 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
diff --git a/tests/android/MiniaudioTester/app/.gitignore b/tests/android/MiniaudioTester/app/.gitignore
new file mode 100644
index 00000000..42afabfd
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/.gitignore
@@ -0,0 +1 @@
+/build
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/build.gradle.kts b/tests/android/MiniaudioTester/app/build.gradle.kts
new file mode 100644
index 00000000..f6bfa198
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/build.gradle.kts
@@ -0,0 +1,56 @@
+plugins {
+ alias(libs.plugins.android.application)
+ alias(libs.plugins.kotlin.android)
+}
+
+android {
+ namespace = "io.miniaud.miniaudiotester"
+ compileSdk = 35
+
+ defaultConfig {
+ applicationId = "io.miniaud.miniaudiotester"
+ minSdk = 26
+ targetSdk = 35
+ versionCode = 1
+ versionName = "1.0"
+
+ testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+ }
+
+ buildTypes {
+ release {
+ isMinifyEnabled = false
+ proguardFiles(
+ getDefaultProguardFile("proguard-android-optimize.txt"),
+ "proguard-rules.pro"
+ )
+ }
+ }
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_11
+ targetCompatibility = JavaVersion.VERSION_11
+ }
+ kotlinOptions {
+ jvmTarget = "11"
+ }
+ externalNativeBuild {
+ cmake {
+ path = file("src/main/cpp/CMakeLists.txt")
+ version = "3.22.1"
+ }
+ }
+ buildFeatures {
+ viewBinding = true
+ }
+}
+
+dependencies {
+
+ implementation(libs.androidx.core.ktx)
+ implementation(libs.androidx.appcompat)
+ implementation(libs.material)
+ implementation(libs.androidx.constraintlayout)
+ testImplementation(libs.junit)
+ androidTestImplementation(libs.androidx.junit)
+ androidTestImplementation(libs.androidx.espresso.core)
+}
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/proguard-rules.pro b/tests/android/MiniaudioTester/app/proguard-rules.pro
new file mode 100644
index 00000000..481bb434
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/src/androidTest/java/io/miniaud/miniaudiotester/ExampleInstrumentedTest.kt b/tests/android/MiniaudioTester/app/src/androidTest/java/io/miniaud/miniaudiotester/ExampleInstrumentedTest.kt
new file mode 100644
index 00000000..7a616602
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/androidTest/java/io/miniaud/miniaudiotester/ExampleInstrumentedTest.kt
@@ -0,0 +1,24 @@
+package io.miniaud.miniaudiotester
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+ @Test
+ fun useAppContext() {
+ // Context of the app under test.
+ val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+ assertEquals("io.miniaud.miniaudiotester", appContext.packageName)
+ }
+}
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/src/main/AndroidManifest.xml b/tests/android/MiniaudioTester/app/src/main/AndroidManifest.xml
new file mode 100644
index 00000000..c39e6dbe
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/main/AndroidManifest.xml
@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/src/main/cpp/CMakeLists.txt b/tests/android/MiniaudioTester/app/src/main/cpp/CMakeLists.txt
new file mode 100644
index 00000000..4148ced3
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/main/cpp/CMakeLists.txt
@@ -0,0 +1,37 @@
+# For more information about using CMake with Android Studio, read the
+# documentation: https://d.android.com/studio/projects/add-native-code.html.
+# For more examples on how to use CMake, see https://github.com/android/ndk-samples.
+
+# Sets the minimum CMake version required for this project.
+cmake_minimum_required(VERSION 3.22.1)
+
+# Declares the project name. The project name can be accessed via ${ PROJECT_NAME},
+# Since this is the top level CMakeLists.txt, the project name is also accessible
+# with ${CMAKE_PROJECT_NAME} (both CMake variables are in-sync within the top level
+# build script scope).
+project("miniaudiotester")
+
+# Creates and names a library, sets it as either STATIC
+# or SHARED, and provides the relative paths to its source code.
+# You can define multiple libraries, and CMake builds them for you.
+# Gradle automatically packages shared libraries with your APK.
+#
+# In this top level CMakeLists.txt, ${CMAKE_PROJECT_NAME} is used to define
+# the target library name; in the sub-module's CMakeLists.txt, ${PROJECT_NAME}
+# is preferred for the same purpose.
+#
+# In order to load a library into your app from Java/Kotlin, you must call
+# System.loadLibrary() and pass the name of the library defined here;
+# for GameActivity/NativeActivity derived applications, the same library name must be
+# used in the AndroidManifest.xml file.
+add_library(${CMAKE_PROJECT_NAME} SHARED
+ # List C/C++ source files with relative paths to this CMakeLists.txt.
+ native-lib.cpp)
+
+# Specifies libraries CMake should link to your target library. You
+# can link libraries from various origins, such as libraries defined in this
+# build script, prebuilt third-party libraries, or Android system libraries.
+target_link_libraries(${CMAKE_PROJECT_NAME}
+ # List libraries link to the target library
+ android
+ log)
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/src/main/cpp/native-lib.cpp b/tests/android/MiniaudioTester/app/src/main/cpp/native-lib.cpp
new file mode 100644
index 00000000..3865f2e3
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/main/cpp/native-lib.cpp
@@ -0,0 +1,173 @@
+#include
+#include
+
+#define MA_DEBUG_OUTPUT
+#include "../../../../../../../miniaudio.c" /* Android projects have very deep folder structures... */
+
+typedef enum
+{
+ BACKEND_AUTO,
+ BACKEND_AAUDIO,
+ BACKEND_OPENSL
+} backend_choice_t;
+
+typedef struct
+{
+ ma_device device;
+ ma_waveform waveform;
+ bool hasDevice;
+ bool hasError; /* Will be set to true if something went wrong. */
+ std::string errorMessage; /* Will be an empty string if there is no error message. */
+} audio_state_t;
+
+static void audio_state_set_error(audio_state_t* pAudioState, const char* pMessage)
+{
+ assert(pAudioState != nullptr);
+
+ pAudioState->hasError = true;
+ pAudioState->errorMessage = pMessage;
+}
+
+
+static void data_callback(ma_device* pDevice, void* pFramesOut, const void* pFramesIn, ma_uint32 frameCount)
+{
+ auto* pAudioState = (audio_state_t*)pDevice->pUserData;
+ assert(pAudioState != nullptr);
+
+ ma_waveform_read_pcm_frames(&pAudioState->waveform, pFramesOut, frameCount, nullptr);
+}
+
+
+extern "C"
+JNIEXPORT jlong JNICALL
+Java_io_miniaud_miniaudiotester_MainActivity_UninitializeAudio(JNIEnv *env, jobject, jlong audioState)
+{
+ auto* pAudioState = (audio_state_t*)audioState;
+ if (pAudioState == nullptr) {
+ return 0;
+ }
+
+ if (pAudioState->hasDevice) {
+ ma_device_uninit(&pAudioState->device);
+ ma_waveform_uninit(&pAudioState->waveform);
+ pAudioState->hasDevice = false;
+ }
+
+ pAudioState->hasError = false;
+ pAudioState->errorMessage = "";
+
+ return (jlong)pAudioState;
+}
+
+extern "C"
+JNIEXPORT jlong JNICALL
+Java_io_miniaud_miniaudiotester_MainActivity_PlayAudio(JNIEnv *env, jobject, jlong audioState, int backend)
+{
+ auto* pAudioState = (audio_state_t*)audioState;
+ ma_result result;
+
+ if (pAudioState == nullptr) {
+ pAudioState = new audio_state_t;
+ pAudioState->hasDevice = false;
+ pAudioState->hasError = false;
+ }
+
+ /* If we don't have a device, create one. */
+ if (!pAudioState->hasDevice) {
+ ma_context_config contextConfig = ma_context_config_init();
+ ma_backend pBackends[1];
+ size_t backendCount;
+
+ if (backend == BACKEND_AUTO) {
+ backendCount = 0;
+ } else {
+ backendCount = 1;
+ if (backend == BACKEND_AAUDIO) {
+ pBackends[0] = ma_backend_aaudio;
+ } else if (backend == BACKEND_OPENSL) {
+ pBackends[0] = ma_backend_opensl;
+ } else {
+ backendCount = 0;
+ }
+ }
+
+ ma_device_config deviceConfig = ma_device_config_init(ma_device_type_playback);
+ deviceConfig.dataCallback = data_callback;
+ deviceConfig.pUserData = pAudioState;
+
+ result = ma_device_init_ex((backendCount == 0) ? nullptr : pBackends, backendCount, &contextConfig, &deviceConfig, &pAudioState->device);
+ if (result != MA_SUCCESS) {
+ audio_state_set_error(pAudioState, (std::string("Failed to initialize device. ") + ma_result_description(result)).c_str());
+ pAudioState->hasDevice = false;
+ }
+
+ /* Before starting the device we will need a waveform object. This should never fail to initialize. */
+ ma_waveform_config waveformConfig = ma_waveform_config_init(pAudioState->device.playback.format, pAudioState->device.playback.channels, pAudioState->device.sampleRate, ma_waveform_type_sine, 0.2, 400);
+ ma_waveform_init(&waveformConfig, &pAudioState->waveform);
+
+ pAudioState->hasDevice = true;
+ }
+
+ /* At this point we should have a device. Start it. */
+ result = ma_device_start(&pAudioState->device);
+ if (result != MA_SUCCESS) {
+ audio_state_set_error(pAudioState, (std::string("Failed to start device. ") + ma_result_description(result)).c_str());
+ }
+
+ return (jlong)pAudioState;
+}
+
+extern "C"
+JNIEXPORT jlong JNICALL
+Java_io_miniaud_miniaudiotester_MainActivity_PauseAudio(JNIEnv *env, jobject, jlong audioState)
+{
+ auto* pAudioState = (audio_state_t*)audioState;
+ if (pAudioState == nullptr) {
+ return true;
+ }
+
+ if (!pAudioState->hasError) {
+ if (pAudioState->hasDevice) {
+ ma_result result = ma_device_stop(&pAudioState->device);
+ if (result != MA_SUCCESS) {
+ audio_state_set_error(pAudioState, ma_result_description(result));
+ }
+ } else {
+ audio_state_set_error(pAudioState, "Trying to pause audio, but there is no device.");
+ }
+ }
+
+ return (jlong)pAudioState;
+}
+
+extern "C"
+JNIEXPORT jboolean JNICALL
+Java_io_miniaud_miniaudiotester_MainActivity_HasAudioError(JNIEnv *env, jobject, jlong audioState)
+{
+ auto* pAudioState = (audio_state_t*)audioState;
+ if (pAudioState == nullptr) {
+ return true;
+ }
+
+ return pAudioState->hasError;
+}
+
+extern "C"
+JNIEXPORT jstring JNICALL
+Java_io_miniaud_miniaudiotester_MainActivity_GetAudioError(JNIEnv *env, jobject, jlong audioState)
+{
+ auto* pAudioState = (audio_state_t*)audioState;
+ if (pAudioState == nullptr) {
+ return env->NewStringUTF("Out of memory");
+ }
+
+ return env->NewStringUTF(pAudioState->errorMessage.c_str());
+}
+
+extern "C"
+JNIEXPORT void JNICALL
+Java_io_miniaud_miniaudiotester_MainActivity_DeleteAudioState(JNIEnv *env, jobject thiz, jlong audioState)
+{
+ Java_io_miniaud_miniaudiotester_MainActivity_UninitializeAudio(env, thiz, audioState);
+ delete (audio_state_t*)audioState;
+}
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/src/main/java/io/miniaud/miniaudiotester/MainActivity.kt b/tests/android/MiniaudioTester/app/src/main/java/io/miniaud/miniaudiotester/MainActivity.kt
new file mode 100644
index 00000000..7340d546
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/main/java/io/miniaud/miniaudiotester/MainActivity.kt
@@ -0,0 +1,79 @@
+package io.miniaud.miniaudiotester
+
+import android.annotation.SuppressLint
+import androidx.appcompat.app.AppCompatActivity
+import android.os.Bundle
+import android.widget.TextView
+import io.miniaud.miniaudiotester.databinding.ActivityMainBinding
+
+enum class AudioBackend(val value: Int)
+{
+ BACKEND_AUTO(0),
+ BACKEND_AAUDIO(1),
+ BACKEND_OPENSL(2)
+}
+
+class MainActivity : AppCompatActivity()
+{
+ private lateinit var binding: ActivityMainBinding
+
+ @SuppressLint("SetTextI18n")
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+
+ binding = ActivityMainBinding.inflate(layoutInflater)
+ setContentView(binding.root)
+
+ binding.btnPlay.setOnClickListener {
+ val backend: AudioBackend;
+ if (binding.radioAAudio.isChecked) {
+ backend = AudioBackend.BACKEND_AAUDIO
+ } else if (binding.radioOpenSL.isChecked) {
+ backend = AudioBackend.BACKEND_OPENSL
+ } else {
+ backend = AudioBackend.BACKEND_AUTO
+ }
+
+ audioState = PlayAudio(audioState, backend.value)
+ if (HasAudioError(audioState)) {
+ binding.textInfo.text = GetAudioError(audioState)
+ } else {
+ binding.textInfo.text = "Playing..."
+ }
+ }
+
+ binding.btnStop.setOnClickListener {
+ audioState = PauseAudio(audioState)
+ if (HasAudioError(audioState)) {
+ binding.textInfo.text = GetAudioError(audioState)
+ } else {
+ binding.textInfo.text = "Paused."
+ }
+ }
+
+ binding.btnUninit.setOnClickListener {
+ audioState = UninitializeAudio(audioState)
+ if (HasAudioError(audioState)) {
+ binding.textInfo.text = GetAudioError(audioState)
+ } else {
+ binding.textInfo.text = "Device uninitialized."
+ }
+ }
+ }
+
+ private var audioState: Long = 0
+
+ external fun UninitializeAudio(audioState: Long): Long
+ external fun PlayAudio(audioState: Long, backend: Int): Long
+ external fun PauseAudio(audioState: Long): Long
+ external fun HasAudioError(audioState: Long): Boolean
+ external fun GetAudioError(audioState: Long): String
+ external fun DeleteAudioState(audioState: Long)
+
+ companion object {
+ // Used to load the 'miniaudiotester' library on application startup.
+ init {
+ System.loadLibrary("miniaudiotester")
+ }
+ }
+}
\ No newline at end of file
diff --git a/tests/android/MiniaudioTester/app/src/main/res/drawable/ic_launcher_background.xml b/tests/android/MiniaudioTester/app/src/main/res/drawable/ic_launcher_background.xml
new file mode 100644
index 00000000..07d5da9c
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/main/res/drawable/ic_launcher_background.xml
@@ -0,0 +1,170 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/tests/android/MiniaudioTester/app/src/main/res/drawable/ic_launcher_foreground.xml b/tests/android/MiniaudioTester/app/src/main/res/drawable/ic_launcher_foreground.xml
new file mode 100644
index 00000000..2b068d11
--- /dev/null
+++ b/tests/android/MiniaudioTester/app/src/main/res/drawable/ic_launcher_foreground.xml
@@ -0,0 +1,30 @@
+
+
+
+
+