refactor(core): overhaul audio engine and device architecture (#72)

This commit introduces a major architectural refactoring to move away from a singleton-based (`AudioEngine.Instance`) model to a device-centric, instance-based architecture. This fundamental change enables true multi-device input and output, allowing applications to manage and switch between multiple playback and capture devices simultaneously and independently.

This refactor also includes several new features, performance improvements, and critical bug fixes that are built upon the new architecture.

### Key Changes & Features

- **Multi-Device Architecture**: The global `AudioEngine.Instance` and `Mixer.Master` have been removed. The new design introduces `AudioPlaybackDevice`, `AudioCaptureDevice`, and `FullDuplexDevice` abstractions, each managing its own audio graph and `MasterMixer`.
- **Explicit Context**: Core components now receive `AudioEngine` and `AudioFormat` context via their constructors, removing implicit dependencies on global state.
- **Device Switching API**: A new, robust `Engine.SwitchDevice()` API allows for seamless hot-swapping of active audio devices while preserving their state (e.g., attached components or event subscribers).
- **New `VoiceIsolationEffect`**: Adds an experimental modifier that acts as a band-pass filter to help isolate human speech frequencies.
- **New `MultiEngines` Sample**: A new sample project is included to demonstrate and test the new multi-device capabilities.

### Fixes & Performance Improvements

- **fix(network)**: Refactored `NetworkDataProvider` to use a chunked streaming and decoding model, resolving excessive memory usage. Memory consumption for a 15-minute audio file is reduced from ~1GB to ~20MB.
- **fix(recording)**: Corrects a critical audio format conversion bug that produced garbled audio when recording to formats other than F32.
- **refactor(native)**: Unified the FFT implementations in `MathHelper` for Scalar, SSE, and AVX paths to ensure consistent behavior. The SIMD paths are now toggleable via static properties for easier debugging.
- **refactor(interop)**: The native device configuration layer now uses a comprehensive DTO, allowing for more granular control over backend-specific settings (WASAPI, ALSA, etc.).

BREAKING CHANGE: This is a fundamental architectural change that affects the entire public API.

- `AudioEngine.Instance` is removed. An `AudioEngine` must now be instantiated (e.g., `new MiniAudioEngine()`).
- Audio is no longer played by adding components to `Mixer.Master`. Users must first initialize a device (e.g., `engine.InitializePlaybackDevice(...)`) and then add components to the device's `MasterMixer`.
- Constructors for nearly all `SoundComponent`, `ISoundDataProvider`, `SoundModifier`, and `AudioAnalyzer` derivatives have changed. They now require an `AudioEngine` and/or `AudioFormat` instance to be passed in.
- The global `AudioEngine.OnAudioProcessed` event is removed. Events for processed audio are now available on a per-device basis (e.g., `AudioCaptureDevice.OnAudioProcessed`).
- The previous `SwitchDevice` API is replaced with new, more explicit methods on the `AudioEngine` instance that return a new device object.

Author: LSXPrime

.github/workflows/build.yml

@@ -285,19 +285,19 @@ jobs:
         if: matrix.platform == 'Linux'
         run: |
           sudo apt-get update
-          sudo apt-get install -y cmake gcc g++
+          sudo apt-get install -y cmake gcc g++ file binutils
 
       - name: Install Dependencies (Android)
         if: matrix.platform == 'Android'
         uses: android-actions/setup-android@v2
-        
+
       - name: Install Cross-Compilation tools (Linux)
         if: matrix.platform == 'Linux' && (matrix.arch == 'armv7l' || matrix.arch == 'aarch64')
         run: |
           sudo apt-get update
           sudo apt-get install -y qemu-user-static
           if [ "${{ matrix.arch }}" == "armv7l" ]; then
-            sudo apt-get install -y gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf
+            sudo apt-get install -y gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf binutils-arm-linux-gnueabihf
           elif [ "${{ matrix.arch }}" == "aarch64" ]; then
             sudo apt-get install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu
           fi
@@ -389,44 +389,70 @@ jobs:
           fi
 
       # Dependency analysis
-      - name: Analyze Dependencies (Windows)
+      - name: Analyze Dependencies and Exports (Windows)
         if: matrix.platform == 'Windows'
         shell: powershell
         run: |
-          Write-Host "Dependencies for Windows:"
-          & "$env:DUMPBIN_PATH\dumpbin.exe" /DEPENDENTS "runtimes/${{ matrix.rid }}/native/miniaudio.dll"
+          $libPath = "runtimes/${{ matrix.rid }}/native/miniaudio.dll"
+          Write-Host "--- Dependencies for $libPath ---"
+          & "$env:DUMPBIN_PATH\dumpbin.exe" /DEPENDENTS "$libPath"
+          Write-Host "--- Exports for $libPath ---"
+          & "$env:DUMPBIN_PATH\dumpbin.exe" /EXPORTS "$libPath"
 
-      - name: Analyze Dependencies (iOS)
+      - name: Analyze Dependencies and Exports (iOS)
         if: matrix.platform == 'iOS'
         shell: bash
         run: |
-          FRAMEWORK_BINARY="runtimes/${{ matrix.rid }}/native/miniaudio.framework/miniaudio"
-          echo "Dependencies for iOS:"
-          otool -L "$FRAMEWORK_BINARY"
+          LIB_PATH="runtimes/${{ matrix.rid }}/native/miniaudio.framework/miniaudio"
+          echo "--- Dependencies for iOS ---"
+          otool -L "$LIB_PATH"
+          echo "--- Symbols ---"
+          nm -g "$LIB_PATH" | grep " T "
 
-      - name: Analyze Dependencies (Android)
+      - name: Analyze Dependencies and Exports (Android)
         if: matrix.platform == 'Android'
         shell: bash
         run: |
           LIB_PATH="runtimes/${{ matrix.rid }}/native/libminiaudio.so"
-          echo "Dependencies for Android:"
+          echo "--- Dependencies for Android ---"
           readelf -d "$LIB_PATH"
+          echo "--- Symbols ---"
+          nm -g "$LIB_PATH" | grep " T "
 
-      - name: Analyze Dependencies (Linux)
+      - name: Analyze Dependencies and Exports (Linux)
         if: matrix.platform == 'Linux'
         shell: bash
         run: |
           LIB_PATH="runtimes/${{ matrix.rid }}/native/libminiaudio.so"
-          echo "Dependencies for Linux (${{ matrix.arch }}):"
-          readelf -d "$LIB_PATH" || echo "Analysis failed - binary may be invalid"
+          echo "=== Library Information ==="
+          file "$LIB_PATH"
+
+          echo -e "\n=== Dependencies ==="
+          if [[ "${{ matrix.arch }}" == "x86_64" ]]; then
+            ldd "$LIB_PATH" || true
+          else
+            readelf -d "$LIB_PATH" | grep "NEEDED" || true
+          fi
+
+          echo -e "\n=== Symbols ==="
+          if [[ "${{ matrix.arch }}" == "x86_64" || "${{ matrix.arch }}" == "aarch64" ]]; then
+            nm -g "$LIB_PATH" | grep " T " || true
+          else
+            arm-linux-gnueabihf-nm -g "$LIB_PATH" | grep " T " || true
+          fi
+
+          echo -e "\n=== SONAME ==="
+          readelf -d "$LIB_PATH" | grep "SONAME" || true
 
-      - name: Analyze Dependencies (macOS)
+      - name: Analyze Dependencies and Exports (macOS)
         if: matrix.platform == 'macOS'
         shell: bash
         run: |
           LIB_PATH="runtimes/${{ matrix.rid }}/native/libminiaudio.dylib"
-          echo "Dependencies for macOS:"
+          echo "--- Dependencies for macOS ---"
           otool -L "$LIB_PATH"
+          echo "--- Symbols ---"
+          nm -g "$LIB_PATH" | grep " T "
 
       - name: Upload Artifact
         uses: actions/upload-artifact@v4