Socket AudioStream #

Socket AudioStream is a Flutter plugin for Windows that enables low-latency audio recording using the native Media Foundation API.

🎙️ Recording via WebSocket and microphone.
🔊 Playback via WebSocket and speakers.

✨ Features #

• Start, pause, resume, and stop recording
• Access available microphone devices
• Native implementation using C++ and Media Foundation
• No external dependencies
• Windows-only support

🎙️ Voice Processing Support (AEC, NS, AGC) #

This project uses Media Foundation to capture microphone input and includes support for:

• 🎧 Acoustic Echo Cancellation (AEC)
• 🔇 Noise Suppression (NS)
• 🎚️ Automatic Gain Control (AGC)

Audio Renderer Attributes – Win32 apps | Microsoft Learn MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS attribute | Microsoft Learn [Alphabetical List of Media Foundation Attributes] (https://learn.microsoft.com/en-us/windows/win32/medfound/alphabetical-list-of-media-foundation-attributes)

🚀 Getting Started #

Add the plugin to your Flutter project:

dependencies:
  socket_audiostream:
    path: ../socket_audiostream

Then run:

flutter pub get

Usage #

import 'package:socket_audiostream/mediarecorder.dart';
import 'package:socket_audiostream/mediaplayer.dart';

final recorder = MediaRecorder();
await record.listDevices()
await record.isReady;
...

final player = MediaPlayer();
await player.listDevices()
await player.isReady;
...

Testing the Plugin #

If you're testing the plugin from source:

flutter config --enable-windows-desktop
flutter create example
cd example

• Copy ../lib folder to the example folder.

# Add the plugin from local path
flutter pub add socket_audiostream --path=../

# Optional: Add WebSocket and dev dependencies
flutter pub add web_socket_channel
flutter pub add plugin_platform_interface --dev

flutter clean
flutter pub get
flutter run -d windows

See the example/ directory for a working Flutter app that demonstrates plugin usage.

Plugin Development Notes #

If you're contributing to this plugin:

• Comment out the plugin block in pubspec.yaml to allow re-creating the scaffold:

#flutter:
#  plugin:
#    platforms:
#      windows:
#        pluginClass: Socket AudioStreamPlugin

• Delete the existing example folder if needed.

• Recreate project scaffolding:

flutter config --enable-windows-desktop
flutter create .

• Open windows/runner/flutter_window.cpp.
• Add the following include at the top of the file, after the other #include statements:

#include "../include/socket_audiostream/socket_audiostream_plugin.h" 

Immediately after that line, add this code to manually register your plugin: RegisterPlugins(flutter_controller_->engine());

  SocketAudiostreamPluginRegisterWithRegistrar(
      flutter_controller_->engine()->GetRegistrarForPlugin("SocketAudiostreamPlugin")
  );

flutter clean
flutter pub get
flutter run -d windows

Windows Notes #

This plugin uses the native Windows Media Foundation API for:

• Low-latency audio capture
• High performance
• Native device access without third-party libraries

License #

This project is licensed under the MIT License.