简介： CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐：《Android系统多媒体进阶实战》🚀
Android Audio工程师专栏地址： Audio工程师进阶系列【原创干货持续更新中……】🚀
Android多媒体专栏地址： 多媒体系统工程师系列【原创干货持续更新中……】🚀
专题一 二：AAOS车载系统+AOSP14系统攻城狮入门视频实战课 🚀
专题三：Android14 Binder之HIDL与AIDL通信实战课 🚀
专题四：Android15快速自定义与集成音效实战课 🚀
专题五：Android15音频策略实战课 🚀
专题六：Android15音频性能实战课(无声/杂音/断音/爆音实战案例) 🚀

人生格言： 人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.

更多原创,欢迎关注：Android系统攻城狮

🌻1. 前言

本篇目的：Linux PulseAudio 深度解析之 pa_stream_prebuf 调用流程与实战。

要点概括

• 核心功能：触发 PulseAudio Stream 进入预缓冲（Prebuffer）状态。
• 工作机制：通过异步协议通知 PulseAudio Server，要求 Stream 重新积累缓冲数据后再恢复播放。

🌻2. 用法与应用场景

pa_stream_prebuf
是 PulseAudio 中用于：

“重新进入预缓冲阶段”

的重要接口。

在 PulseAudio 播放体系中：

音频并不是：

写入一帧
↓
立即播放

而是：

先积累一定缓冲
↓
达到 prebuf 阈值
↓
开始稳定播放

因此：

prebuf 的核心作用是避免 underrun（缓冲区空洞）。

函数原型

pa_operation* pa_stream_prebuf(
        pa_stream *s,
        pa_stream_success_cb_t cb,
        void *userdata);

参数说明

s:
目标 pa_stream

cb:
异步完成回调

userdata:
用户私有数据

返回值

返回 pa_operation 对象

用于：

• 查询异步操作状态
• 管理 operation 生命周期

---

应用场景

1. underrun 后恢复播放

例如：

网络抖动
↓
PCM 数据供应不足
↓
播放缓冲耗尽
↓
出现 underrun

此时：

pa_stream_prebuf(stream,
                 NULL,
                 NULL);

会：

重新进入预缓冲状态。

---

2. 网络音频播放器

例如：

• AirPlay
• DLNA
• RTP
• WebRTC

都可能：

暂停接收数据
↓
重新积累缓冲
↓
恢复播放

因此：

prebuf 是网络音频的重要机制。

---

3. 降低卡顿

在：

• 弱网
• 高负载
• 蓝牙音频

场景中：

重新 prebuf 可以减少：

• crack
• pop noise
• underrun

---

🌻3. 调用流程剖析

🌻3.1 核心步骤

1. 应用层调用 prebuf

pa_stream_prebuf(
        stream,
        callback,
        userdata);

---

2. libpulse 创建 operation

内部创建：

pa_operation

用于表示：

当前异步 prebuf 操作。

---

3. libpulse 发送协议命令

客户端通过 native protocol 发送：

PA_COMMAND_PREBUF_PLAYBACK_STREAM

到 PulseAudio Daemon。

---

4. 服务端执行 prebuf

服务端会：

• 停止立即播放
• 重新积累音频缓冲
• 等待达到 prebuf 阈值

此时：

Stream 暂时不播放
但继续接收 PCM 数据

---

5. 达到缓冲阈值后恢复播放

当：

buffer >= prebuf threshold

服务端恢复：

• Sink Input 调度
• 音频输出
• DMA 数据流

随后：

• 返回 ACK
• 触发 success callback

---

🌻3.2 调用流程图

🌻3.3 Prebuf 生命周期图

🌻4. 实战应用案例

#include <pulse/pulseaudio.h>
#include <stdio.h>

void prebuf_success_cb(
        pa_stream *s,
        int success,
        void *userdata) {

    if (success) {

        printf("prebuf 操作成功\n");

    } else {

        printf("prebuf 操作失败\n");
    }
}

void restart_prebuffer(
        pa_stream *stream) {

    pa_operation *op;

    /*
     * 重新进入 prebuffer 状态
     */
    op = pa_stream_prebuf(
            stream,
            prebuf_success_cb,
            NULL);

    if (!op) {

        printf("pa_stream_prebuf failed\n");
        return;
    }

    pa_operation_unref(op);
}

int main() {

    pa_stream *stream;

    /*
     * 假设 stream 已 connect 成功
     */

    restart_prebuffer(stream);

    return 0;
}

🌻5. 源码层核心原理

pa_stream_prebuf
属于：

PulseAudio 异步协议控制接口。

内部核心流程：

pa_stream_prebuf()
    ↓
pa_pstream_send_tagstruct()
    ↓
发送 PREBUF protocol
    ↓
server 进入 prebuffering
    ↓
重新积累 buffer
    ↓
恢复播放

本质并不是：

修改本地变量

而是：

真正通知 PulseAudio Server 重新执行预缓冲。

因此：

它涉及：

• Socket 通信
• native protocol
• playback buffer
• sink input 调度

属于：

PulseAudio 播放缓冲体系中的核心控制接口之一。

🌻6. 一句话总结

pa_stream_prebuf
本质上是：

“让 PulseAudio Stream 重新积累缓冲后再播放”。

它负责：

• 处理 underrun
• 降低卡顿
• 平滑恢复播放
• 提高弱网稳定性

是 PulseAudio 缓冲控制体系中的核心基础接口之一。