https://github.com/blakepell/basicaudio
A simple class library that facilitates recording audio in Windows desktop applications.
https://github.com/blakepell/basicaudio
Last synced: 8 months ago
JSON representation
A simple class library that facilitates recording audio in Windows desktop applications.
- Host: GitHub
- URL: https://github.com/blakepell/basicaudio
- Owner: blakepell
- License: mit
- Created: 2015-01-30T21:00:37.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-11-15T22:44:59.000Z (over 2 years ago)
- Last Synced: 2024-04-26T21:02:52.481Z (about 2 years ago)
- Language: C#
- Homepage:
- Size: 98.6 KB
- Stars: 7
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Basic Audio
[](https://www.nuget.org/packages/BasicAudio/)
[](https://github.com/blakepell/BasicAudio/blob/master/LICENSE)
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](https://github.com/naudio/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](https://github.com/naudio/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#
```csharp
// 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
```vbnet
' 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#
```csharp
// File is written out to disk when this is called. The filename property must already be set.
audioRecorder.StopRecording();
```
##### VB.Net
```vbnet
' File is written out to disk when this is called. The filename property must already be set.
audioRecorder.StopRecording()
```
## Playback Example
##### C#
```csharp
var audioPlayer = new BasicAudio.AudioPlayer();
audioPlayer.Filename = @"c:\test.mp3";
audioPlayer.Play();
```
##### VB.Net
```vbnet
Dim audioPlayer As New BasicAudio.AudioPlayer()
audioPlayer.Filename = "c:\test.mp3"
audioPlayer.Play() ' Pause and Stop methods available
```
## Stop Recording Example
##### C#
```csharp
// File is written out to disk when this is called. The filename property must already be set.
audioRecorder.StopRecording();
```
##### VB.Net
```vbnet
' 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](http://www.asio4all.org/). I
have used this on two systems in the past with success in mitigating any lag.