Avoimen lähdekoodin C-kirjasto ääni I/O:lle

Portaudion aloitus

PortAudion käyttöön aloittamiseksi voit joko kääntää sen lähdekoodista tai asentaa pakettienhallintojen kautta. Useimmille kehittäjille helpoin tapa on kloonata virallinen portaudio GitHub -varasto ja kääntää se CMake- tai autotools-työkaluilla. Linuxissa asenna komennolla `apt install portaudio19-dev`; macOSissa käytä `brew install portaudio`; Windowsissa lataa valmiit binaarit tai käytä vcpkg:tä (`vcpkg install portaudio`). Asennuksen jälkeen sisällytä `portaudio.h` ja linkitä kirjastoon (`-lportaudio`). Kirjasto on kevyt ja sillä on minimaaliset riippuvuudet, mikä tekee integroinnista suoraviivaista reaaliaikaisissa äänisovelluksissa.

# Linux (Debian/Ubuntu)
sudo apt install portaudio19-dev

# macOS (Homebrew)
brew install portaudio

# Windows (vcpkg)
vcpkg install portaudio

Reaaliaikainen äänen suoratoisto takaisinsoittojen avulla

PortAudio:n takaisinsoittoon perustuva suoratoistotila on ihanteellinen matalan viiveen, reaaliaikaisen äänenkäsittelyn tarpeisiin. Kun suoratoisto käynnistetään, PortAudio kutsuu säännöllisesti takaisinsoittofunktiotasi pyytääkseen tai toimittaakseen äänidataa. Tämä tila antaa tarkan hallinnan ajoitukseen ja minimoi puskurin alijäämiä. Takaisinsoitto vastaanottaa sisään- ja ulostulopuskurit, kehyslukumäärän, aikatiedot ja tilaliput—mahdollistaa dynaamisen äänenluonnin, efektien käsittelyn tai analyysin. Koska takaisinsoitto suoritetaan korkean prioriteetin säikeessä, sen on suoritettava nopeasti (yleensä alle 10 ms) välttääkseen häiriöt. Tämä tekee siitä täydellisen live-äänisovelluksiin, kuten syntetisaattoreihin, kitaratehoste-pedaleihin tai ääni­viestintäjärjestelmiin, joissa deterministinen suorituskyky on kriittistä.

typedef struct {
    float phase;
    float phase_increment;
} paTestData;

int patestCallback(const void *input, void *output,
    unsigned long frameCount,
    const PaStreamCallbackTimeInfo* timeInfo,
    PaStreamCallbackFlags statusFlags,
    void *userData)
{
    paTestData *data = (paTestData*)userData;
    float *out = (float*)output;
    for (unsigned long i = 0; i < frameCount; i++) {
        *out++ = sinf(data->phase);
        data->phase += data->phase_increment;
        if (data->phase >= M_PI * 2) data->phase -= M_PI * 2;
    }
    return paContinue;
}

Laitteiden luettelointi ja kysely

PortAudio tarjoaa vankat API:t luetellakseen ja tarkastellakseen käytettävissä olevia äänilaitteita—mukaan lukien sisään- ja ulostulolaitteet—sekä niiden ominaisuuksia. Kehittäjät voivat kysyä laitteiden nimiä, kanavamääriä, oletusnäytetaajuuksia ja latenssiarvoja käyttämällä funktioita kuten `Pa_GetDeviceCount()`, `Pa_GetDeviceInfo()` ja `Pa_GetDefaultInputDeviceID()`. Tämä mahdollistaa sovellusten esittää käyttäjille luettelo kelvollisista laitteista ja konfiguroida virtoja optimaalisesti. Voit myös havaita oletuslaitteet, tarkistaa tuetut näytetaajuudet ja määrittää minimi-/maksimilatenssit. Tämä joustavuus on olennaista rakennettaessa konfiguroitavia äänityökaluja, DAW:eja tai ääninauhuria, jotka mukautuvat erilaisiin laitteistokonfiguraatioihin ilman manuaalista asetusta.

PaError err;
err = Pa_Initialize();
if (err != paNoError) goto error;

int numDevices = Pa_GetDeviceCount();
for (int i = 0; i < numDevices; i++) {
    const PaDeviceInfo *info = Pa_GetDeviceInfo(i);
    printf("%d: %s (in: %d, out: %d)\n", 
        i, info->name, 
        info->maxInputChannels, 
        info->maxOutputChannels);
}
Pa_Terminate();

Monialustainen isäntä-API-tuki

PortAudio abstrahoi alusta‑kohtaiset äänirajapinnat modulaaristen isäntä‑API‑toteutusten kautta, varmistaen johdonmukaisen toiminnan eri käyttöjärjestelmissä. Windowsissa se tukee ASIO:ta (ammattikäyttöön), WASAPI:a (Vista+), DirectSoundia ja perinteistä MME:tä. macOS hyödyntää Core Audio -järjestelmää erittäin alhaisen latenssin saavuttamiseksi, kun taas Linux tukee ALSA:ta, JACKia ja PulseAudioa. BSD‑järjestelmät käyttävät OSS:ia tai sndio:ta. Kehittäjät kirjoittavat koodin kerran ja käyttöönotto tapahtuu kaikkialla—ei tarvita ehdollista käännöstä ydinlogiikassa. Kirjasto valitsee automaattisesti parhaan saatavilla olevan isäntä‑API:n tai antaa sinun määrittää sen eksplisiittisesti. Tämä monipuolisuus tekee PortAudiosta ihanteellisen siirrettäviin äänityökaluihin, opetusohjelmistoihin ja tutkimuskehyksiin, jotka täytyy toimia luotettavasti erilaisilla laitteistoilla ja käyttöjärjestelmäkokoonpanoilla.

PaStreamParameters inputParam, outputParam;
PaError err;

inputParam.device = Pa_GetHostApiInfoByType(paJACK)->defaultInputDevice;
inputParam.channelCount = 2;
inputParam.sampleFormat = paFloat32;
// ... configure outputParam similarly ...

PaStream *stream;
err = Pa_OpenStream(&stream, &inputParam, &outputParam, 
    44100, 256, paNoFlag, callback, NULL);

Ääniformaatin muunnos ja dithering

PortAudio käsittelee sisäisen näytteenformaattimuunnoksen läpinäkyvästi, jolloin asiakkaat voivat käyttää käteviä formaatteja, kuten 32-bittistä liukulukua, vaikka taustajärjestelmä käyttää natiiveja kokonaislukumuotoja (esim. 16-bittinen PCM). Se tukee muunnoksia 8-, 16-, 24- ja 32-bittisten kokonaislukumuotojen sekä 32-bittisen liukulukun välillä. Lisäksi se tarjoaa valinnaisen ditheringin bittisyvyyden vähentämisen aikana kvantisointikohinan minimoimiseksi – hienovarainen mutta kriittinen ominaisuus korkean tarkkuuden ääni­ sovelluksissa. Dithering säilyttää havaittavan äänenlaadun siirryttäessä korkeammasta alhaisempaan bittisyvyyteen. Nämä ominaisuudet varmistavat johdonmukaisen äänenlaadun eri alustoilla ilman, että kehittäjien täytyy toteuttaa monimutkaista formaattien käsittelylogiikkaa itse.

PaStreamParameters inputParam = {0};
inputParam.device = Pa_GetDefaultInputDevice();
inputParam.channelCount = 2;
inputParam.sampleFormat = paFloat32;
inputParam.suggestedLatency = Pa_GetDeviceInfo(inputParam.device)->defaultLowInputLatency;

// Enable dithering for output conversion
PaStream *stream;
Pa_OpenStream(&stream, &inputParam, NULL, 44100, 128, 
    paClipOff | paDitherOff, NULL, NULL);
// Note: paDitherOff disables dithering; omit for default dithering