pulseaudio-modules-bt完全指南：解锁Linux蓝牙高清音频的终极解决方案
项目地址: https://gitcode.com/gh_mirrors/pu/pulseaudio-modules-bt pulseaudio-modules-bt是一款为Linux系统PulseAudio音频服务器提供增强蓝牙音频支持的开源项目，它在原版PulseAudio蓝牙模块基础上，添加了LDAC、aptX、aptX HD和AAC等高清音频编解码器支持，并扩展了SBC编解码器的配置选项，让Linux用户也能享受高品质的蓝牙音频体验。
📋 支持的高清音频编解码器
该项目为Linux系统带来了丰富的蓝牙音频编解码支持，让你的无线音频设备发挥出最佳性能：
| 编解码器 | 编码支持 | 解码支持 | 采样格式 | 采样频率 |
|---|---|---|---|---|
| AAC | ✔️ | ✔️ | s16 | 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, 48, 64, 88.2, 96 kHz |
| aptX | ✔️ | ✔️ | s16 | 16, 32, 44.1, 48 kHz |
| aptX HD | ✔️ | ✔️ | s24 | - |
| LDAC | ✔️ | ❌ | s16, s24, s32, f32 | 44.1, 48, 88.2, 96 kHz |
其中，LDAC作为索尼开发的高清音频编解码器，支持高解析度音频传输，而aptX系列则以低延迟和高音质著称，AAC则在苹果设备中广泛使用，这些编解码器的加入极大提升了Linux系统的蓝牙音频能力。
🛠️ 快速安装指南
方法一：预编译二进制包（推荐新手）
项目提供了针对不同Linux发行版的预编译二进制包，你可以参考项目的wiki/Packages页面，找到适合自己系统的安装包，通过系统包管理器进行安装，这种方式最为简单快捷。
方法二：从源代码编译安装
如果你需要最新的功能或自定义编译选项，可以选择从源代码编译安装。
安装依赖项
在Debian/Ubuntu等基于Debian的发行版上，可以使用以下命令安装编译依赖：
sudo apt-get install -y libfdk-aac-dev libavcodec-dev libpulse-dev libdbus-1-dev libsbc-dev libldacbt-abr-dev libldacbt-enc-dev libltdl-dev libbluetooth-dev
克隆代码仓库
git clone https://gitcode.com/gh_mirrors/pu/pulseaudio-modules-bt
cd pulseaudio-modules-bt
git submodule update --init
编译安装
对于PulseAudio发行版（如v12.0、v12.2等）：
git -C pa/ checkout v`pkg-config libpulse --modversion|sed 's/[^0-9.]*\([0-9.]*\).*/\1/'`
mkdir build && cd build
cmake ..
make
sudo make install
对于PulseAudio git master版本：
git -C pa/ checkout master
mkdir build && cd build
cmake -DFORCE_LARGEST_PA_VERSION=ON ..
make
sudo make install
重启PulseAudio
pulseaudio -k
# 如果PulseAudio没有自动重启，运行
pulseaudio --start
⚙️ 配置指南
安装完成后，需要对模块进行配置以启用所需的编解码器和功能。
编辑配置文件
打开PulseAudio配置文件：
sudoedit /etc/pulse/default.pa
配置编解码器参数
在配置文件中，找到或添加加载蓝牙发现模块的行，并添加编解码器配置参数。例如：
LDAC标准质量配置
load-module module-bluetooth-discover a2dp_config="ldac_eqmid=sq"
LDAC高质量配置（强制使用Float32LE格式）
#load-module module-bluetooth-discover a2dp_config="ldac_eqmid=hq ldac_fmt=f32"
LDAC质量模式说明
| 参数值 | 描述 |
|---|---|
| hq | LDAC高质量模式 |
| sq | LDAC标准质量模式 |
| mq | LDAC移动使用质量模式 |
| auto/abr | LDAC自适应比特率模式 |
AAC编码器配置
你还可以配置AAC编码器的参数，例如启用后 burners功能：
load-module module-bluetooth-discover a2dp_config="aac_afterburner=on"
🔧 扩展SBC配置
该项目还扩展了SBC编解码器的配置选项，允许高级用户进行精细调整，如设置比特池限制、采样频率、声道模式等。例如：
load-module module-bluetooth-discover a2dp_config="sbc_min_bp=30 sbc_max_bp=250 sbc_freq=48k sbc_cmode=stereo"
更多关于SBC配置选项的信息，可以参考LineageOS文档，也可以使用交互式计算器来选择合适的参数值。
📱 连接蓝牙设备
配置完成后，连接你的蓝牙音频设备，并将音频配置文件切换到"A2DP Sink"。如果只显示"HSP/HFP"和"关闭"选项，尝试断开并重新连接设备，这个问题在bluez 5.51及以上版本中已得到修复。
📝 总结
pulseaudio-modules-bt为Linux用户提供了一个强大的解决方案，让你能够在Linux系统上享受LDAC、aptX、AAC等高清蓝牙音频编解码器带来的优质体验。无论是通过预编译包快速安装，还是从源代码自定义编译，都能轻松解锁Linux蓝牙音频的潜力，让你的无线音频设备在Linux系统上发挥出最佳性能。
如果你在使用过程中遇到问题，可以查阅项目的Wiki或提交issue寻求帮助。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
