miniaudio

osaudio provides a simple, blocking read/write API for audio, contrasting with the callback-based model used in miniaudio. It is implemented as a header-only library with a reference implementation that uses miniaudio under the hood.

To use it, initialize an osaudio_config_t object, configure your desired format, channels, and rate, and then call osaudio_open. Data is sent to the device using osaudio_write, which blocks until all data has been sent.

#include "osaudio.h"

osaudio_t audio;
osaudio_config_t config;

// Initialize configuration for output
saudio_config_init(&config, OSAUDIO_OUTPUT);
config.format   = OSAUDIO_FORMAT_F32;
config.channels = 2;
config.rate     = 48000;

// Open the audio device
osaudio_open(&audio, &config);

// Write data (this call blocks until data is sent to the device)
osaudio_write(audio, myAudioData, frameCount);

// Close the device
osaudio_close(audio);

For direct access to raw audio data, use the ma_decoder and ma_device APIs. This allows you to provide a custom data callback for processing or streaming audio frames.

1. Initialize a decoder with ma_decoder_init_file.
2. Configure a playback device using ma_device_config_init(ma_device_type_playback).
3. Set the device configuration (format, channels, sample rate) based on the decoder's output.
4. Assign a data_callback to the device configuration.
5. Initialize and start the device with ma_device_init and ma_device_start.
6. In the callback, use ma_decoder_read_pcm_frames to fill the output buffer.
7. Uninitialize the device and decoder when finished.

#include "miniaudio/miniaudio.h"

#include <stdio.h>

void data_callback(ma_device* pDevice, void* pOutput, const void* pInput, ma_uint32 frameCount)
{
    ma_decoder* pDecoder = (ma_decoder*)pDevice->pUserData;
    if (pDecoder == NULL) {
        return;
    }

    ma_decoder_read_pcm_frames(pDecoder, pOutput, frameCount, NULL);

    (void)pInput;
}

int main(int argc, char** argv)
{
    ma_result result;
    ma_decoder decoder;
    ma_device_config deviceConfig;
    ma_device device;

    if (argc < 2) {
        printf("No input file.\n");
        return -1;
    }

    result = ma_decoder_init_file(argv[1], NULL, &decoder);
    if (result != MA_SUCCESS) {
        return -2;
    }

    deviceConfig = ma_device_config_init(ma_device_type_playback);
    deviceConfig.playback.format   = decoder.outputFormat;
    deviceConfig.playback.channels = decoder.outputChannels;
    deviceConfig.sampleRate        = decoder.outputSampleRate;
    deviceConfig.dataCallback      = data_callback;
    deviceConfig.pUserData         = &decoder;

    if (ma_device_init(NULL, &deviceConfig, &device) != MA_SUCCESS) {
        printf("Failed to open playback device.\n");
        ma_decoder_uninit(&decoder);
        return -3;
    }

    if (ma_device_start(&device) != MA_SUCCESS) {
        printf("Failed to start playback device.\n");
        ma_device_uninit(&device);
        ma_decoder_uninit(&decoder);
        return -4;
    }

    printf("Press Enter to quit...");
    getchar();

    ma_device_uninit(&device);
    ma_decoder_uninit(&decoder);

    return 0;
}