如何使用PortAudio实现WAV文件的无限循环播放？

要实现音频无限循环播放直到手动关闭流，核心是在音频文件读取到末尾时，重置文件指针到开头继续读取，而非返回paComplete终止流。

原代码问题分析 #

原回调函数在读取到文件末尾（num_read < frameCount）时直接返回paComplete，这会触发PortAudio终止音频流，无法实现循环播放。

修改后的回调函数实现 #

static
int
callback
    (const void                     *input
    ,void                           *output
    ,unsigned long                   frameCount
    ,const PaStreamCallbackTimeInfo *timeInfo
    ,PaStreamCallbackFlags           statusFlags
    ,void                           *userData
    )
{
    float           *out;
    callback_data_s *p_data = (callback_data_s*)userData;
    sf_count_t       num_read;
    unsigned long    remaining_samples;

    out = (float*)output;
    p_data = (callback_data_s*)userData;

    /* 清空输出缓冲区 */
    memset(out, 0, sizeof(float) * frameCount * p_data->info.channels);

    /* 先读取尽可能多的采样到输出缓冲区 */
    num_read = sf_read_float(p_data->file, out, frameCount * p_data->info.channels);

    /* 如果没读到足够的采样，说明到了文件末尾 */
    if (num_read < frameCount * p_data->info.channels)
    {
        /* 计算还需要填充的采样数 */
        remaining_samples = (frameCount * p_data->info.channels) - num_read;
        /* 将文件指针重置到音频数据起始位置 */
        sf_seek(p_data->file, 0, SEEK_SET);
        /* 继续读取剩余采样，填充到缓冲区末尾 */
        sf_read_float(p_data->file, out + num_read, remaining_samples);
    }

    /* 始终返回paContinue，让流持续运行直到手动关闭 */
    return paContinue;
}

关键改动说明 #

• 读取到文件末尾时，通过sf_seek(p_data->file, 0, SEEK_SET)将SndFile的文件指针重置到音频数据开头（WAV文件的元数据会被自动跳过，直接定位到有效音频区）。
• 计算剩余需要填充的采样数，从文件开头继续读取补足缓冲区，保证每次回调都能提供完整的frameCount帧数据，避免播放断档。
• 移除原代码中返回paComplete的逻辑，始终返回paContinue，让PortAudio持续调用回调函数，直到你手动调用Pa_StopStream()或Pa_AbortStream()终止流。

额外注意事项 #

• 确保callback_data_s结构体正确保存了SndFile句柄、音频通道数等关键信息。
• 手动终止流后，记得调用sf_close()关闭SndFile句柄，避免资源泄漏。

内容的提问来源于stack exchange，提问作者Nguyen Minh Binh