C++音频处理 PortAudio库安装教程-C++-PHP中文网

C++音频处理 PortAudio库安装教程

P粉602998670

发布： 2025-08-29 13:04:01

原创

998人浏览过

PortAudio安装需下载源码、用CMake编译（配置PA_USE_ASIO等选项）生成库文件，再将头文件、lib和dll导入C++项目，最后复制dll到可执行文件目录。

c++音频处理 portaudio库安装教程

C++音频处理使用PortAudio库，安装过程可能会遇到一些坑，但总体来说并不复杂。本文将详细介绍PortAudio库的安装方法，助你顺利开始音频处理之旅。

解决方案

PortAudio是一个跨平台、开源的音频I/O库，支持多种操作系统和音频API。安装PortAudio主要分为下载源码、编译生成库文件以及配置项目环境三个步骤。

下载PortAudio源码：

立即学习“C++免费学习笔记（深入）”；

访问PortAudio官网（https://www.php.cn/link/b0653afa5cfd29eca06d158e96115519）下载最新稳定版本的源码。解压下载的压缩包到你喜欢的目录，例如
```
C:\portaudio
```
登录后复制
。
编译生成库文件（以Windows为例）：
- 安装CMake： CMake是一个跨平台的构建工具，PortAudio使用CMake进行构建。从CMake官网（https://www.php.cn/link/fa6d3cc166fbfbf005c9e77d96cba283）下载并安装最新版本。
- 创建构建目录： 在PortAudio源码目录下创建一个名为
```
build
```
  登录后复制
  的目录，用于存放编译生成的文件。
- 使用CMake生成Makefile： 打开CMake GUI，在 "Where is the source code" 栏中填入PortAudio源码目录（例如
```
C:\portaudio
```
  登录后复制
  ），在 "Where to build the binaries" 栏中填入构建目录（例如
```
C:\portaudio\build
```
  登录后复制
  ）。点击 "Configure" 按钮，选择你的编译器（例如 Visual Studio）。
- 配置CMake选项： CMake会列出PortAudio的配置选项。根据你的需求进行配置。一个常见的选项是
```
PA_USE_ASIO
```
  登录后复制
  ，如果你的系统安装了ASIO驱动，可以启用此选项以获得更好的音频性能。再次点击 "Configure" 按钮，然后点击 "Generate" 按钮，CMake会在构建目录中生成Makefile。
- 编译PortAudio： 打开命令行工具，进入构建目录（例如
```
C:\portaudio\build
```
  登录后复制
  ），执行
```
cmake --build . --config Release
```
  登录后复制
  命令编译PortAudio的Release版本。如果需要编译Debug版本，将
```
Release
```
  登录后复制
  替换为
```
Debug
```
  登录后复制
  。
  
  音刻
  AI音视频转录和笔记工具
  
  55
  
  查看详情
- 生成库文件： 编译完成后，在构建目录下的
```
lib
```
  登录后复制
  目录中会生成PortAudio的库文件（例如
```
portaudio.lib
```
  登录后复制
  ）和动态链接库文件（例如
```
portaudio.dll
```
  登录后复制
  ）。

配置项目环境：

包含头文件： 在你的C++项目中，将PortAudio的头文件目录（例如
```
C:\portaudio\include
```
登录后复制
）添加到包含路径中。
链接库文件： 将PortAudio的库文件（例如
```
portaudio.lib
```
登录后复制
）添加到链接器输入中。
复制动态链接库： 将PortAudio的动态链接库文件（例如
```
portaudio.dll
```
登录后复制
）复制到你的可执行文件所在的目录，或者添加到系统环境变量的
```
PATH
```
登录后复制
中。
代码示例： 下面是一个简单的PortAudio代码示例，用于播放一段正弦波：

#include <iostream>
#include <cmath>
#include <portaudio.h>

#define SAMPLE_RATE  44100
#define FRAMES_PER_BUFFER  256

typedef struct {
    float phase;
}   paTestData;

static int patestCallback(const void *inputBuffer, void *outputBuffer,
    unsigned long framesPerBuffer,
    const PaStreamCallbackTimeInfo* timeInfo,
    PaStreamCallbackFlags statusFlags,
    void *userData)
{
    paTestData *data = (paTestData*)userData;
    float *out = (float*)outputBuffer;
    unsigned int i;

    (void)timeInfo; /* Prevent unused variable warning. */
    (void)statusFlags;
    (void)inputBuffer;

    for (i = 0; i < framesPerBuffer; i++)
    {
        *out++ = (float)sin(data->phase);
        data->phase += 0.04f;
        if (data->phase >= 2.0f * M_PI) data->phase -= 2.0f * M_PI;
    }

    return paContinue;
}

int main() {
    PaError err;
    PaStream *stream;
    paTestData data;

    data.phase = 0.0f;

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

    err = Pa_OpenDefaultStream(&stream,
        0,                  /* no input channels */
        1,                  /* mono output */
        paFloat32,          /* 32 bit floating point output */
        SAMPLE_RATE,
        FRAMES_PER_BUFFER,
        patestCallback,
        &data);
    if (err != paNoError) goto error;

    err = Pa_StartStream(stream);
    if (err != paNoError) goto error;

    Pa_Sleep(5 * 1000); // Play for 5 seconds

    err = Pa_StopStream(stream);
    if (err != paNoError) goto error;

    err = Pa_CloseStream(stream);
    if (err != paNoError) goto error;

    Pa_Terminate();
    return 0;

error:
    Pa_Terminate();
    fprintf(stderr, "An error occured while using the portaudio stream\n");
    fprintf(stderr, "Error number: %d\n", err);
    fprintf(stderr, "Error message: %s\n", Pa_GetErrorText(err));
    return -1;
}

登录后复制

编译并运行此代码，你应该能听到一段正弦波。

PortAudio支持哪些操作系统和音频API？

PortAudio支持Windows、macOS、Linux等主流操作系统，以及DirectSound、ASIO、Core Audio、ALSA等多种音频API。选择合适的API可以获得更好的性能和兼容性。例如，在Windows下，ASIO通常比DirectSound具有更低的延迟。在macOS下，Core Audio是首选的API。