summaryrefslogtreecommitdiff
path: root/src/audio/backend/miniaudio_backend.h
diff options
context:
space:
mode:
authorskal <pascal.massimino@gmail.com>2026-02-07 14:00:23 +0100
committerskal <pascal.massimino@gmail.com>2026-02-07 14:00:23 +0100
commita6a7bf0440dbabdc6c994c0fb21a8ac31c27be07 (patch)
tree26663d3d65b110fca618d6fa33c83f7a8d1e362a /src/audio/backend/miniaudio_backend.h
parentda1d4e10731789191d8a23e60c3dd35217e6bdb0 (diff)
feat(audio): Add SilentBackend, fix peak measurement, reorganize backends
## Critical Fixes **Peak Measurement Timing:** - Fixed 400ms audio-visual desync by measuring peak at playback time - Added get_realtime_peak() to AudioBackend interface - Implemented real-time measurement in MiniaudioBackend audio callback - Updated main.cc and test_demo.cc to use audio_get_realtime_peak() **Peak Decay Rate:** - Fixed slow decay (0.95 → 0.7 per callback) - Old: 5.76 seconds to fade to 10% (constant flashing in test_demo) - New: 1.15 seconds to fade to 10% (proper visual sync) ## New Features **SilentBackend:** - Test-only backend for testing audio.cc without hardware - Controllable peak for testing edge cases - Tracks frames rendered and voice triggers - Added 7 comprehensive tests covering: - Lifecycle (init/start/shutdown) - Peak control and tracking - Playback time and buffer management - Integration with AudioEngine ## Refactoring **Backend Organization:** - Created src/audio/backend/ directory - Moved all backend implementations to subdirectory - Updated include paths and CMakeLists.txt - Cleaner codebase structure **Code Cleanup:** - Removed unused register_spec_asset() function - Added deprecation note to synth_get_output_peak() ## Testing - All 28 tests passing (100%) - New test: test_silent_backend - Improved audio.cc test coverage significantly ## Documentation - Created PEAK_FIX_SUMMARY.md with technical details - Created TASKS_SUMMARY.md with complete task report Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Diffstat (limited to 'src/audio/backend/miniaudio_backend.h')
-rw-r--r--src/audio/backend/miniaudio_backend.h38
1 files changed, 38 insertions, 0 deletions
diff --git a/src/audio/backend/miniaudio_backend.h b/src/audio/backend/miniaudio_backend.h
new file mode 100644
index 0000000..eb9019c
--- /dev/null
+++ b/src/audio/backend/miniaudio_backend.h
@@ -0,0 +1,38 @@
+// This file is part of the 64k demo project.
+// It implements the production audio backend using miniaudio.
+// This is the default backend for the final build.
+
+#pragma once
+
+#include "../audio_backend.h"
+#include "miniaudio.h"
+
+// Production audio backend using miniaudio library
+// Manages real hardware audio device and playback
+class MiniaudioBackend : public AudioBackend {
+ public:
+ MiniaudioBackend();
+ ~MiniaudioBackend() override;
+
+ void init() override;
+ void start() override;
+ void shutdown() override;
+ float get_realtime_peak() override;
+
+ // Get the underlying miniaudio device (for internal use)
+ ma_device* get_device() {
+ return &device_;
+ }
+
+ private:
+ ma_device device_;
+ bool initialized_;
+
+ // Real-time peak measured at actual playback time (not pre-buffer)
+ // Updated in audio_callback when samples are read from ring buffer
+ static volatile float realtime_peak_;
+
+ // Static callback required by miniaudio C API
+ static void audio_callback(ma_device* pDevice, void* pOutput,
+ const void* pInput, ma_uint32 frameCount);
+};