C语言使用PulseAudio播放音频时出现链接错误的求助

问题描述 #

我尝试借助ChatGPT写了一段用PulseAudio在C语言中播放简单声音的代码，但编译时遇到了链接错误，明明已经安装了libpulse-dev包却还是找不到相关函数。我用的是Debian Sid系统，不想用system("paplay myfile.mp3")这种会新开shell的方式，想找更高效的解决方案。

尝试的代码 #

#include <stdio.h>
#include <pulse/error.h>
#include <pulse/simple.h>
#include <math.h>
#include <errno.h>

int main(int argc, char*argv[]) {
    int i;
    short buffer[22050];
    pa_simple *s;
    pa_sample_spec ss = {
        .format = PA_SAMPLE_S16LE,
        .rate = 44100,
        .channels = 1
    };
    float frequency = 440.0;

    for (i = 0; i < 22050; i++) {
        buffer[i * 2] = (short)(32767.0 * sin(2.0 * M_PI * frequency * i / 44100.0));
        buffer[i * 2 + 1] = buffer[i * 2];
    }

    if (!(s = pa_simple_new(NULL, argv[0], PA_STREAM_PLAYBACK, NULL, "playback", &ss, NULL, NULL, &errno))) {
        fprintf(stderr, "pa_simple_new() failed: %s\n", pa_strerror(errno));
        return 1;
    }

    if (pa_simple_write(s, buffer, sizeof(buffer), NULL) < 0) {
        fprintf(stderr, "pa_simple_write() failed: %s\n", pa_strerror(errno));
        return 1;
    }

    pa_simple_drain(s, NULL);
    pa_simple_free(s);
    return 0;
}

编译命令及错误输出 #

$ gcc -Wall main.c -lpulse -lm
/usr/bin/ld: /tmp/ccIDxk7P.o: in function `main':
main.c:(.text+0x11c): undefined reference to `pa_simple_new'
/usr/bin/ld: main.c:(.text+0x17e): undefined reference to `pa_simple_write'
/usr/bin/ld: main.c:(.text+0x1c9): undefined reference to `pa_simple_drain'
/usr/bin/ld: main.c:(.text+0x1d5): undefined reference to `pa_simple_free'
collect2: error: ld returned 1 exit status

环境确认 #

$ sudo apt list libpulse-dev
Listing... Done
libpulse-dev/unstable,now 16.1+dfsg1-2+b1 amd64 [installed]

我的解答 #

1. 先解决链接错误的核心问题

出现未定义引用的原因是GCC链接库的顺序不对——链接器是按从左到右的顺序处理依赖的，所以你需要把依赖库放在源文件的后面。

你可以直接调整编译命令的顺序：

gcc -Wall main.c -lm -lpulse

不过更稳妥的方式是用pkg-config来自动获取正确的编译和链接参数，它会帮你处理头文件路径、库的顺序等问题，避免手动出错：

gcc -Wall main.c $(pkg-config --cflags --libs libpulse-simple) -lm

这里用libpulse-simple而不是libpulse，因为你用的是PulseAudio的simple API，这个包会自动包含所需的依赖。

2. 修复代码里的数组越界问题

你的代码还有一个明显的bug：你设置的是单声道（channels=1），但循环里却在尝试填充双声道的数据，导致数组越界：

short buffer[22050];
// 当i=11025时，i*2=22050，已经超出了buffer的最大索引（22049）
buffer[i * 2] = ...;
buffer[i * 2 + 1] = ...;

如果要保持单声道，把循环改成这样：

for (i = 0; i < 22050; i++) {
    buffer[i] = (short)(32767.0 * sin(2.0 * M_PI * frequency * i / 44100.0));
}

如果想改成双声道，需要两步：

• 把pa_sample_spec里的channels改成2
• 把buffer的大小改成22050 * 2，然后循环里的索引就没问题了

3. 其他可选的轻量音频播放方式

如果你觉得PulseAudio的API还是有点繁琐，在Debian系统上还可以考虑：

• ALSA简单接口：用ALSA的snd_pcm_*函数，编译时用pkg-config --cflags --libs alsa获取参数
• SDL2音频模块：跨平台，API更友好，适合快速开发，编译时链接-lSDL2

不过PulseAudio的simple API已经是很轻量的选择了，解决上面的问题后就能正常工作。

备注：内容来源于stack exchange，提问作者theerrormagnet