2. 构建基础音频测试管道

任务目标

构建并运行一条最小音频测试管道，使用 audiotestsrc 产生测试音源，经 autoaudiosink 自动选择可用音频输出设备播放，以验证当前嵌入式平台的音频采集/输出链路工作正常。

环境依赖

• GStreamer 核心库（≥1.14）
• 音频插件集 gst-plugins-base（提供 audiotestsrc）
• 音频输出插件 gst-plugins-good 或 gst-plugins-ugly（autoaudiosink 依赖具体后端，如 ALSA/PulseAudio）
• ALSA 或 PulseAudio 驱动已正确加载，声卡设备可用

核心代码

#include <gst/gst.h>

int main(int argc, char *argv[]) {
    GstElement *pipeline, *src, *sink;
    GstBus *bus;
    GstMessage *msg;
    GError *error = NULL;

    gst_init(&argc, &argv);

    // 创建元素
    src = gst_element_factory_make("audiotestsrc", "test_source");
    sink = gst_element_factory_make("autoaudiosink", "auto_sink");
    if (!src || !sink) {
        g_printerr("元素创建失败，请检查插件是否安装\n");
        return -1;
    }

    // 构建管道
    pipeline = gst_pipeline_new("audio-test-pipeline");
    gst_bin_add_many(GST_BIN(pipeline), src, sink, NULL);
    if (!gst_element_link(src, sink)) {
        g_printerr("元素连接失败\n");
        gst_object_unref(pipeline);
        return -1;
    }

    // 设置测试音源参数（可选：1kHz 正弦波）
    g_object_set(src, "freq", 1000.0, "volume", 0.5, NULL);

    // 启动管道
    gst_element_set_state(pipeline, GST_STATE_PLAYING);

    // 等待错误或 EOS
    bus = gst_element_get_bus(pipeline);
    msg = gst_bus_timed_pop_filtered(bus, GST_CLOCK_TIME_NONE,
                                      GST_MESSAGE_ERROR | GST_MESSAGE_EOS);

    // 错误处理
    if (msg != NULL) {
        GError *err = NULL;
        gchar *debug_info = NULL;
        switch (GST_MESSAGE_TYPE(msg)) {
        case GST_MESSAGE_ERROR:
            gst_message_parse_error(msg, &err, &debug_info);
            g_printerr("管道错误: %s\n", err->message);
            if (debug_info) {
                g_printerr("调试信息: %s\n", debug_info);
                g_free(debug_info);
            }
            g_error_free(err);
            break;
        case GST_MESSAGE_EOS:
            g_print("管道正常结束\n");
            break;
        default:
            break;
        }
        gst_message_unref(msg);
    }

    // 清理
    gst_object_unref(bus);
    gst_element_set_state(pipeline, GST_STATE_NULL);
    gst_object_unref(pipeline);
    return 0;
}

编译与运行

# 编译（需 pkg-config 支持）
gcc audio_test.c -o audio_test $(pkg-config --cflags --libs gstreamer-1.0)

# 运行（默认播放 1kHz 正弦波，音量 50%）
./audio_test

验证方法

• 听觉验证：运行后应听到持续、稳定的 1kHz 单音，无爆音或明显失真，说明音频输出链路正常。
• 错误输出验证：若声卡不可用或驱动异常，程序会打印 管道错误 及具体错误信息（如 No such device），此时需检查 ALSA/PulseAudio 配置。
• 自动退出机制：管道默认持续播放，按 Ctrl+C 终止进程。若需自动停止，可添加 g_timeout_add 定时发送 EOS，或使用 timeout 5 ./audio_test 命令限制运行时长。

常见问题

• 无声音输出：确认系统音量未静音、声卡未被其他进程独占；尝试用 gst-launch-1.0 audiotestsrc ! autoaudiosink 命令行快速排查。
• 元素创建失败：执行 gst-inspect-1.0 audiotestsrc 检查插件是否安装；若缺失，安装 gst-plugins-base 包。
• autoaudiosink 选择错误后端：可显式替换为 alsasink 或 pulsesink 测试，以定位是设备问题还是后端选择问题。