Skip to content

blakepell/BasicAudio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Basic Audio

NuGet version (BasicAudio) NuGet version (BasicAudio)

Basic audio is a class library with a test project (audio player/recorder) to faciliate basic audio playing and recording. There are other frameworks available to give you very detailed and complex audio functionality, this one aims to provide only the basic playback / record methods or provide light weight code you can include in your project. That being the case, the goal is to keep it simple for those that just want to incorporate playback/recording with minimal code or learning other frameworks.

If you need advanced recording and audio features I highly recommend NAudio.

Basic audio was originally written in Visual Basic but is now built off of C#. The Visual Basic version has been left in this project for posterity and is in the 'Legacy Visual Basic Version' folder in the Solution Explorer.

The library provides its functionality through the mciSendString Windows API and thus binds it desktop use cases. The playback features support wave files and mp3 files and the recoding supports wave files. The class library contains 3 classes, one for playback, one for recording and one that is an MCI error messages (there's an official API for this that I'll use in the future). The classes have been kept slim to facilitate ease of use. If you're looking for very detailed recording objects you'll want to consider another framework such as NAudio. Note that this records through whatever the currently selected recording device is in Windows.

OS Support

  • Windows 11
  • Windows 10
  • Windows 8.1
  • Windows 8
  • Windows 7
  • Windows Vista

.Net Framework Support

  • .NET 8.0
  • .NET 7.0
  • .NET 6.0
  • .NET 5.0
  • .NET Standard 2.1
  • .NET Standard 2.0
  • .NET Standard 1.3
  • .NET Framework 4.8
  • .NET Framework 4.7.2
  • .NET Framework 4.6.2
  • .NET Framework 4
  • .NET Framework 3.5

Start Recording Example

C#
// There are properties on this object to change the quality recording
var audioRecorder = new BasicAudio.Recording();
audioRecorder.Filename = @"c:\test.wav";
audioRecorder.StartRecording();
VB.Net
' There are properties on this object to change the quality recording
Dim audioRecorder As New BasicAudio.Recording()
audioRecorder.Filename = "c:\test.wav"
audioRecorder.StartRecording()   

Stop Recording Example

C#
// File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording();
VB.Net
' File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording()

Playback Example

C#
var audioPlayer = new BasicAudio.AudioPlayer();
audioPlayer.Filename = @"c:\test.mp3";
audioPlayer.Play();
VB.Net
Dim audioPlayer As New BasicAudio.AudioPlayer()
audioPlayer.Filename = "c:\test.mp3"
audioPlayer.Play()    ' Pause and Stop methods available

Stop Recording Example

C#
// File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording();
VB.Net
' File is written out to disk when this is called.  The filename property must already be set.
audioRecorder.StopRecording()

Troubleshooting

On some systems latency might be an issue due to installed audio drivers. If this occurs and your sound card support ASIO drivers then it might be worth it to research ASIO for all. I have used this on two systems in the past with success in mitigating any lag.

About

A simple class library that facilitates recording audio in Windows desktop applications.

Resources

License

Stars

Watchers

Forks

Packages

No packages published