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

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

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

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

🌻1. 前言

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

要点概括

• 核心功能：获取当前 Stream 所绑定设备的名称。
• 工作机制：读取 libpulse 本地缓存的设备名称字符串，不主动向服务端发送请求。

🌻2. 用法与应用场景

pa_stream_get_device_name 是 PulseAudio 中用于查询当前音频设备名称的重要接口。

对于播放流：

• 返回当前 Sink Name

对于录音流：

• 返回当前 Source Name

例如：

alsa_output.pci-0000_00_1f.3.analog-stereo
bluez_sink.XX_XX_XX_XX.a2dp_sink

这些字符串：

就是 PulseAudio 内部设备唯一名称。

函数原型

const char* pa_stream_get_device_name(
        const pa_stream *s);

参数说明

s:
需要查询设备名称的 pa_stream

返回值

返回当前绑定设备名称字符串

例如：

alsa_output.pci-0000_00_1f.3.analog-stereo

或者：

bluez_sink.12_34_56_78_90.a2dp_sink

---

应用场景

1. 获取当前输出设备名称

const char *name;

name =
    pa_stream_get_device_name(stream);

用于：

• 显示当前输出设备
• 显示当前录音设备

---

2. 蓝牙设备识别

例如：

bluez_sink.XX_XX_XX_XX.a2dp_sink

可以判断：

• 当前是否为蓝牙耳机
• 当前是否为 A2DP 模式

---

3. 音频路由分析

例如：

pactl list sinks

会看到：

Name: alsa_output.pci-0000_00_1f.3.analog-stereo

此时：

pa_stream_get_device_name(stream)

即可获得：

alsa_output.pci-0000_00_1f.3.analog-stereo

用于路由调试。

---

🌻3. 调用流程剖析

🌻3.1 核心步骤

1. 应用层调用

pa_stream_get_device_name(stream);

---

2. libpulse 检查 stream 对象

内部首先检查：

• stream 是否为空
• stream 是否有效

---

3. 读取 stream->device_name

libpulse 内部本质执行：

return s->device_name;

---

4. 返回设备名称字符串

例如：

alsa_output.pci-0000_00_1f.3.analog-stereo

该值表示：

当前 Stream 所绑定设备的唯一名称。

---

5. 应用层使用设备名称

典型用途：

printf("device name = %s\n",
       dev_name);

或者：

• 设备识别
• 蓝牙判断
• 路由分析

---

🌻3.2 调用流程图

🌻3.3 Device Name 生命周期图

🌻4. 实战应用案例

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

void print_device_name(pa_stream *stream) {

    const char *dev_name;

    if (!stream)
        return;

    /*
     * 获取 Device Name
     */
    dev_name =
        pa_stream_get_device_name(stream);

    if (!dev_name) {

        printf("device name is NULL\n");
        return;
    }

    printf("PulseAudio Device Name = %s\n",
           dev_name);
}

void bluetooth_check_demo(pa_stream *stream) {

    const char *dev_name;

    dev_name =
        pa_stream_get_device_name(stream);

    if (!dev_name)
        return;

    /*
     * 判断是否为蓝牙设备
     */
    if (strstr(dev_name, "bluez")) {

        printf("当前设备是蓝牙音频设备\n");

    } else {

        printf("当前设备是本地声卡\n");
    }
}

int main() {

    pa_stream *stream;

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

    print_device_name(stream);

    bluetooth_check_demo(stream);

    return 0;
}

🌻5. 源码层核心原理

pa_stream_get_device_name
在 libpulse 中本质非常简单。

内部逻辑类似：

const char* pa_stream_get_device_name(
        const pa_stream *s) {

    pa_assert(s);

    return s->device_name;
}

你会发现：

它本质只是读取 stream->device_name

并不会：

• 发 Socket
• 发协议包
• 请求服务端
• 做 IPC

真正的 Device Name：

是在：

connect_playback

或：

connect_record

阶段由服务端确定的。

随后：

libpulse 保存：

stream->device_name

因此：

pa_stream_get_device_name
本质属于：

“本地缓存读取接口”。

🌻6. 一句话总结

pa_stream_get_device_name
本质上是：

“获取当前 Stream 所绑定设备的人类可读名称”。

它负责：

• 标识当前 Sink/Source
• 支撑设备识别
• 支撑蓝牙判断
• 支撑音频路由分析

是 PulseAudio 设备管理体系中的核心基础接口之一。