Implement audio playback for the audio recorder

- Output device can be selected in the audio settings
- Clicking on the waveform will make the editor jump to the corresponding location
- The last recorded file path is saved and loaded along the project

Author: juzzlin

Agents.md

@@ -59,6 +59,11 @@ Adherence to these standards is mandatory for all contributions:
 - **Execution**: Run tests using `ctest` from the build directory.
 - **Framework**: Uses the Qt Test framework.
 
+## 🚀 Build & Test
+
+- **Build**: Use `cmake --build build` to build the project.
+- **Run Tests**: Use `ctest --test-dir build` to run all tests.
+
 ## 🚀 Performance & Timing
 
 - **Accuracy**: Noteahead renders events just before playback to ensure jitter-free, drift-free timing.

CHANGELOG

@@ -8,6 +8,11 @@ New features:
 * Add song transposition feature
   - Fixes also drum track not taken into account properly
 
+* Implement audio playback for the audio recorder
+  - Output device can be selected in the audio settings
+  - Clicking on the waveform will make the editor jump to the corresponding location
+  - The last recorded file path is saved and loaded along the project
+
 Bug fixes:
 
 Other:

README.md

@@ -107,6 +107,10 @@ All Arctic Music Project songs:
 - Audio recorder
   - Just enable recording in `Settings => Audio` and Noteahead will record from the selected audio source when the song starts and name the file according to active tracks
   - Records audio from Jack if Jack Transport is enabled (since 1.8.0)
+  - Clicking on the waveform will make the editor jump to the corresponding location (since 2.1.0)
+  - The last recorded audio file path is saved and loaded along the project (since 2.1.0)
+- Audio player (since 2.1.0)
+  - Output device can be selected in the audio settings
 
 ### Tools
 - Delay time calculator

src/CMakeLists.txt

@@ -178,8 +178,11 @@ set(SOURCE_FILES
   domain/song.cpp
   domain/track.cpp
   infra/audio/audio_recorder.cpp
+  infra/audio/audio_player.cpp
   infra/audio/implementation/jack/audio_recorder_jack.cpp
+  infra/audio/implementation/jack/audio_player_jack.cpp
   infra/audio/implementation/librtaudio/audio_recorder_rt_audio.cpp
+  infra/audio/implementation/librtaudio/audio_player_rt_audio.cpp
   infra/midi/export/midi_exporter.cpp
   infra/midi/import/midi_importer.cpp
   infra/midi/implementation/librtmidi/midi_in_rt_midi.cpp

src/application/application.cpp

@@ -427,6 +427,8 @@ void Application::connectEditorService()
     connect(m_editorService.get(), &EditorService::mixerSerializationRequested, m_mixerService.get(), &MixerService::serializeToXml);
     connect(m_editorService.get(), &EditorService::sideChainDeserializationRequested, m_sideChainService.get(), &SideChainService::deserializeFromXml);
     connect(m_editorService.get(), &EditorService::sideChainSerializationRequested, m_sideChainService.get(), &SideChainService::serializeToXml);
+    connect(m_editorService.get(), &EditorService::audioRecorderDeserializationRequested, m_audioService.get(), &AudioService::deserializeFromXml);
+    connect(m_editorService.get(), &EditorService::audioRecorderSerializationRequested, m_audioService.get(), &AudioService::serializeToXml);
     connect(m_editorService.get(), &EditorService::patternsDeleted, m_automationService.get(), &AutomationService::deletePatterns);
     connect(m_editorService.get(), &EditorService::patternsDeleted, m_noteColumnModelHandler.get(), &NoteColumnModelHandler::deletePatterns);
     connect(m_editorService.get(), &EditorService::trackDeleted, m_sideChainService.get(), &SideChainService::removeSettings);
@@ -551,7 +553,7 @@ void Application::connectPlayerService()
         const auto isPlaying = m_playerService->isPlaying();
         m_midiService->setIsPlaying(isPlaying);
         if (m_settingsService->recordingEnabled()) {
-            applyAudioRecording(isPlaying);
+            applyAudioRecording(isPlaying, m_playerService->tick());
         }
     });
 
@@ -597,17 +599,17 @@ QString Application::buildAudioFileName() const
     return {};
 }
 
-void Application::applyAudioRecording(bool isPlaying)
+void Application::applyAudioRecording(bool isPlaying, quint64 startTick)
 {
     if (isPlaying) {
         if (const auto audioFileName = buildAudioFileName(); !audioFileName.isEmpty()) {
             juzzlin::L(TAG).info() << "Recording audio to " << std::quoted(audioFileName.toStdString());
-            m_audioService->startRecording(audioFileName, static_cast<uint32_t>(m_settingsService->audioBufferSize()));
+            m_audioService->startRecording(audioFileName, static_cast<uint32_t>(m_settingsService->audioBufferSize()), startTick);
         } else {
             juzzlin::L(TAG).error() << "Output audio filename is empty!";
         }
     } else {
-        m_audioService->stopRecording();
+        m_audioService->stopRecording(startTick);
     }
 }
 

src/application/application.hpp

@@ -78,7 +78,7 @@ class Application : public QObject
 private:
     void applyAllInstruments();
     void applyAllMidiCcSettings();
-    void applyAudioRecording(bool isPlaying);
+    void applyAudioRecording(bool isPlaying, quint64 startTick);
     QString buildAudioFileName() const;
     void applyInstrument(size_t trackIndex, const Instrument & instrument);
     void applyMidiCcSettings(const Instrument & instrument);

src/application/models/audio_settings_model.cpp

@@ -29,11 +29,17 @@ AudioSettingsModel::AudioSettingsModel(AudioServiceS audioService, SettingsServi
   , m_settingsService { std::move(settingsService) }
 {
     m_selectedInputDeviceId = m_settingsService->audioInputDeviceId();
-    // Ensure the audio service knows about the saved device ID
     m_audioService->setInputDevice(m_selectedInputDeviceId);
     refreshInputDevices();
 
-    connect(m_audioService.get(), &AudioService::reinitialized, this, &AudioSettingsModel::refreshInputDevices);
+    m_selectedOutputDeviceId = m_settingsService->audioOutputDeviceId();
+    m_audioService->setOutputDevice(m_selectedOutputDeviceId);
+    refreshOutputDevices();
+
+    connect(m_audioService.get(), &AudioService::reinitialized, this, [this]() {
+        refreshInputDevices();
+        refreshOutputDevices();
+    });
 }
 
 AudioSettingsModel::~AudioSettingsModel() = default;
@@ -59,11 +65,39 @@ void AudioSettingsModel::setSelectedInputDeviceId(int deviceId)
     }
 }
 
+QVariantList AudioSettingsModel::outputDevices() const
+{
+    return m_outputDevices;
+}
+
+int AudioSettingsModel::selectedOutputDeviceId() const
+{
+    return m_selectedOutputDeviceId;
+}
+
+void AudioSettingsModel::setSelectedOutputDeviceId(int deviceId)
+{
+    if (m_selectedOutputDeviceId != deviceId) {
+        juzzlin::L(TAG).info() << "Selecting audio output device ID: " << deviceId;
+        m_selectedOutputDeviceId = deviceId;
+        m_settingsService->setAudioOutputDeviceId(deviceId);
+        m_audioService->setOutputDevice(deviceId);
+        emit selectedOutputDeviceIdChanged(deviceId);
+    }
+}
+
 void AudioSettingsModel::refreshInputDevices()
 {
     juzzlin::L(TAG).info() << "Refreshing input devices...";
     m_inputDevices = m_audioService->getInputDevices();
     emit inputDevicesChanged();
 }
 
+void AudioSettingsModel::refreshOutputDevices()
+{
+    juzzlin::L(TAG).info() << "Refreshing output devices...";
+    m_outputDevices = m_audioService->getOutputDevices();
+    emit outputDevicesChanged();
+}
+
 } // namespace noteahead

src/application/models/audio_settings_model.hpp

@@ -32,6 +32,8 @@ class AudioSettingsModel : public QObject
 
     Q_PROPERTY(QVariantList inputDevices READ inputDevices NOTIFY inputDevicesChanged)
     Q_PROPERTY(int selectedInputDeviceId READ selectedInputDeviceId WRITE setSelectedInputDeviceId NOTIFY selectedInputDeviceIdChanged)
+    Q_PROPERTY(QVariantList outputDevices READ outputDevices NOTIFY outputDevicesChanged)
+    Q_PROPERTY(int selectedOutputDeviceId READ selectedOutputDeviceId WRITE setSelectedOutputDeviceId NOTIFY selectedOutputDeviceIdChanged)
 
 public:
     using AudioServiceS = std::shared_ptr<AudioService>;
@@ -41,22 +43,30 @@ class AudioSettingsModel : public QObject
     ~AudioSettingsModel() override;
 
     QVariantList inputDevices() const;
-    
     int selectedInputDeviceId() const;
     void setSelectedInputDeviceId(int deviceId);
-    
+
+    QVariantList outputDevices() const;
+    int selectedOutputDeviceId() const;
+    void setSelectedOutputDeviceId(int deviceId);
+
     Q_INVOKABLE void refreshInputDevices();
+    Q_INVOKABLE void refreshOutputDevices();
 
 signals:
     void inputDevicesChanged();
     void selectedInputDeviceIdChanged(int deviceId);
+    void outputDevicesChanged();
+    void selectedOutputDeviceIdChanged(int deviceId);
 
 private:
     AudioServiceS m_audioService;
     SettingsServiceS m_settingsService;
 
     QVariantList m_inputDevices;
     int m_selectedInputDeviceId = 0;
+    QVariantList m_outputDevices;
+    int m_selectedOutputDeviceId = 0;
 };
 
 } // namespace noteahead