mirror of
https://github.com/mackron/miniaudio.git
synced 2026-04-22 00:06:59 +02:00
David Reid
106 lines
2.5 KiB
Markdown
106 lines
2.5 KiB
Markdown
|
|
|
|
mini_al is a simple library for playing and recording audio. It's focused on simplicity and has
|
|
a very small number of APIs. This is not a full-featured audio library - it is intended to be
|
|
used as a quick and easy way to connect to an audio device and deliver and capture audio data
|
|
from speakers and microphones.
|
|
|
|
C/C++, single file, public domain.
|
|
|
|
|
|
Features
|
|
========
|
|
- Public domain
|
|
- Single file
|
|
- A very simple API
|
|
- Supports both playback and capture on _all_ backends
|
|
- Automatic sample rate conversion, channel conversion, format conversion and channel mapping
|
|
- Sample rate conversion is currently low quality, but a higher quality implementation is planned
|
|
|
|
|
|
Supported Platforms
|
|
===================
|
|
- Windows
|
|
- Linux
|
|
- BSD (via OSS)
|
|
- Android
|
|
|
|
macOS and iOS support is coming soon(ish) via Core Audio.
|
|
|
|
|
|
Backends
|
|
========
|
|
- WASAPI
|
|
- DirectSound
|
|
- WinMM
|
|
- ALSA
|
|
- OSS
|
|
- OpenSL|ES (Android only)
|
|
- OpenAL
|
|
- Null (Silence)
|
|
|
|
|
|
|
|
Simple Playback Example
|
|
=======================
|
|
|
|
```c
|
|
#define MAL_IMPLEMENTATION
|
|
#include "../mini_al.h"
|
|
|
|
#define DR_WAV_IMPLEMENTATION
|
|
#include "dr_wav.h"
|
|
|
|
#include <stdio.h>
|
|
|
|
// This is the function that's used for sending more data to the device for playback.
|
|
mal_uint32 on_send_frames_to_device(mal_device* pDevice, mal_uint32 frameCount, void* pSamples)
|
|
{
|
|
drwav* pWav = (drwav*)pDevice->pUserData;
|
|
if (pWav == NULL) {
|
|
return 0;
|
|
}
|
|
|
|
return (mal_uint32)drwav_read_s16(pWav, frameCount * pDevice->channels, (mal_int16*)pSamples) / pDevice->channels;
|
|
}
|
|
|
|
int main(int argc, char** argv)
|
|
{
|
|
if (argc < 2) {
|
|
printf("No input file.");
|
|
return -1;
|
|
}
|
|
|
|
drwav wav;
|
|
if (!drwav_init_file(&wav, argv[1])) {
|
|
printf("Not a valid WAV file.");
|
|
return -2;
|
|
}
|
|
|
|
mal_context context;
|
|
if (mal_context_init(NULL, 0, &context) != MAL_SUCCESS) {
|
|
printf("Failed to initialize context.");
|
|
return -3;
|
|
}
|
|
|
|
mal_device_config config = mal_device_config_init_playback(mal_format_s16, wav.channels, wav.sampleRate, on_send_frames_to_device);
|
|
|
|
mal_device device;
|
|
if (mal_device_init(&context, mal_device_type_playback, NULL, &config, &wav, &device) != MAL_SUCCESS) {
|
|
printf("Failed to open playback device.");
|
|
mal_context_uninit(&context);
|
|
drwav_uninit(&wav);
|
|
return -4;
|
|
}
|
|
mal_device_start(&device);
|
|
|
|
printf("Press Enter to quit...");
|
|
getchar();
|
|
|
|
mal_device_uninit(&device);
|
|
mal_context_uninit(&context);
|
|
drwav_uninit(&wav);
|
|
|
|
return 0;
|
|
}
|
|
``` |