ESP32蓝牙音频终极指南：从零打造无线音乐系统

2026-02-06 05:10:50作者：舒璇辛Bertina

想要用ESP32打造属于自己的蓝牙音箱吗？ESP32蓝牙音频项目通过强大的A2DP库，让你轻松实现无线音乐播放功能。无论你是想制作蓝牙音乐接收器还是发送器，这个开源库都能满足你的需求，支持Arduino、PlatformIO和Espressif IDF多种开发环境。

5分钟快速搭建蓝牙音箱

首先需要安装必要的库文件。打开Arduino IDE，通过库管理器安装ESP32-A2DP库，或者使用git命令手动安装：

cd ~/Documents/Arduino/libraries
git clone https://gitcode.com/gh_mirrors/es/ESP32-A2DP.git

最简代码实现音乐接收

创建一个新的Arduino项目，输入以下基础代码：

#include "AudioTools.h"
#include "BluetoothA2DPSink.h"

I2SStream i2s;
BluetoothA2DPSink a2dp_sink(i2s);

void setup() {
    a2dp_sink.start("MyBluetoothSpeaker");
}

void loop() {
}

这段代码创建了一个名为"MyBluetoothSpeaker"的蓝牙设备，手机会自动搜索到这个设备并进行连接🎧。

硬件连接图解

ESP32默认使用以下引脚进行I2S音频输出：

BCK (位时钟)：GPIO 14
WS (左右声道时钟)：GPIO 15
DATA (数据输出)：GPIO 22

按照图示连接外部DAC模块，即可获得高质量的音频输出。

进阶功能：内部DAC输出

如果你不想使用外部DAC，ESP32还支持内部DAC输出：

#include "AudioTools.h"
#include "BluetoothA2DPSink.h"

AnalogAudioStream out;
BluetoothA2DPSink a2dp_sink(out);

void setup() {
    a2dp_sink.start("MySpeaker");
}

void loop() {
}

内部DAC使用GPIO25和GPIO26引脚输出模拟音频信号🔊。

实际效果演示

成功连接后，你的手机音频将通过ESP32实时播放。你可以通过手机控制音量、切换歌曲，享受无线音乐的便利。

音乐发送器模式

除了接收音乐，ESP32还可以作为音乐发送器：

#include "BluetoothA2DPSource.h"

BluetoothA2DPSource a2dp_source;

int32_t get_sound_data(uint8_t *data, int32_t byteCount) {
    // 在这里生成或读取音频数据
    return byteCount;
}

void setup() {
    a2dp_source.set_data_callback(get_sound_data);
    a2dp_source.start("MyMusicSource");
}

void loop() {}